Skip to main content
POST
Create admin access token (Admin only)

Authorizations

Authorization
string
header
required

JWT access token for user authentication (Authorization: Bearer <jwt_token>). Create via POST /users/me/access_tokens.

Body

application/json

Admin access token request model

expires_in_hours
integer<int64>
required

Number of hours until the token expires (required)

name
string
required

Name for the token (required)

reason
string
required

Reason for creating the token (required)

permission
enum<string>
default:read_write

Defaults to read_write when omitted for backwards compatibility. Null and unknown values are rejected. Revoke and recreate to change permission.

Available options:
read_only,
read_write

Response

Admin access token created successfully

Admin access token response model

access_token
string
required
created_at
string<date-time>
required
created_by_user_id
string
required
expires_at
string<date-time>
required
id
string
required
name
string
required
permission
enum<string>
required

Immutable admin-token permission across organizations. Read-only tokens can invoke explicitly approved reads (including pricing/deprecation previews and database-encryption scans), but cannot mutate business state. Usage bookkeeping and audit logging remain enabled. Both permissions are forbidden from creating, listing, or revoking admin tokens; those require an admin session.

Available options:
read_only,
read_write
reason
string
required