---
title: "Delete a video indexing task"
method: DELETE
path: "/tasks/{task_id}"
tags: ["tasks"]
---

# Delete a video indexing task

`DELETE /tasks/{task_id}`

<Info>This method will be removed in a future version.</Info>

This action cannot be undone.
Note the following about deleting a video indexing task:
- You can only delete video indexing tasks for which the status is `ready` or `failed`.
- If the status of your video indexing task is `ready`, you must first delete the video vector associated with your video indexing task by calling the [`DELETE`](/v1.3/api-reference/videos/delete) method of the `/indexes/videos` endpoint.

## Path parameters

- `task_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Successful response

## Other responses

- `400` — The request has failed.

## Changes

> 8 revisions in range; 5 could not be searched.

- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662` — 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/tasks/:task_id/delete.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)