Permanently delete message
delete_messagePermanently delete an email message by moving it to Trash and expunging. This irreversible action requires the confirm parameter set to true.
Instructions
PERMANENTLY delete a message (moves to Trash then expunges). Irreversible. Requires confirm:true. Prefer trash_message for a reversible delete.
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": {
"gmMsgId": "<gmMsgId>",
"confirm": "<confirm>"
},
"name": "delete_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Gmail address to act on. Omit to use the default account. | |
| confirm | Yes | Must be true to permanently delete. | |
| gmMsgId | Yes | Gmail message id (X-GM-MSGID), as returned by search_messages or get_message. |