Bulk Move Emails
bulk_move_emailsMove multiple emails to a specified folder in a single operation. Supports folder selection and confirmation for Trash or Spam moves.
Instructions
Move multiple emails to a folder in one call. Moving to Trash or Spam requires { confirmed: true }. Emits progress notifications if a progressToken is provided in _meta. Returns success/failed counts. Pass sourceFolder whenever the UIDs came from a folder other than INBOX.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emailIds | Yes | Array of email UIDs to move | |
| confirmed | No | Must be true when targetFolder is Trash or Spam. | |
| account_id | No | Optional account ID to route this call to (multi-account configs). Omit to use the active account. Configured account IDs are listed in the settings UI (Accounts tab). | |
| sourceFolder | No | Folder the UID(s) live in (e.g. INBOX, Folders/Work, Labels/Foo). Strongly recommended whenever the UIDs came from a folder other than INBOX — IMAP UIDs are folder-scoped, so without this the wrong folder may be selected and the operation may silently no-op. Avoid passing 'All Mail' as the source: it is a union view of every folder, not a real location, so moves out of it can silently do nothing — pass the message's actual folder instead. Moving to the folder a message is already in is a no-op. | |
| targetFolder | Yes | Destination folder path |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| errors | Yes | ||
| failed | Yes | ||
| success | Yes |