---
title: "Update role"
method: PUT
path: "/tenants/{tenant_id}/roles/{role_id}"
tags: ["Roles"]
---

# Update role

`PUT /tenants/{tenant_id}/roles/{role_id}`

Updates a custom role's name or permissions tree. System roles cannot be modified.

## Path parameters

- `tenant_id` integer, required
- `role_id` integer, required

## Request body

- UpdateRole
  - `name` string
  - `permissions` RolePermissions
    - `division` string[], nullable
    - `divisions` object, nullable
    - `environment` string[], nullable
    - `tenant` string[], nullable

## Response `204`

Role updated

## Other responses

- `400` — Invalid name or permissions
- `403` — Cannot modify system role or insufficient permissions
- `404` — Role not found

---

[API](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api.md) · [All operations](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/laserdata/laserdata-cloud-core-api/revisions/db81a447bba9/schema)