Skip to main content
GET
Download frame-accurate scene media for this document.

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 header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

collection_identifier
string
required

The ID or name of the collection.

document_id
string
required

The ID of the scene document.

Response

Successful Response

download_url
string
required

Presigned URL for the frame-accurate media cut.

cached
boolean
required

Whether the cut was served from cache.

start_time
number
required

Scene start time in seconds.

end_time
number
required

Scene end time in seconds.