API tokens

Long-lived tokens the CLI and scripts sign in with: create, list, revoke.

An API token lets the zeon CLI or a script sign in without a browser. A token belongs to you and has the same access as your account. Manage your tokens at https://zeonsystems.app/account/api-tokens, or from API tokens in the account navigation.

You do not need a token for the web app; it uses your browser session.

Creating a token

Usually you do not create tokens by hand: zeon auth login signs you in through the browser and creates and stores a token for the CLI. See Signing in.

To create one on the page:

  1. Under Create a new token, enter a Name you will recognise later, for example laptop or ci-bot (1 to 64 characters).
  2. Click Create token.
  3. The Token created dialog shows the token once. Copy it with Copy, then click I've saved it.

Only a hash of the token is stored, so it cannot be shown again. If you lose it, revoke it and create a new one.

A token created on the page is valid for 90 days. zeon auth login --expires-in-days <n> creates one valid for 1 to 365 days.

To use a token created on the page with the CLI, pass it to zeon auth login --token <token>.

Treat a token like a password. Anyone who has it has your access. Do not commit it to git or paste it into chat.

The list

The page lists your tokens, newest first, with Name, Created, Expires and Status (Active, Expired or Revoked). Expired and revoked tokens stay in the list and cannot be reactivated.

Revoking a token

Click Revoke on an active token and confirm. Any client using it is locked out at once, and browser sessions started by its login links end. zeon logout revokes a token that a browser zeon login created. Revoking cannot be undone. Revoke a token when a machine is lost, when the token may have leaked, or when you no longer use it.

Limits

  • A token cannot create another token. Creating a token needs a browser sign-in.
  • Tokens have no scopes: each one can do everything your account can.
  • The page shows only your own tokens. An organization admin cannot see or revoke another member's tokens.

Disabling an account does not revoke its API tokens. They keep working until they expire or are revoked. When someone leaves or an account may be compromised, their tokens must be revoked as well. Only the owner can revoke a token on this page; if they cannot, contact Zeon. See Organization members.


Did this page help you?