Rotate a mailbox's API key. The new key is answered once; the old one stops working now.

post/v1/mailbox-keys

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Secure-better-auth.session_token

Request body

mailboxIdstring required

The org's mailbox id — Mailbox.id, not the engine account.

Response

The request has succeeded and a new resource has been created as a result.

idstring required
labelstring required
engineAccountIdstring nullable required

The engine account this container lives on. What keeps a caller's correlation wire-level: token props name mailboxes by engine id, and this is that id. Null while provisioning, and on a failed claim.

keyPrefixstring nullable required

The displayable head of this mailbox's engine key. The key itself is minted on the engine and is not held here.

status'provisioning' | 'active' | 'failed' required
createdAtstring date-time required
apiKeystring required

The API key — the bearer the mailbox surface takes. Shown once and never again.

Changes

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