Delete a role
DELETE/api/v1/RolesRole/:roleId
Deletes a role. The role no longer appears in role lists, and its members no longer receive the permissions it granted. Use it when a delegated responsibility is no longer needed.
Permission required: Administrator role.
Caution: The role is deleted immediately and its members lose the access it granted.
Request
Responses
- 200
- 400
- 403
- 404
The role was deleted. There is no response body.
The role could not be deleted.
The signed-in user does not have the required role, or the account has read-only administrator access.
The role does not exist.