API Reference

Videos

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete video

videos.delete(video_id) -> VideoDeleteResponse { id, deleted, object }

DELETE/videos/{video_id}

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

ParametersExpand Collapse

video_id: String

ReturnsExpand Collapse

class VideoDeleteResponse { id, deleted, object }

Confirmation payload returned after deleting a video.

id: String

Identifier of the deleted video.

deleted: bool

Indicates that the video resource was deleted.

object: :"video.deleted"

The object type that signals the deletion response.

Delete video

Ruby

HTTP

TypeScript

Python

Java

Go

Ruby

require "openai"

openai = OpenAI::Client.new

video = openai.videos.delete("video_123")

puts(video)

200 example

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

Returns Examples

200 example

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