Skip to main content
POST
Confirm model upload

Authorizations

Authorization
string
header
required

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.

Path Parameters

upload_id
string
required

Body

application/json

Keys this body does not declare are refused with 422 extra_forbidden naming the accepted keys (since 2026-11-02).

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
etag
string | null

S3 ETag from upload response for integrity check

file_size_bytes
integer | null

Expected file size for validation

Response

Successful Response

Response from confirming a model upload.

success
boolean
required

Whether upload and validation succeeded

upload_id
string
required

The upload ID

validation_status
enum<string>
required

Validation status

Available options:
pending,
passed,
failed
model_id
string | null

Created model ID if successful

validation_errors
string[] | null

Validation errors if any

s3_archive_url
string | null

S3 URL of the archive

message
string | null

Additional status message