Authentication (Interaction Content API)

To use the Interaction Content API, you need a bearer access token. Your bearer access token authenticates your request to the API. The API will check that you are authorized to make requests.

Getting a bearer access token

Use Vonage Contact Center’s Authentication API to get your bearer access token. For information about using the API to get a bearer access token, see Getting a bearer access token in How to authenticate with a Vonage Contact Center (VCC) API.

When requesting your bearer access token, depending on which endpoint you want to call, use required scope from the table below as the value for scope.

endpointrequired scope
GET /interactionsinteraction-content:read
GET /interactions/{guid}interaction-content:read
DELETE /interactions/{guid}interaction-content:delete
POST /interactions/delete-batchinteraction-content:delete

You can also use the same bearer token to call all endpoints if you provide all supported scopes when requesting the bearer token: interaction-content:read interaction-content:delete (without a comma between the scopes).

Token expiration

Your bearer access token is only valid for use for two hours after being issued. After this time, the token expires and you must request a new token.

Using a bearer access token

When you have got your bearer access token, you must use the token to authenticate every request you make to the Interaction Content API. For information about using the bearer access token, see Using a bearer access token in How to authenticate with a Vonage Contact Center (VCC) API.