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

# Update permissions for a specific role

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

Updates the permissions for a specific role within an organization.

## Path parameters

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

## Request body

- RolePermissionsUpdateSchema
  - `category` string, required — Category of permissions being updated.
  - `permission_list` object, required — Object where keys are permission names and values are boolean indicating whether the permission is granted.

## Response `200`

Permissions updated successfully

- RolePermissionsUpdateResponseSchema
  - `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)