confirm_empty_folder
Finalize emptying a mail folder by providing the approval token from prepare_empty_folder, deleting all messages. Validates token and folder match to prevent accidental deletion.
Instructions
Confirm and execute emptying a mail folder using a token from prepare_empty_folder. Deletes all messages in the folder. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the folder has changed since the prepare step.
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": {
"token_id": "<token_id>",
"folder_id": "<folder_id>"
},
"name": "confirm_empty_folder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_id | Yes | The approval token UUID from prepare_empty_folder (e.g., "a1b2c3d4-...") | |
| folder_id | Yes | The folder ID to empty — must match the ID used in the prepare step |