Skip to main content
POST
Create a read-only reporting token.

Authorizations

Authorization
string
header
required

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

Path Parameters

org_id
string<uuid>
required

Organization ID

Body

application/json
name
string
required

Human-readable name for the reporting token.

expires_at
string<date-time> | null

Optional expiration time. Must be in the future.

Response

Reporting token created

created_at
string<date-time>
required
created_by_user_id
string<uuid>
required
id
string<uuid>
required
name
string
required
organization_id
string<uuid>
required
scope
enum<string>
required
Available options:
usage:read
token
string
required

Raw reporting token. Returned only once when the token is created.

token_prefix
string
required

Non-secret token prefix for display and audit correlation.

expires_at
string<date-time> | null
last_used_at
string<date-time> | null

Approximate last-authentication timestamp, refreshed at most once every 15 minutes.