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

Delete a video

$ openai videos delete
DELETE
/videos/{video_id}

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

Delete a video

openai videos delete \
  --api-key 'My API Key' \
  --video-id video_123
Response example
{
  "id": "video_123",
  "object": "video.deleted",
  "deleted": true
}
Parameters
--video-id: string

The identifier of the video to delete.

Returns
VideoDeleteResponse: object { id, deleted, object }

Confirmation payload returned after deleting a video.

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.

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