Retrieve task status and results
This method retrieves the status and the results of an async embedding task.
**Task statuses**:
- `processing`: The platform is creating the embeddings.
- `ready`: Processing is complete. Embeddings are available in the response.
- `failed`: The task failed. Embeddings were not created.
Invoke this method repeatedly until the `status` field is `ready`. When `status` is `ready`, use the embeddings from the response.
Authentication
x-api-keystring
Your API key.
<Note title="Note">
You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-key" target="_blank">API Key</a> page.
</Note>
Path Parameters
task_id
The unique identifier of the embedding task.
Response
Task status and results retrieved successfully
_id
The unique identifier of the embedding task.
status
The current status of the task.
- `processing`: The platform is creating the embeddings
- `ready`: Processing is complete. Embeddings are available in the `data` field
- `failed`: The task failed. The `data` field is `null`
Allowed values:
data
An object containing the embedding results, or null otherwise.
created_at
A string representing the date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the resource was created.
updated_at
A string representing the date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the resource was last updated.
metadata
Metadata for the media input.