Skip to main content
Create, list or revoke scoped API tokens: bearer tokens limited to named scopes, for a program such as an event sidecar or a notifier instead of a full device session. See the scope table at Remote access.

create

Prints the id, name, scopes, and the token (odk_…) once, followed by:
Works without a running dashboard; it writes the registry directly.

list

Lists API tokens (your own, agent and OAuth tokens) with columns ID NAME SCOPES CREATED LAST USED REVOKED. Paired devices, linked machines, phones and connectors are not listed. Works without a running dashboard. With no access tokens: `No access tokens. Create one with `pan token create`.` The list also shows tokens Overdeck creates for you:
  • Agent tokens, named agent:<role>:<agentId>. Overdeck mints one for each managed agent and conversation at launch and revokes it when the agent stops. Their scopes follow the role (see Agents get these tools).
  • OAuth tokens, named <client name> (OAuth), one per approved MCP sign-in. An OAuth token expires after 30 days unless the client refreshes it. Manage sign-ins with pan mcp oauth.
The table does not show which agent or sign-in a token belongs to; --json prints every field, including agentId, agentKind and role for an agent token and oauthClientId, oauthFamilyId and expiresAt for an OAuth token. An agent token leaves the list 7 days after it is revoked, and an expired OAuth token 7 days after it expires. A revoked OAuth token stays 90 days longer, so a later refresh with its old refresh token still sees the revocation.

revoke

Through the dashboard it prints:
With no dashboard running it writes the registry and prints:
An unknown id prints No access token with id <id>. and exits 1. A dashboard that was not started by pan up (for example pan serve) rejects this machine’s internal token; the command then says pan token revoke needs a dashboard started by pan up and exits
  1. Any other refusal prints pan token revoke failed: <reason> and exits 1.

Get help

Still stuck? Ask on the Overdeck Discord or file a GitHub Issue.