email_trash_message
Moves one message to the mailbox's trash. It stays recoverable for as long as the provider's retention allows, so this is the deletion to reach for by default. Use email_delete_message only when the user has explicitly asked for permanent, unrecoverable destruction. The result's deletion field states what actually happened — 'provider_recoverable' here. account_id must be the mailbox holding the message.
Input fields
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"minLength": 1,
"description": "The connected mailbox to act on, from email_accounts_list. Never guess this value and never reuse one across mailboxes — it selects both the credential and the permission set the call runs under."
},
"message_id": {
"type": "string",
"minLength": 1,
"description": "A message id returned by this server (msg_...), not a provider id."
}
},
"required": [
"account_id",
"message_id"
]
}Tool behavior
May change provider state. Check the explicit account, required access and provider capabilities before invoking.
Inspect isError and per-account errors. General write tools do not all enforce exact-plan approval. This reference does not certify any current AI client version.
YOUR INBOXES.
UNDER CONTROL.
Get started Start with a free account and one read-only search. Existing accounts keep their connection.