Bulk Mark Emails Read/Unread
bulk_mark_readIdempotent
Mark multiple emails as read or unread with progress notifications and success/failed counts. Specify the source folder to ensure correct operation.
Instructions
Mark multiple emails as read or unread. Emits progress notifications. Returns success/failed counts. Pass sourceFolder whenever the UIDs came from a folder other than INBOX.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isRead | No | ||
| emailIds | Yes | Array of email UIDs | |
| 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. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| errors | Yes | ||
| failed | Yes | ||
| success | Yes |