cli/resources/videos/methods/delete/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

Delete video

$ openai videos delete

delete /videos/{video_id}

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

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.

Example

openai videos delete \
  --api-key 'My API Key' \
  --video-id video_123

Response

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