Skip to content
Primary navigation

Delete message

$ openai beta:threads:messages delete
DELETE/threads/{thread_id}/messages/{message_id}

Deletes a message.

ParametersExpand Collapse
--thread-id: string

The ID of the thread to which this message belongs.

--message-id: string

The ID of the message to delete.

ReturnsExpand Collapse
message_deleted: object { id, deleted, object }
id: string
deleted: boolean
object: "thread.message.deleted"

Delete message

openai beta:threads:messages delete \
  --api-key 'My API Key' \
  --thread-id thread_id \
  --message-id message_id
{
  "id": "msg_abc123",
  "object": "thread.message.deleted",
  "deleted": true
}
Returns Examples
{
  "id": "msg_abc123",
  "object": "thread.message.deleted",
  "deleted": true
}