Deletes a user role by its identifier
Use this endpoint to permanently remove a user role. System-provided roles (read-only) cannot be deleted.
Roles currently assigned to users cannot be deleted — reassign users to a different role first.
Requires Roles Manage permission.
Request Headers
| Header | Value | Required | Description |
|---|---|---|---|
| ECI-ApiKey | string | Yes | Your API key. See Authentication. |
| Content-Type | application/json | Yes | All requests must specify JSON content type. |
Path Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| userRoleId | Unique numeric identifier of the role to delete | integer (int32) | Required |
Responses
204
No Content
The request succeeded. No content is returned in the response body.
400
Bad Request
The request was malformed or contains invalid parameters. Check the request body and query parameters.
404
Not Found
The requested resource was not found. Verify the ID or path is correct.