IMAP (AI) icon

IMAP (AI)

Read, search, move, flag and download emails from any IMAP server. Fully usable as a tool from AI Agent nodes.

Actions19

Email → Unflag

AI-generated

Summary

Remove a specified flag (such as \Flagged or a custom keyword) from one or more emails identified by their UIDs within a specified IMAP mailbox folder.

Inputs

  • Mailbox / Folder (required) — IMAP folder path where the emails reside, e.g., INBOX, Sent, or [Gmail]/All Mail.
  • UIDs (required) — One or more unique message identifiers (UIDs) within the mailbox. Can be a single number (e.g., '42'), a comma-separated list (e.g., '1,5,9'), or an IMAP range (e.g., '100:200' or '1:*'). This operation will apply the unflag action to all specified messages in a single IMAP round-trip.
  • Flag (required) — The flag keyword to remove from the messages. Use '\Flagged' to remove the star, '\Seen' for read-state flags, or specify a custom flag keyword such as 'Important'.

Output shape

a single record

Returns a JSON object containing keys 'uids' (the processed UID sequence string), 'requestedCount' (null if the UID range contained a wildcard or count of UIDs), 'flag' (the flag removed), and 'removed' (boolean true to indicate success). The operation throws an error if no messages matched the provided UIDs or if the mailbox is read-only.

Links

Discussion