> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

## Failure reason for embedding tasks

The response of the [`GET`](/v1.3/api-reference/create-embeddings-v2/retrieve-embeddings) method of the `/embed-v2/tasks/{task_id}` endpoint now includes an object named [`error`](/v1.3/api-reference/create-embeddings-v2/retrieve-embeddings#response.body.error) that contains a human-readable failure reason when an embedding task fails. The platform returns this field only when `status` is `failed`. The field is available in the [Python SDK](/v1.3/sdk-reference/python/create-embeddings-v-2/create-async-embeddings#retrieve-task-status-and-results) and [Node.js SDK](/v1.3/sdk-reference/node-js/create-embeddings-v-2/create-async-embeddings#retrieve-task-status-and-results).
To access this feature, upgrade your SDK to the latest version:

**`Python SDK`**

```sh Python SDK
pip install --upgrade twelvelabs
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@latest
```