Trash emails
trash_emailsMove one or more email messages to Trash for recoverable deletion; use it when users ask to delete, trash, or bin mail rather than archive it.
Instructions
Move one or more messages to the Trash. Use this only when the user asks to delete, trash, or bin mail; to clear the inbox without deleting, use archive_emails, and to file into a folder use move_emails. Trashed messages stay recoverable in the mail client until Trash is emptied; there is no permanent delete of mail. Re-running it on the same ids is harmless. Takes message ids from search_emails, get_thread or list_drafts. This also trashes a staged draft (pass the messageId list_drafts shows for it); get_draft, update_draft and send_draft then refuse it, and it stays restorable. Only when the user wants a draft gone for good, use delete_draft. Reports how many messages were trashed and lists any id the server refused.
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": "trash_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Message ids to act on (1–50), as returned by search_emails or get_thread. To act on a whole conversation, pass every id get_thread lists. |