---
title: "Retrieve the status of a video embedding task"
method: GET
path: "/embed/tasks/{task_id}/status"
tags: ["embed > tasks"]
---

# Retrieve the status of a video embedding task

`GET /embed/tasks/{task_id}/status`

<Note title="Note">
  This endpoint will be deprecated in a future version. Migrate to the [Embed API v2](/v1.3/api-reference/create-embeddings-v2) for continued support and access to new features.
</Note>
This method retrieves the status of a video embedding task. Check the task status of a video embedding task to determine when you can retrieve the embedding.

A task can have one of the following statuses:
- `processing`: The platform is creating the embeddings.
- `ready`:  Processing is complete. Retrieve the embeddings by invoking the [`GET`](/v1.3/api-reference/create-embeddings-v1/video-embeddings/retrieve-video-embeddings) method of the `/embed/tasks/{task_id} endpoint`.
- `failed`: The task could not be completed, and the embeddings haven't been created.

## Path parameters

- `task_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

The status of your video embedding task has been retrieved.

- EmbedTasksStatusResponse200
  - `_id` string — The unique identifier of the video embedding task.
  - `status` string — A string indicating the status of the video indexing task. It can take one of the following values: `processing`, `ready` or `failed`.
  - `model_name` string — The name of the video understanding model the platform used to create the embedding.
  - `video_embedding` EmbedTasksTaskIdStatusGetResponsesContentApplicationJsonSchemaVideoEmbedding — An object containing the metadata associated with the embedding.
    - `metadata` VideoEmbeddingMetadata — An object containing metadata associated with the embedding.
      - `input_url` string — The URL of the media file used to generate the embedding. Present if a URL was provided in the request.
      - `input_filename` string — The name of the media file used to generate the embedding. Present if a file was provided in the request.
      - `video_clip_length` number, double — The duration for each clip in seconds, as specified in the request. Note that the platform automatically truncates video segments shorter than 2 seconds. For a 31-second video divided into 6-second segments, the final 1-second segment will be truncated. This truncation only applies to the last segment if it does not meet the minimum length requirement of 2 seconds.
      - `video_embedding_scope` string[] — The scope you've specified in the request.
      - `duration` number, double — The total duration of the video in seconds.

## Other responses

- `400` — The request has failed.

---

[API](https://skmtc.net/twelvelabs/apis/twelvelabs-api.md) · [All operations](https://skmtc.net/twelvelabs/apis/twelvelabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvelabs/twelvelabs-api/revisions/b6d766c2c340/schema)