> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel / delete video generation task

> Seedance 2.0 New DELETE /api/v3/contents/generations/tasks/{id}

## Introduction

Cancel or delete a video generation task. `DELETE` behavior depends on the current task status.

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g. `Bearer sk-your_token_key`
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  Task `id`
</ParamField>

## Behavior

| Task status | Can delete? | Effect                                        | Status after delete |
| ----------- | ----------- | --------------------------------------------- | ------------------- |
| `queued`    | Yes         | Removed from queue; status set to `cancelled` | `cancelled`         |
| `running`   | **No**      | Rejected                                      | —                   |
| `succeeded` | Yes         | Task record deleted; no longer queryable      | —                   |
| `failed`    | Yes         | Same as above                                 | —                   |
| `cancelled` | **No**      | Rejected                                      | —                   |
| `expired`   | Yes         | Same as above                                 | —                   |

On success the response body is empty (`{}`); on failure the corresponding error status code and error body are returned.

## Request example

```bash theme={null}
curl -X DELETE https://api.gravitex.ai/api/v3/contents/generations/tasks/cgt-20260708094649-mxfjc \
  -H "Authorization: Bearer sk-your_token_key"
```
