Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Delete a video

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

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

Delete a video

from openai import OpenAI

client = OpenAI()
video = client.videos.delete(
    "video_123",
)
print(video.id)
Response example
{
  "id": "video_123",
  "object": "video.deleted",
  "deleted": true
}
Parameters
video_id: str
Returns
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.

Returns Examples
Response example
{
  "id": "video_123",
  "object": "video.deleted",
  "deleted": true
}