Update User Access API - Kore.ai Docs

Back to API List To add or remove the ability to access App Builder to create new bots.

This API requires JWT generated by an application created only from the Admin Console.

Field	Value
Method	POST
Endpoint	`https://{{host}}/api/public/useraccess`
Content Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token.
API Scope	App Builder: Not Applicable; Admin Console: Profile Management > Role Management

Path Parameters

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

Sample Request

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

Body Parameters

Parameter	Description
`emailIds`	The array of user email IDs whose access permissions have to be changed, for example, `["john.doe@example.com", "jane.doe@example.com"]`.
`canCreateBot`	Determines if the specified users can create AI Agents in their App Builder accounts. Set to `true` or `false`.
`isDeveloper`	Determines if the specified users can have access to App Builder. Set to `true` or `false`.
`hasDataTableAndViewAccess`	Determines if the specified users can create tables and views. Set to `true` or `false`.
`includeMeta`	Optional	Set to true for encrypted response. Default: False.

Sample Response

Success:

[
  "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 can't be empty",
        "code": 400 }
   ]
}

Invalid email ID or email not present in the account:

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

One or more emailIds belong to other accounts:

{
  "errors": [
    { "msg": "Emails << jane.doe@example.com >> not associated with your account",
      "code": 400 }
  ]
}

​Path Parameters

​Sample Request

​Body Parameters

​Sample Response

Path Parameters

Sample Request

Body Parameters

Sample Response