API Reference

Beta

Threads

Messages

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete message

Deprecated: The Assistants API is deprecated in favor of the Responses API

beta.threads.messages.delete(strmessage_id, MessageDeleteParams**kwargs) -> MessageDeleted

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

Deletes a message.

ParametersExpand Collapse

thread_id: str

message_id: str

ReturnsExpand Collapse

class MessageDeleted: …

id: str

deleted: bool

object: Literal["thread.message.deleted"]

Delete message

Python

HTTP

TypeScript

Python

Java

Go

Ruby

from openai import OpenAI
client = OpenAI()

deleted_message = client.beta.threads.messages.delete(
  message_id="msg_abc12",
  thread_id="thread_abc123",
)
print(deleted_message)

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

Returns Examples

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