API Reference

Videos

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete video

videos.delete(strvideo_id) -> VideoDeleteResponse

DELETE/videos/{video_id}

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

ParametersExpand Collapse

video_id: str

ReturnsExpand Collapse

class VideoDeleteResponse: …

Confirmation payload returned after deleting a video.

id: str

Identifier of the deleted video.

deleted: bool

Indicates that the video resource was deleted.

object: Literal["video.deleted"]

The object type that signals the deletion response.

Delete video

Python

HTTP

TypeScript

Python

Java

Go

Ruby

from openai import OpenAI

client = OpenAI()
video = client.videos.delete(
    "video_123",
)
print(video.id)

200 example

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

Returns Examples

200 example

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