Delete draft
delete_draftPermanently delete an unsent draft by draftId to remove unwanted or duplicate drafts from the Drafts folder; deletion is irreversible, so use update instead to edit.
Instructions
Permanently delete an unsent draft. Use this to retire a draft that is no longer wanted — for example the earlier version after you staged a replacement with create_draft — so the user does not find duplicates in their Drafts folder. Takes the draftId create_draft or update_draft returned, or one list_drafts shows. The draft does not go to Trash and cannot be recovered; to change a draft rather than remove it, use update_draft. Sent or received mail is refused (use trash_emails for that), as is a draft whose send is in progress. Returns the deleted draft's subject and recipients.
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": {
"draftId": "<draftId>"
},
"name": "delete_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draftId | Yes | The draft id, as returned by create_draft, update_draft or list_drafts — edits do not change it — or a message id from search_emails with `mailbox: "Drafts"`, which an edit replaces with the draftId it returns. |