View as MarkdownPlain text for this page Open in ChatGPTQuestions about this page Open in ClaudeQuestions about this page

Delete Message

DELETE/api/threads/{threadId}/messages/{messageId}

Deletes a specific message from a thread. Deleting an assistant message also deletes its tool-result messages. The runtime attempts to remove attachment files for all deleted messages. Deleting a queued message cancels its delivery. The route sends no deletion frame on the thread stream.

threadIdstringrequired

The unique thread identifier (UUID)

messageIdstringrequired

The unique message identifier

successbooleanrequired

Whether the deletion was successful

cURL

curl -X DELETE https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000/messages/msg_001 \
  -H "Authorization: Bearer $STANDARD_AGENTS_API_KEY"

JavaScript

const response = await fetch(
  'https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000/messages/msg_001',
  { method: 'DELETE', headers: { Authorization: `Bearer ${token}` } }
);
const result = await response.json();

200

{
  "success": true
}

404

{
  "error": {
    "code": "not_found",
    "message": "Message not found"
  },
  "requestId": "0b3c1f0e-7f0a-4a55-9c58-2f6f5a0f6f0e"
}