Skip to main content

Create a token for the acting account

POST 
/api/v3/me/tokens

Dashboard session only. Create a token for the acting account (the plain token is in the answer, once). In an organization it acts for the organization and stops working when its creator leaves. permissions (keys from /api/v3/me/token-permissions) limits the token to those (perm:⟨key⟩ abilities): anything they do not cover (billing, team, token management, …; listening needs listening.read / listening.write) answers 403 insufficient_permissions; GET /api/v3/me stays open. scope: read_only tokens may only GET/HEAD. actor_ids (ids or user~name) limits the token to those actors (read, builds, start runs), their runs (read, log, abort) and reading the default storages of those runs (by id; writes are the run's own token's); on /api/v3/mcp and /api/v3/standby the same scope applies. Stored as Sanctum abilities * or read, actor:⟨id⟩, plus member:⟨id⟩ for organization tokens. The list answers scope and actor_ids per token.

Request​

Responses​

Created (token, scope, actor_ids)