Reading your mail

List folders, read message bodies, trash and purge.

GET BASE/v1/api/mail/messages?folder=inbox&take=20
Cookie: <session>

Optional cursor for pagination. Folders: inbox | sent | drafts | trash.

List rows return decrypted subject, from, to, and snippet. Bodies are not included in the list.

GET BASE/v1/api/mail/messages/{id}
Cookie: <session>

Returns the message metadata plus textBody / htmlBody / rawMime. Attachment metadata is included; download bytes via:

GET BASE/v1/api/mail/messages/{id}/attachments/{attachmentId}
Cookie: <session>

POST BASE/v1/api/mail/messages/{id}/read
Cookie: <session>

DELETE BASE/v1/api/mail/messages/{id}
Cookie: <session>

Delete moves the message to trash. Calling delete again on a trashed message permanently removes it.

One-off forward

POST BASE/v1/api/mail/messages/{id}/forward
Cookie: <session>
Content-Type: application/json

{
  "to": ["friend@example.com"],
  "includeAttachments": true,
  "note": "FYI"
}

Reuses the outbound send path. See Forwarding your mail.