Update a role

Updates a custom role. Requires Role Manager and role:write or usermanagement.write. Default Makaira.* roles cannot be updated (updated is false and role is null).

Request

PUT /role/{roleId}

Path Parameters

Parameter	Type	Required	Description
`roleId`	string	Yes	Auth0 role ID.

Headers

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

Request Body

Field	Type	Required	Description
`name`	string	No	`{customer}.{Name}` with the same naming rules as create.
`description`	string	No	Description.
`permissions`	array	No	Replacement list of feature permissions.

Example Request

{
  "name": "stage.SeniorEditor",
  "permissions": ["pageeditor.read", "pageeditor.write", "banner.read"]
}

Response

{
  "role": {
    "id": "rol_abc123",
    "name": "stage.SeniorEditor",
    "description": "Can edit pages",
    "permissions": ["pageeditor.read", "pageeditor.write", "banner.read"]
  },
  "updated": true
}