Getting an Access Token

This section provides a step-by-step guide to obtaining an access token, which is required to authenticate and authorize API requests for secure interactions between Knovvu Virtual Agent and and the client application.

Prerequisites

clientId and clientSecret must be obtained from the SESTEK Sales Support & Operations Team. For on-prem deployments, an application must be created using the Host account.

Get an Access Token

Endpoint:
URL: https://{{identityBaseUrl}}/connect/token
HTTP Method: POST
Content Type: application/x-www-form-urlencoded

Examples

Here's an example of a request:

curl --location '{{identityBaseUrl}}/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={{client_id}}' \
--data-urlencode 'client_secret={{client_secret}}'
--data-urlencode 'scope=orchestrator_external'

Expected Response:

{
  "access_token": "<access_token>",
  "token_type": "Bearer",
  "expires_in": 86399,  // valid for 1 day
  "scope": "orchestrator_external"
}