## 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

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

#### Response

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