delete_thread
Remove an entire email thread by its RFC 5322 Message-ID. Permanently delete or move messages to Trash, solving bulk cleanup from raw identifiers.
Instructions
Delete all messages in a thread, identified by RFC 5322 Message-ID header. permanent:true permanently expunges; false moves to Trash. Use when you have the raw Message-ID. Prefer apply_thread_action with action 'trash' or 'delete' when you have a local threadId from get_threads or get_actionable_threads.
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": {
"messageId": "<messageId>"
},
"name": "delete_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | ||
| confirmed | No | ||
| messageId | Yes | RFC 5322 Message-ID. | |
| permanent | No | ||
| acrossFolders | No |