アカウントで利用可能なボットまたは管理者のロールのリストを取得します。
このAPIには、ボット管理者コンソールからのみ作成されたアプリケーションによって生成されたJWTが必要です。このAPIを使用するために、アプリは [ロール管理] の [ロール管理] の管理APIスコープを必要とします。
GET https://{{host}}/api/public/roles?roleType=bot&limit=2
クエリパラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
| ホスト | 必須 | 環境URL（例： https://bots.kore.ai） |
| roleType | 必須 | ロールタイプ：
|
| limit | 任意 | 取得する記録数です。最大値は50です。 |
認証
以下の構文を使用して、JWTをヘッダーに含むAPIを呼び出します。 auth: {{JWT}}
応答のコンテンツタイプ
application/json
サンプルリクエスト
curl -X GET \ 'https://{{host}}/api/public/roles?roleType=bot&limit=2' \ -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
サンプル応答
{ "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": "" } ] }