v3
latestOpenAPI 3.1.02026-07-3197486526.1 KBembed > v2 > tasks
List async embedding tasks
This method returns a list of the async embedding tasks in your account. The platform returns your async embedding tasks sorted by creation date, with the newest at the top of the list.
<Note title="Notes"> - Embeddings are stored for seven days. - When you invoke this method without specifying the `started_at` and `ended_at` parameters, the platform returns all the async embedding tasks created within the last seven days. </Note>get/embed-v2/tasks
Query parameters
started_atstring
Retrieve the embedding tasks that were created after the given date and time, expressed in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ").
ended_atstring
Retrieve the embedding tasks that were created before the given date and time, expressed in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ").
statusstring
Filter the embedding tasks by their current status.
Values: processing, ready, or failed.
pageinteger
A number that identifies the page to retrieve.
Default: 1.
page_limitinteger
The number of items to return on each page.
Default: 10. Max: 50.
Headers
x-api-keystring required
Your API key.
<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>Response
A list of async embedding tasks has successfully been retrieved.