# Delete a role
This endpoint deletes the requested role.
Only roles that are not used (i.e. there are no users with the role assigned) can be deleted.
In order for a user to perform the "delete_user_role" operation, the "delete_user_role" permission must be included in the list of allowed actions in the statement of the user's role.
|name||string||Name of the role. It must match the regular expression (opens new window) |
|rules||dictionary||Access rules that control access to a |
|effect|| string, value is || Permission to perform an |
|actions||list||List of actions that we grant the user with the role the permission to perform. The value must correspond with the name of an endpoint operation.|
# Status codes
Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status Codes section.