API Reference

Beta

Threads

Messages

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete message

Deprecated

MessageDeleted beta().threads().messages().delete(MessageDeleteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

DELETE/threads/{thread_id}/messages/{message_id}

Deletes a message.

ParametersExpand Collapse

MessageDeleteParams params

String threadId

Optional<String> messageId

ReturnsExpand Collapse

class MessageDeleted:

String id

boolean deleted

JsonValue; object_ "thread.message.deleted"constant"thread.message.deleted"constant

Delete message

Java

HTTP

TypeScript

Python

Java

Go

Ruby

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.beta.threads.messages.MessageDeleteParams;
import com.openai.models.beta.threads.messages.MessageDeleted;

public final class Main {
    private Main() {}

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

        MessageDeleteParams params = MessageDeleteParams.builder()
            .threadId("thread_id")
            .messageId("message_id")
            .build();
        MessageDeleted messageDeleted = client.beta().threads().messages().delete(params);
    }
}

{
  "id": "msg_abc123",
  "object": "thread.message.deleted",
  "deleted": true
}

Returns Examples

{
  "id": "msg_abc123",
  "object": "thread.message.deleted",
  "deleted": true
}