POST
/
index
/
images
/
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.

feature_extractors
object | null

Settings for image processing. Only applicable if the URL points to an image 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