v1

latestOpenAPI 3.1.02026-08-06236494759.4 KB
User Roles

Remove roles from User

Endpoint to remove a Role from an User.

post/business/v2/employees/{userId}/unassignRole

Path parameters

userIdstring required

The User ID to remove Role from.

Example:XMPL1234-000001

Request body

namestring

The name of the Role.

descriptionstring

The description of the Role.

scopestring

The name of the scope.

Example request

{
  "name": "superAdmin",
  "description": "The SuperAdmin role",
  "scope": "ALL"
}

Response

The returned resource is a single User.

idstring

The User ID.

Example response

{
  "id": "XMPL1234-000001",
  "roles": [
    {
      "id": "superAdmin",
      "name": "superAdmin",
      "description": "The SuperAdmin role",
      "scope": "ALL"
    }
  ]
}