Skip to content
API Reference
Videos

Delete video

videos.delete(strvideo_id) -> VideoDeleteResponse
DELETE/videos/{video_id}

Delete a video

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
video = client.videos.delete(
    "video_123",
)
print(video.id)
{
  "id": "id",
  "deleted": true,
  "object": "video.deleted"
}
Returns Examples
{
  "id": "id",
  "deleted": true,
  "object": "video.deleted"
}