Skip to content

UserGuide.md

Latest commit

 

History

History
29 lines (21 loc) · 1.03 KB

UserGuide.md

File metadata and controls

29 lines (21 loc) · 1.03 KB
Raw

Mail User Guide

Use apple mail --help and subcommand help as the first reference.

Common reads:

apple mail accounts list --json
apple mail mailboxes list --account ACCOUNT_ID --json
apple mail messages search --mailbox Inbox --query "invoice" --json
apple mail messages body-preview --mailbox Inbox --id MESSAGE_ID --max-bytes 20000 --json

Draft, send, and mailbox mutations use the DryRun safety flow:

apple mail messages draft --to user@example.com --subject "Hi" --body "Hello" --dry-run --json

The detailed capability boundary lives in ../../Architecture/Mail/CapabilityList.md.

Body previews respect --max-bytes in UTF-8 and preserve complete characters. truncated indicates that additional body content was omitted.

Successful send results contain sent.submitted: true after Mail accepts the request. Mail owns delivery tracking. Rejected or unconfirmed submissions return an error with submission_status set to rejected or unknown; inspect Mail's outgoing messages and drafts before retrying.