messages_move
Move an e-mail message to another folder of the real mailbox (the provider's own Archive, Inbox or a folder by its exact name). Works on mailboxes connected over IMAP/SMTP (e.g. Yahoo); other channels, and Gmail accounts connected read-only, refuse. To delete a message use messages.delete (it moves to the Trash).
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": {
"message_id": "<message_id>",
"folder": "<folder>"
},
"name": "messages_move"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder | Yes | Destination: "archive", "inbox" or the exact folder name in the mailbox. | |
| message_id | Yes | ID of the e-mail message (from messages.read_history). | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. |