Channelized Docs
API referenceCustomer sign-in

Exchange a code or refresh a token

The token endpoint. Access tokens last up to 60 minutes and refresh tokens up to 30 days. A refresh token works once: each refresh returns a new one. Only for a company that has set up customer sign-in; for any other company it answers 404.

POST
/v1/{tenantKey}/oauth/token

Path Parameters

tenantKeystring

The company’s key: the short name in its assistant’s address. It appears in the console’s address and on its Connect an assistant page.

Header Parameters

Authorization?string

HTTP Basic, with the client id as the username. Send this or client_id in the form.

grant_typeunknown
Value in"authorization_code" | "refresh_token"
client_id?string

Required unless sent as the HTTP Basic username.

code?string

For authorization_code.

redirect_uri?string

For authorization_code: the same as on authorize.

code_verifier?string

For authorization_code: the PKCE verifier.

refresh_token?string

For refresh_token.

Response Body

curl -X POST "https://api.eu.channelized.ai/v1/string/oauth/token" \  -H "Authorization: string" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'grant_type=authorization_code'
{
  "access_token": "string",
  "token_type": "Bearer",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string"
}
{
  "error": "string",
  "error_description": "string"
}
{
  "error": "string",
  "error_description": "string"
}
{
  "error": "string",
  "error_description": "string"
}