[POST] .../v1/role/delete
Deletes role. Use this destructive method to delete a role after removing or accepting the impact on user and group role assignments. The method validates id, checks role delete permission 12, soft-deletes the role through the persistent layer, writes an action log record and returns row_affected. The request body is required and id must be positive; referenced-data constraints or protected system roles may be rejected by the persistent layer. Missing body, invalid id, denied permission, missing role, referenced-data conflicts and database errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | Int64 | Required | Role ID. |
Request Example
{
"id": 4
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1,
"ids": []
}
}