Create a role

Creates a custom role. Requires Role Manager (rbac) and role:write or usermanagement.write. Each .write feature permission must include the matching .read.

Request

POST /role

Headers

Header	Value
`Authorization`	`Bearer <token>` (or HMAC headers, see Authentication)
`Content-Type`	`application/json`

Request Body

Field	Type	Required	Description
`name`	string	Yes	`{customer}.{Name}` (spaces in the name part are stripped). Must not start with `Makaira.` or contain `--` / `__`.
`description`	string	No	Description.
`permissions`	array	No	Feature permission identifiers (dot notation).

Example Request

{
  "name": "stage.Editor",
  "description": "Can edit pages",
  "permissions": ["pageeditor.read", "pageeditor.write"]
}

Response

{
  "role": {
    "id": "rol_newrole123",
    "name": "stage.Editor",
    "description": "Can edit pages"
  },
  "updated": true
}