Get Roles API2 min read

To retrieve the list of bot or admin roles available in an account.

This API requires JWT generated by an application created only from Bot Admin Console.
To use this API, app needs the Admin API Scope of Role Management under Role Management.

GET https://{{host}}/api/public/roles?roleType=bot&limit=2

Query Parameters

Authorization

Invoke the API with JWT in the header with the following syntax:

auth: {{JWT}}

Response Content Type

application/json

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": ""
        }
    ]
}