Skip to main content
Permanently delete a message and every message that follows it in the conversation. This action cannot be undone.
Deletion is cascading. The target message and all messages after it are removed to keep the conversation context consistent. Use this carefully — there is no way to recover deleted messages.
The same operation is available in-stream as the WebSocket delete_message action, which replies with a deleted frame — see WebSocket → Delete a message. Use whichever fits your client.
​
string
required
Bearer token obtained from the authenticate endpoint.
​
string
required
Unique identifier of the chat containing the message. The current implementation authorizes against the message’s actual owning chat but does not cross-check this path value, so pass the message’s real chat_id.
​
string
required
Unique identifier of the message to delete.
The message is authorized through its owning chat. A missing message returns 404; a message in a chat outside the authenticated member’s scope returns 403.

​
Response

Returns 204 No Content on success — no response body.