POST
/
index
/
videos
/
url

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.

Body

application/json
url
string
required

The URL of the asset to be processed. Must be a valid HTTP or HTTPS URL.

collection_id
string
required

Unique identifier for the collection where the processed asset will be stored.

asset_update
object | null

Asset update information for existing assets

metadata
object

Additional metadata associated with the asset. Can include any key-value pairs relevant to the asset.

percolate
object | null

Settings for percolating the asset against stored queries.

skip_duplicate
boolean | null
default: true

Skips processing when a duplicate hash is found and stores an error by the task_id with the existing asset_id

feature_extractors
object[] | null

Settings for video processing. Only applicable if the URL points to a video file.

Response

200 - application/json
message
string
required

A message describing the status of the task

task_id
string
required

The unique identifier for the processing task