Permanently delete messages
mail_purgePermanently delete up to 500 messages at once, bypassing Deleted Items so they cannot be restored. Use only when the user explicitly requests permanent deletion.
Instructions
Permanently delete one or more messages (up to 500 ids). This cannot be undone: the messages do not go to Deleted Items and cannot be restored. Only use it when the user explicitly asked for these messages to be deleted permanently; otherwise use mail_delete, which moves them to Deleted Items.
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": {
"ids": "<ids>"
},
"name": "mail_purge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Message ids (1 to 500) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| moved | No | ||
| failed | Yes | ||
| succeeded | Yes |