ユーザーアクセスを更新するAPI

ボットビルダーへのアクセス機能を追加または削除し、新しいボットを作成します。

このAPIには、ボット管理者コンソールからのみ作成されたアプリケーションによって生成されたJWTが必要です。このAPIを使用するために、アプリは [ロール管理] の [ロール管理] の管理APIスコープを必要とします。

GET https://{{host}}/api/public/useraccess

クエリパラメータ

パラメータ	説明
ホスト	環境URL（例： https://bots.kore.ai）

本文パラメータ

パラメータ	説明
emailIds	アクセス権を変更しなければならないユーザーメールIDの配列（例：["joe@kore.com", "amy@xyz.com"]）
canCreateBot	指定されたユーザーが、ボットビルダーのアカウントでボットを作成できるかどうかを判断します。TrueまたはFalseを設定します。
isDeveloper	指定されたユーザーがボットビルダーにアクセスできるかどうかを判断します。TrueまたはFalseを設定します。
hasDataTableAndViewAccess	指定されたユーザーがテーブルやビューを作成できるかどうかを判断します。TrueまたはFalseを設定します。

認証

以下の構文を使用して、JWTをヘッダーに含むAPIを呼び出します。 auth: {{JWT}}

応答のコンテンツタイプ

application/json

サンプルリクエスト

curl -X POST \ https://{{host}}/api/public/useraccess \ -H 'Content-Type: application/json' \ -H 'auth: YOUR_JWT_ACCESS_TOKEN' \ -d '{ "emailIds":["sample1@sampleemail.com"], "canCreateBot":true, "isDeveloper":true, "hasDataTableAndViewAccess": true }'

サンプル応答

成功例：
```
[ “SUCCESS” ]
```

Invalid input combination: canCreateBot: true, isDeveloper: false

{ "errors": [ { "msg": "Invalid values in the body", "code": 403 } ] }

No email addresses provided: emailIds [ ] is empty

{ "errors": [ { "msg": "emailIds cannot be empty", "code": 400 } ] }

無効なメールID、またはDBに存在しないメールアドレス（アカウントに関連付けられているもの）
```
{ "errors": [ { "msg": "One or more entered emails not found", "code": 400 } ] }
```

他のアカウントに属している1つ以上のメールID

{ "errors": [ { "msg": "Emails <> not associated with your account", "code": 400 } ] }

On this Page

Update User Access API

To add or remove the ability to access bot builder, create new bots.

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/useraccess

Query Parameters

Parameter	Description
host	Environment URL, for example, https://bots.kore.ai

Body Parameters

Parameter	Description
emailIds	The array of user email Ids whose access permissions have to be changed, for example, [“joe@kore.com”, “amy@xyz.com”]
canCreateBot	Determines if the specified users can create bots in their Bot Builder accounts. Set to true or false.
isDeveloper	Determines if the specified users can have access to Bot Builder. Set to true or false.
hasDataTableAndViewAccess	Determines if the specified users can create tables and views. Set to true or false.

Authorization

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

auth: {{JWT}}

Response Content Type

application/json

Sample Request

curl -X POST \
  https://{{host}}/api/public/useraccess \
  -H 'Content-Type: application/json' \
  -H 'auth: YOUR_JWT_ACCESS_TOKEN' \
  -d '{
"emailIds":["sample1@sampleemail.com"],
"canCreateBot":true,
"isDeveloper":true,
"hasDataTableAndViewAccess": true
}'

Sample Response

For success case:
```
[
  “SUCCESS”
]
```

Invalid input combination: canCreateBot: true, isDeveloper: false

{ 
  "errors": [ 
      { 
        "msg": "Invalid values in the body", 
        "code": 403 
       } 
       ] 
 }

No email addresses provided: emailIds [ ] is empty

{
  "errors": [
      { "msg": "emailIds cannot be empty", 
        "code": 400 } 
   ] 
 }

Invalid email id or any email which is not present in DB (Which is associated with the account)

{
  "errors": [
    { "msg": "One or more entered emails not found",
      "code": 400 }
    ]
 }

One or more emailIds belong to other accounts

{
  "errors": [ 
    { "msg": "Emails <> not associated with your account",
      "code": 400 }
    ]
 }

On this Page