Skip to main content

API Authentication

Every API request requires a valid authentication token passed via the Authorization header.

POST/v1/auth/tokenClient credentials

Exchange client credentials for an access token.

Request

grant_typestringRequired

Must be client_credentials.

client_idstringRequired

Your application's client ID.

client_secretstringRequired

Your application's client secret.

scopestring

Space-separated list of scopes (e.g., orders:read infrastructure:manage).

Response

Response

Available Scopes

ScopeDescription
orders:readRead order data
orders:writeCreate and update orders
products:readRead product catalog
products:writeManage product catalog
billing:readView invoices and billing
billing:writeManage billing configuration
infrastructure:readView infrastructure resources
infrastructure:manageProvision and manage resources
adminFull administrative access