Add

[POST] .../v1/role/add

Adds new role. Create a new RBAC role before assigning permissions through RolePermission/Edit and assigning the role to users or groups. The method validates name, checks role add permission 10, checks that the tariff allows role creation, inserts the role and returns new_id. The request body is required, name must be provided and must not exceed 50 characters and description is optional with a maximum length of 300 characters. Missing body, missing or too long name, denied permission, disabled tariff option, duplicate role data and storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

{
  "name": "Cashier",
  "description": "POS operator role"
}

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "new_id": 4
  }
}