Delete an existing role. Requires roles.write permission. Roles with assigned users cannot be deleted.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | The unique identifier of the record |
Responses
| Status | Description |
|---|---|
| 204 | An empty response body indicating that the role has been deleted |
| 400 | The role cannot be deleted due to business rules (e.g., has assigned users) |
| 403 | The requesting user lacks appropriate permissions |
| 404 | The role was not found |