---
title: "Update an existing role"
method: PATCH
path: "/v1/org/{orgId}/role/{roleId}"
tags: ["role"]
---

# Update an existing role

`PATCH /v1/org/{orgId}/role/{roleId}`

## Path parameters

- `orgId` string, required
- `roleId` string, required

## Request body

- UpdateRole
  - `label` string — human-readable full name of role
  - `description` string — description of role
  - `policyIds` string[] — the policies that define the role

## Response `204`

role updated

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

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