IMAP Advanced icon

IMAP Advanced

Generic IMAP operations with threading and attachments

Actions12

Thread → Get Full

AI-generated

Summary

Retrieves all messages comprising an IMAP thread starting from a base message identified by UID or Message-ID, using reference headers and optional subject fallback.

Inputs

  • mailbox — Mailbox name to operate on; defaults to INBOX.
  • identifierType — Type of identifier to locate the base message; defaults to uid. Options: uid, messageId.
  • uid — UID of the base message. Shown when identifierType is uid. Defaults to 0; omitted value causes 'Base message not found' error.
  • messageId — Message-ID header value of the base message. Shown when identifierType is messageId.
  • threadStrategy — Strategy for thread expansion; defaults to referencesThenSubject. Options: strictReferences, referencesThenSubject.
  • subjectFallback — When true and threadStrategy is referencesThenSubject with 1 or fewer references, performs a subject-based search to expand the thread.

Output shape

An array of one item with a json object containing: messageUid (number), references (array of Message-ID strings), strategy (threadStrategy string), total (number of messages), and messages (array of normalized message objects).

Messages are sorted by date ascending. Each message object includes uid, subject, date (ISO 8601), flags (array), and matchedBy ('messageId' if from reference set, 'subject' if from fallback search).

Links

Discussion