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.
Token lifecycle
Section titled “Token lifecycle”- Create an API token with a descriptive name and an optional expiration.
- Store the returned raw value in a secret manager and send it as a bearer token.
- List token metadata to review active tokens. The raw values are never returned again.
- 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.