Delete Telegram Message
telegram_delete_messagePermanently delete a message from any Telegram chat. Provide the chat ID and message ID to remove it; requires bot admin rights for other users' messages.
Instructions
Permanently delete a message from a chat. This cannot be undone.
Bots can always delete their own messages. Deleting other users' messages requires the bot to have admin/delete rights in a group or channel.
Args:
chat_id (string | number): Chat containing the message
message_id (number): ID of the message to delete
Returns: Confirmation of deletion.
Error Handling:
"message to delete not found" -> already deleted or too old (regular messages older than 48h generally can't be deleted by bots without admin rights).
"not enough rights" -> the bot needs admin permissions in this chat to delete others' messages.
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": {
"chat_id": "<chat_id>",
"message_id": "<message_id>"
},
"name": "telegram_delete_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat_id | Yes | Target chat. Use a numeric chat ID (e.g. 123456789 for a user, -1001234567890 for a supergroup/channel) or a public channel username with a leading '@' (e.g. '@my_channel'). If unknown, call telegram_get_updates after the user messages the bot to discover it. | |
| message_id | Yes | ID of the message to delete |