API Token

Token generation and management

Get API access token

post

Exchange API client credentials for an access token. Use this token in the Authorization header as "Bearer " for authenticated API requests.

Body

application/json

clientIdstringRequired

The API client ID provided when the API client was created

Example: client_abc123xyz

clientSecretstringRequired

The API client secret provided when the API client was created

Example: secret_def456uvw

organizationIdstringRequired

The organization ID associated with this API client

Example: org_789ghi

Responses

200

Successfully authenticated and returned access token

application/json

tokenstringRequired

JWT access token to use for authenticated API requests

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

token_typestringRequired

Type of token (always "Bearer")

Example: Bearer

expires_innumberRequired

Token expiration time in seconds

Example: 3600

400

Bad request - missing or invalid parameters

401

Invalid credentials or unauthorized

post

/api/token

HTTPcURLJavaScriptPython

POST /api/token HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "clientId": "client_abc123xyz",
  "clientSecret": "secret_def456uvw",
  "organizationId": "org_789ghi"
}

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}