Delete a message
delete_messagePermanently unsend a chat message, for everyone when the network allows or only for you, using its chat ID and final message ID.
Instructions
Delete (unsend) a message. By default it is deleted for everyone when the network allows it (usually only your own, recent messages). Needs the final message ID: a pendingMessageID from send_file only becomes deletable once the message is sent. This cannot be undone: confirm with the user first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chatID": "<chatID>",
"messageID": "<messageID>"
},
"name": "delete_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chatID | Yes | Chat ID (or local chat ID) | |
| messageID | Yes | ID of the message to delete | |
| forEveryone | No | true (default): delete for everyone; false: only for you, when supported |