---
title: "Update role"
method: PUT
path: "/orgs/{organization}/roles/{role}"
tags: ["Roles"]
---

# Update role

`PUT /orgs/{organization}/roles/{role}`

Update a role for the organization.

Processing mode: <small><code>sync</code></small>

## Path parameters

- `organization` string, required
- `role` integer, required

## Request body

- object
  - `name` string, required
  - `permissions` Permission[]
  - `description` string

## Response `200`

`CustomRoleResource`

## Other responses

- `403` — Authorization error
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/mfullbrook/apis/forge.md) · [All operations](https://skmtc.net/mfullbrook/apis/forge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/forge/revisions/24ad66d99f93/schema)