---
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.

## Changes

- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/embed/tasks/:task_id/status/get.md)

---

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