Skip to content

API tokens

API tokens authenticate native apps, scripts, and integrations. Tokens are opaque random values. The server stores only a SHA-256 digest, and the raw value is shown only once when a token is created.

  1. Create an API token with a descriptive name and an optional expiration.
  2. Store the returned raw value in a secret manager and send it as a bearer token.
  3. List token metadata to review active tokens. The raw values are never returned again.
  4. Revoke an API token when it is no longer needed. Revocation is immediate and cannot be undone.
Authorization: Bearer <raw token>

Use the email code sign-in flow to create a first device token, then use that token to create named tokens.