Skip to content

Accounts

Endpoint What it does
POST /accounts Register an account id derived on the device from a recovery phrase. Takes accountId, authVerifier and authPublicKey. Returns the account with a session token and expiresAt. The phrase is never sent.
POST /accounts/challenge Send an accountId. Returns a single-use nonce, its expiresAt two minutes out, and an ephemeral X25519 challengeKey. The answer is the same whether or not the account exists.
POST /accounts/verify Send accountId, nonce and proof. Returns the account with a session token and expiresAt. See Authentication.
GET /accounts/me The authenticated account and its plan.
POST /accounts/signout End the current session. Session only.
GET /accounts/sessions The account’s live sessions, with the current one marked. Session only.
DELETE /accounts/sessions End every session except the current one. Session only.
DELETE /accounts/sessions/:id End one session. Session only.
DELETE /accounts/me Erase the account and everything in it, immediately. Its addresses are retired and never reissued. Session only.
GET /overview Account counters for the dashboard.
GET /activity Recent account activity, up to limit entries (default 20, at most 200).

“Session only” endpoints answer 403 session_required to an API key.