---
title: "Update a specific organization role"
method: PATCH
path: "/organisations/{org_id}/roles/{role_id}"
tags: ["roles"]
---

# Update a specific organization role

`PATCH /organisations/{org_id}/roles/{role_id}`

Updates the details of a specific role within an organization.

## Path parameters

- `org_id` string, uuid, required
- `role_id` string, uuid, required

## Request body

- OrgRoleUpdateSchema
  - `name` string, required — Updated name of the role.
  - `description` string, required — Updated description of the role.

## Response `200`

Role updated successfully

- OrgRoleUpdateResponseSchema
  - `status` string
  - `status_code` integer
  - `message` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Validation error

---

[API](https://skmtc.net/hngprojects/apis/kimiko-golang-swagger.md) · [All operations](https://skmtc.net/hngprojects/apis/kimiko-golang-swagger/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hngprojects/kimiko-golang-swagger/revisions/2d1d3ed96bb9/schema)