PATCH
/
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

Body

application/json
propagate_features
boolean | null
default: false

If True, the features will be propagated to all assets with the same asset_id

metadata
object

Updated metadata for the asset. This can include any key-value pairs that should be updated or added to the asset's metadata.

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