Skip to content

neo token

Manage personal access tokens.

Create scoped, expiring tokens; list, revoke, and rotate them.

neo token [OPTIONS] <COMMAND>

Create a personal access token.

Scopes default to full authority when none are given; --repo/--org narrow the token to specific resources.

neo token create [OPTIONS] <LABEL>
Option Value Required Default Env Values Description
<LABEL> yes Human label for the token (shown in the list)
--scope <SCOPE> no Grant a scope (repeatable), e.g. --scope repo:read --scope user:read
--repo <REPO> no Restrict to a repo id (repeatable)
--org <ORG> no Restrict to a workspace/org id (repeatable)
--expires <EXPIRES> no Lifetime in days (default 90, max 400)

List your personal access tokens

neo token list [OPTIONS]

Revoke a token by id

neo token revoke [OPTIONS] <TOKEN_ID>
Option Value Required Default Env Values Description
<TOKEN_ID> yes Token id, as printed by neo token list. Revoking one that no longer exists succeeds

Rotate a token’s secret in place (keeps its id and grant)

neo token rotate [OPTIONS] <TOKEN_ID>
Option Value Required Default Env Values Description
<TOKEN_ID> yes Token id, as printed by neo token list