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

# Cancel a video

> Cancel a video task on the platform that created it. This request is not billed.

Cancels an in-flight task and returns the task envelope with `status` set to `cancelled` when the cancel succeeds.

<ParamField path="id" type="string" required>
  Public task ID (`gen-...`).
</ParamField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl -X DELETE https://api.pipellm.ai/v2/videos/gen-xxxxxxxx \
    -H "Authorization: Bearer $PIPELLM_API_KEY"
  ```

  ```python Python theme={"dark"}
  import os
  import requests

  response = requests.delete(
      "https://api.pipellm.ai/v2/videos/gen-xxxxxxxx",
      headers={"Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"dark"}
  {
    "id": "gen-xxxxxxxx",
    "object": "video",
    "model": "seedance-2-0-mini",
    "provider": "volcengine",
    "status": "cancelled",
    "created_at": 1726400000,
    "updated_at": 1726400030
  }
  ```
</ResponseExample>

A missing or foreign task ID returns `404`. This route does not charge.

Completed tasks cannot be cancelled. Poll [`GET /v2/videos/{id}`](/api-reference/video/get) if you only need the current status.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.