Bulk Mark Emails Read/Unread
bulk_mark_readIdempotent
Mark multiple emails as read or unread with progress notifications. Returns success and failed counts, and supports specifying the source folder for accurate IMAP operations.
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 |