To retrieve the list of the bot or admin roles available in an account.
This API requires JWT generated by an application created only from the Bot Admin Console.
| Method | GET |
| Endpoint | https://{{host}}/api/public/roles?roleType=bot&limit=2 |
| Content Type | application/json |
| Authorization |
|
| API Scope |
|
Path Parameters
| Parameter | Required/Optional | Description |
|---|---|---|
| host | Required | Environment URL, for example, https://bots.kore.ai |
| roleType | Required |
The role type:
|
| limit | Optional | The number of records to fetch. The maximum applicable limit is 50. |
Sample Request
curl -X GET \
'https://{{host}}/api/public/roles?roleType=bot&limit=2' \
-H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
Sample Response
{
"total": 2,
"availableMore": false,
"roles": [
{
"roleType": "admin",
"role": "admin",
"rDesc": "Master administration role with full control on account activity",
"permissions": {
"Invite": "YES",
"Import Users / Sync": "YES",
"Directory Sync": "YES",
"Manage User Profile Fields": "YES",
"Manage Groups": "YES",
"Manage Deployment": "YES",
"Enterprise Bots": "YES",
"Password Policies": "YES",
"Single Sign On": "YES",
"Domain Management": "YES",
"Kore.ai Connector": "YES",
"Manage Built-In Admin Roles": "YES",
"Manage Custom Admin Roles": "YES",
"View and Run Audit Reports": "YES",
"Consumer Bots": "YES",
"View and Run Bot Chat History": "YES",
"Manage Bot Roles": "YES",
"Preferences": "YES",
"Smart Bots": "YES",
"API Scopes": "YES",
"Enterprise Key": "YES"
}
},
{
"roleType": "admin",
"role": "sample admin",
"permissions": {
"Invite": "YES",
"Import Users / Sync": "NO",
"Directory Sync": "NO",
"Manage User Profile Fields": "YES",
"Manage Groups": "YES",
"Manage Deployment": "YES",
"Enterprise Bots": "YES",
"Smart Bots": "YES",
"Preferences": "YES",
"Single Sign On": "YES",
"Kore.ai Connector": "YES",
"Manage Built-In Admin Roles": "YES",
"Manage Bot Roles": "YES",
"Manage Custom Admin Roles": "YES",
"View and Run Audit Reports": "YES",
"View and Run Bot Chat History": "YES",
"Consumer Bots": "YES",
"API Scopes": "YES",
"Enterprise Key": "YES"
},
"rDesc": ""
}
]
}