API Reference

Videos

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete video

DELETE/videos/{video_id}

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

Path ParametersExpand Collapse

video_id: string

ReturnsExpand Collapse

id: string

Identifier of the deleted video.

deleted: boolean

Indicates that the video resource was deleted.

object: "video.deleted"

The object type that signals the deletion response.

Delete video

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

curl https://api.openai.com/v1/videos/$VIDEO_ID \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200 example

{
  "id": "id",
  "deleted": true,
  "object": "video.deleted"
}

Returns Examples

200 example

{
  "id": "id",
  "deleted": true,
  "object": "video.deleted"
}