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

Delete a conversation

ConversationDeletedResource conversations().delete(ConversationDeleteParamsparams = ConversationDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

delete /conversations/{conversation_id}

Delete a conversation. Items in the conversation will not be deleted.

Parameters

• ConversationDeleteParams params

  • Optional<String> conversationId

Returns

• class ConversationDeletedResource:

  • String id

  • boolean deleted

  • JsonValue; object_ "conversation.deleted"constant

    • CONVERSATION_DELETED("conversation.deleted")

Example

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.conversations.ConversationDeleteParams;
import com.openai.models.conversations.ConversationDeletedResource;

public final class Main {
    private Main() {}

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

        ConversationDeletedResource conversationDeletedResource = client.conversations().delete("conv_123");
    }
}

Response

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