Skip to main content
POST
Create API token

Authorizations

Authorization
string
header
required

Bearer token authentication. Supports two token types:

  • JWT Access Token — obtained via POST /v1/auth/login
  • Personal Access Token (PAT) — created via POST /v1/api-tokens, format: cmnd_<tokenId>.<secret>

Body

application/json
name
string
required

Human-readable name for the token

Example:

"CI/CD Pipeline Token"

scopes
string[]
required

Permission scopes for the token

Example:
expires_in_days
integer
default:90

Token expiry in days (max 365)

Example:

90

Response

Token created successfully

token
string

The token secret (shown only once). Format: cmnd_.

Example:

"cmnd_abc123.sk_xxxxxxxxxxxxxxxxxxxx"

id
string
Example:

"abc123"

name
string
Example:

"CI/CD Pipeline Token"

scopes
string[]
Example:
created_at
string<date-time>
expires_at
string<date-time>