📘
Adding a Scope
When a scope is added to an OAuth client via Builder, it may take a few minutes for the scope to be effective.
The scope won’t be available instantly: a 401 error message is displayed when requesting a token.

Scopes on General Availability

Scopes constrain the endpoints to which you have access, and whether you have read or write access to an endpoint.

The scopes required for each API are also identified on the corresponding API individual page.

API	Scopes
Accounts API (information about a Talkdesk account)	`account:read`
Apps API (information about a specific installation of a partner app in a Talkdesk customer's instance)	`apps:read` `apps:write`
Callback API (places a caller in queue without him having to wait on hold)	`callback:write`
Contacts API (allows getting and editing a contact's information)	`contacts:read` `contacts:write`
Conversation Streams API	`call-streaming-settings:read` `call-streaming-settings:write`
Do Not Call Lists (DNCL) API (allows retrieving, creating and modifying DNCL for Outbound Dialer)	`do-not-call-lists:manage`
Explore API (provides historical data reports)	`data-reports:write` `data-reports:read`
Events API (exposes events that happen inside Talkdesk as webhook calls, allowing to subscribe to events around an app's lifecycle)	`events:write`
Flows API (starts an interaction that executes the published version of a given Studio flow)	`flows-interactions:start`
Guardian Cases API (allows access to the list of cases detected while analyzing Talkdesk platform agents' behavior)	`guardian-cases:read`
Guardian Sessions API (allows to easily access sessions’ data from the Talkdesk platform agents)	`guardian-session:read`
Guardian Users API (provides all the information Guardian has about the users of an account - name, role, ring groups, creation place, user activation and status)	`guardian-users:read`
Live API (provides live data in real-time)	`live-queries:read` `live-subscriptions:read` `live-subscriptions:write`
Phone Validation API	`identity-phone-validation:read`
Record Lists API (allows the creation, deletion and cataloging of record lists)	`record-lists:manage`
Reporting API (provides historical data reports)	`reports:write` `reports:read`
Ring Groups API (facilitates the ring groups management)	`ring-groups:read` `user-ring-groups:read`
Users API (information about users)	`users:read`
Voice Biometrics Opt-In API (allows the opt-in of contacts enrolled in voice biometrics)	`voicebiometrics-consent:write` `voicebiometrics-consent:read`
Voice Biometrics Opt-Out API (allows the opt-out of contacts enrolled in voice biometrics)	`voicebiometrics-enroll:write`

📘Adding a Scope

Scopes on General Availability

📘
Adding a Scope