# Update a role

`POST https://testing-backend.estactics.com/api/permissionsRoles/update`

Changes the name or description of a role. Always send `name`.

Authentication: `Authorization: Bearer YOUR_API_KEY`. Required permission: `permissionsRoles.MANAGE_ORG_ROLES`.

## Body parameters

- `id` (integer, required): ID of the role.
- `name` (string, required): Role name.
- `description` (string): What the role is for.

## Example request body

```json
{
  "id": 5,
  "name": "Viewer",
  "description": "Can read everything."
}
```