email_move_message
Moves one message into a different folder. The message leaves its current folder, so it will no longer be found where the user expects it. destination_folder_id must be a folder id from email_list_folders — a folder name will be rejected. To take a message out of the inbox without filing it, use email_modify_message with archive instead. account_id must be the mailbox holding the message; a message cannot be moved between accounts.
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."
},
"destination_folder_id": {
"type": "string",
"minLength": 1,
"description": "A folder id from email_list_folders, not a folder name."
}
},
"required": [
"account_id",
"message_id",
"destination_folder_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.