email

Get message

Retrieve and mark a message as read.

  • If E2E encryption is disabled: returns decrypted body (string).
  • If E2E encryption is enabled: returns body (ciphertext, base64url), ephemeral_public_key, and e2e_encrypted: true. Decrypt client-side using X25519 ECDH + HKDF-SHA-256 + AES-256-GCM.
get/v1/email/messages/{id}

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/email/messages/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

URL-encoded message ID

Query parameters

addressstring required

Response

Full message

message_idstring
fromstring
tostring
subjectstring
snippetstring

First 120 characters of message body (list view)

received_atstring date-time
readboolean
archivedboolean

Whether the message has been archived (default false)

e2e_encryptedboolean

Present and true when address has E2E key registered

bodystring

Decrypted body (plaintext) or base64url ciphertext if e2e_encrypted

ephemeral_public_keystring

Present when e2e_encrypted=true, used for ECDH decryption

Changes

No recorded changes to this operation across all 1 revision of this API.