---
title: "Delete a video"
method: DELETE
path: "/videos/{video_id}"
tags: ["Videos"]
deprecated: true
---

# Delete a video

`DELETE /videos/{video_id}`

> **Deprecated.**

Permanently delete a completed or failed video and its stored assets.

## Path parameters

- `video_id` string, required

## Response `200`

Success

- DeletedVideoResource — Confirmation payload returned after deleting a video.
  - `object` 'video.deleted', required — The object type that signals the deletion response.
  - `deleted` boolean, required — Indicates that the video resource was deleted.
  - `id` string, required — Identifier of the deleted video.

## Other responses

- `400` — The video is still being processed, the request is invalid, or the organization does not support video generation.
- `404` — The video was not found or is not accessible, or the Videos API is unavailable.
- `500` — The video or its stored media could not be deleted.

## Changes

- **2026-09-25** `d86203de41ae` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2026-08-13** `596a83c32a9e` — 1 info
  - endpoint deprecated
- **2026-05-13** `74cbcf73838f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/videos/:video_id/delete.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/222f167a2327?raw)