Access Tokens

Download Spec

All authentication related paths.

Get an access token for requested scopes

post /auth/token

Get an access token to use with the API with specified scopes.

You should always scope your access tokens. You get one for read-access and separate ones for updating, creating or deleting resources.

client_id

string

uuid

required

Client ID given during onboarding.

client_secret

string

required

Client Secret given during onboarding.

Max Length
1000

grant_type

string

required

This must always be client_credentials.

Default
"client_credentials"

scope

string

required

List of space delimited scopes to request for this access token.

Max Length
1000

Response

ExamplesSchema

Access token successfully generated.

{
  "access_token": "token.signature",
  "expires_in": 86400,
  "token_type": "bearer",
  "scope": "users:read"
}