DELETE ./roles

Deletes an existing role by roleID.

For a role to be deleted it must not have any users assigned to it.

DELETE parameters

NameValue TypeValidationDetails
roleIDintRequiredRole id.
removeUsersintOptionalvalues[0,1]; If this is present this role will be removed from all users assigned.

Validation

Error FieldError CodeError Message
roleID101Role not found.
roleID102The role has assigned users.

Output example

{
"result": true
}