GET
/
assets
/
{asset_id}

Headers

Authorization
string | null

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings. Example: 'Bearer sk_1234567890abcdef'

X-Namespace
string | null

Optional namespace for data isolation. Example: 'netflix_prod' or 'spotify_recs_dev'. To create a namespace, use the /namespaces endpoint.

Path Parameters

asset_id
string
required

Unique identifier of the asset

Query Parameters

return_url
boolean
default: true

Whether to generate and return presigned S3 URLs for the asset and preview. Set to false to improve performance when URLs aren't needed

Response

200 - application/json
asset_id
string | null

The unique identifier for the asset

collection_id
string | null

The ID of the collection the asset belongs to

status
string | null

The current status of the asset processing

metadata
object | null

Additional metadata associated with the asset

error
string | null

The error message if the asset processing failed

modality
string | null

The type of media

task_id
string | null

The task ID

unique_hash
string | null

The unique hash of the asset

updated_at
string | null

The timestamp when the asset was last updated

created_at
string | null

The timestamp when the asset was created

score
number | null

The relevance score of the asset

url
string | null

The presigned URL for accessing the asset

preview_url
string | null

The presigned URL for accessing the asset preview