Scopes
Zoho Assist APIs require OAuth scopes to define the level of access your application needs. When requesting for access token, request only the scopes your application requires. These will be displayed to the users when asking for consent.
Scopes contain three parameters — service name, scope name, and operation type. The format to define scope is service_name.scope_name.operation_type
Example:
https://accounts.zoho.com/oauth/v2/auth?scope=ZohoAssist.sessionapi.CREATE
Here, ZohoAssist is the service API name, sessionapi is the scope name, and CREATE is the operation type.
User Scope
| Scope Name | Purpose |
| ZohoAssist.userapi.READ | Know who you are on Zoho Assist. |
Session Scope
| Scope Name | Purpose |
ZohoAssist.sessionapi.CREATE | Create your remote support sessions using Zoho Assist. |
| ZohoAssist.unattended.device.CREATE | Create your Unattended Remote sessions using Zoho Assist. |
Unattended Computer Scopes
| Scope Name | Purpose |
| ZohoAssist.unattended.computer.READ | View and manage unattended computers configured on Zoho Assist. |
| ZohoAssist.unattended.computer.UPDATE | Update unattended computers configured on Zoho Assist. |
| ZohoAssist.unattended.computer.DELETE | Delete unattended computers configured on Zoho Assist. |
Unattended Group Scopes
| Scope Name | Purpose |
| ZohoAssist.unattended.group.READ | View unattended computer groups on Zoho Assist. |
| ZohoAssist.unattended.group.CREATE | Create unattended computer groups on Zoho Assist. |
| ZohoAssist.unattended.group.UPDATE | Update unattended computer groups on Zoho Assist. |
| ZohoAssist.unattended.group.DELETE | Delete unattended computer groups on Zoho Assist. |
Report Scope
| Scope Name | Purpose |
| ZohoAssist.reportapi.READ | View remote support and unattended session reports on Zoho Assist. |
To request multiple scopes, separate them with commas:
scope=ZohoAssist.userapi.READ,ZohoAssist.sessionapi.CREATE
For more details about scope format, see OAuth Scopes.