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

Delete video

VideoDeleteResponse videos().delete(VideoDeleteParamsparams = VideoDeleteParams.none(), RequestOptionsrequestOptions = 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_ "video.deleted"constant

    The object type that signals the deletion response.

    • VIDEO_DELETED("video.deleted")

Example

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");
    }
}

Response

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

Example

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");
    }
}