> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm model upload

> Confirm a model upload after the S3 upload completes.

This is step 3 of the presigned URL workflow. Call this after
uploading the model archive to the presigned URL.

The service will:
1. Verify the S3 object exists
2. Validate the archive structure
3. Create the model record



## OpenAPI

````yaml post /v1/models/uploads/{upload_id}/confirm
openapi: 3.1.0
info:
  title: Mixpeek API
  description: >-
    This is the Mixpeek API, providing access to various endpoints for data
    processing and retrieval.
  termsOfService: https://mixpeek.com/terms
  contact:
    name: Mixpeek Support
    url: https://mixpeek.com/contact
    email: info@mixpeek.com
  version: '0.82'
servers:
  - url: https://api.mixpeek.com
    description: Production
security:
  - BearerAuth: []
paths:
  /v1/models/uploads/{upload_id}/confirm:
    post:
      tags:
        - Models
      summary: Confirm model upload
      description: |-
        Confirm a model upload after the S3 upload completes.

        This is step 3 of the presigned URL workflow. Call this after
        uploading the model archive to the presigned URL.

        The service will:
        1. Verify the S3 object exists
        2. Validate the archive structure
        3. Create the model record
      operationId: confirm_upload_v1_models_uploads__upload_id__confirm_post
      parameters:
        - name: upload_id
          in: path
          required: true
          schema:
            type: string
            title: Upload Id
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfirmModelUploadRequest'
              default: {}
        description: >-
          Keys this body does not declare are refused with 422 extra_forbidden
          naming the accepted keys (since 2026-11-02).
        x-unknown-keys:
          until: '2026-11-02'
          then: 422 extra_forbidden
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfirmModelUploadResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    ConfirmModelUploadRequest:
      properties:
        etag:
          anyOf:
            - type: string
            - type: 'null'
          title: Etag
          description: S3 ETag from upload response for integrity check
        file_size_bytes:
          anyOf:
            - type: integer
            - type: 'null'
          title: File Size Bytes
          description: Expected file size for validation
      type: object
      title: ConfirmModelUploadRequest
      description: |-
        Request to confirm a model upload after S3 upload completes.

        Optional fields for integrity verification:
        - etag: S3 ETag returned from PUT response (recommended)
        - file_size_bytes: Expected file size for validation
    ConfirmModelUploadResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Whether upload and validation succeeded
        upload_id:
          type: string
          title: Upload Id
          description: The upload ID
        model_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Model Id
          description: Created model ID if successful
        validation_status:
          type: string
          enum:
            - pending
            - passed
            - failed
          title: Validation Status
          description: Validation status
        validation_errors:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Validation Errors
          description: Validation errors if any
        s3_archive_url:
          anyOf:
            - type: string
            - type: 'null'
          title: S3 Archive Url
          description: S3 URL of the archive
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Additional status message
      type: object
      required:
        - success
        - upload_id
        - validation_status
      title: ConfirmModelUploadResponse
      description: Response from confirming a model upload.
    ErrorResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Always false for error responses
          default: false
        status:
          type: integer
          title: Status
          description: HTTP status code for this error
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: Error details payload
      type: object
      required:
        - status
        - error
      title: ErrorResponse
      description: Error response model.
      examples:
        - error:
            details:
              id: ns_123
              resource: namespace
            message: Namespace not found
            type: NotFoundError
          status: 404
          success: false
    ErrorDetail:
      properties:
        message:
          type: string
          title: Message
          description: Human-readable error message
        type:
          type: string
          title: Type
          description: Stable error type identifier (machine-readable)
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: >-
            Fine-grained error code for programmatic handling (e.g.,
            namespace_name_taken, feature_extractor_not_found). Present only
            when consumers may need to branch on a specific error condition.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: >-
            Optional structured details to help debugging (validation errors,
            IDs, etc.)
      type: object
      required:
        - message
        - type
      title: ErrorDetail
      description: Error detail model.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Mixpeek API key, sent as `Authorization: Bearer mxp_sk_...`. Create one
        in Studio under Settings → API Keys, or with an admin key via `POST
        /v1/organizations/users/{user_email}/api-keys`. A missing, malformed,
        unknown, revoked, inactive or expired key returns 401; a key without the
        permission, scope or plan an operation needs returns 403.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.