e2e

Register or rotate E2E public key

Register or rotate the X25519 E2E public key for this account. On first call: sets master_seed hash and initial public key. On subsequent calls: verifies master_seed matches stored hash, then rotates. Old keys are retained in history so old encrypted messages remain decryptable.

When an @agentlair.dev address has a registered public key (via POST /v1/email/claim with public_key), inbound emails are encrypted with X25519 ECDH + AES-256-GCM.

post/v1/e2e/rotate-key

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/e2e/rotate-key
  • Auth: HTTP bearer

Request body

master_seedstring required

Ownership proof — SHA-256 hash stored server-side

new_public_keystring required

Base64 or hex encoded X25519 public key (32 bytes)

Response

E2E key registered or rotated

okboolean
account_idstring
active_public_keystring
key_history_countinteger
first_setupboolean
updated_atstring date-time
notestring

Changes

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