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

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Delete a video

VideoDeleteResponse videos().delete(params = VideoDeleteParams.none(), requestOptions = RequestOptions.none())
DELETE
/videos/{video_id}

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

Parameters
VideoDeleteParams params
Optional<String> videoId
Returns
class VideoDeleteResponse:

Confirmation payload returned after deleting a video.

String id

Identifier of the deleted video.

boolean deleted

Indicates that the video resource was deleted.

JsonValue; object_
constant
constant

The object type that signals the deletion response.

Delete a video

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.videos.VideoDeleteParams;
import com.openai.models.videos.VideoDeleteResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        VideoDeleteResponse video = client.videos().delete("video_123");
    }
}

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