Update User Access API

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":["[e-mail]"],
"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, ["[e-mail]", "[e-mail]"].
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 << [e-mail] >> not associated with your account",
      "code": 400 }
  ]
}