The three credentials
Get a session JWT
Sign in with email, phone, or OAuth. The response includes a JWT.Authorization: Bearer eyJhbGciOi... on every user-scoped request. If the account has 2FA enabled, the login response indicates a challenge and you must call POST /api/auth/2fa/verify before receiving a full session.
Create an API key
API keys are virtual keys you create from the dashboard or through the API, then use against the per-site gateway and authenticated download endpoints.key. Store it in a secret manager. Later GET /api/api-keys responses only return prefix, never the full value.
Query-token downloads
A plain<a href> in the browser cannot send request headers, so some file endpoints also accept ?token=<jwt>:
GET /api/billing/invoices/{paymentId}/download?token=...GET /api/billing/receipts/{paymentId}/download?token=...
Authorization header.
Failure modes
Session tokens are short-lived. Re-authenticate by calling
POST /api/auth/login when the current token expires.