---
title: "Changes to Update an existing custom role"
method: PUT
path: "/api/roles/{name}"
---

# Changes to Update an existing custom role

`PUT /api/roles/{name}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-10-10** `a142cbe9d486`: 4 breaking, 2 info

## Changes

- **2026-10-10** `a142cbe9d486`: 4 breaking, 2 info
  - the request's body type changed from no type to `object`
  - the `permissions` request property's minItems was increased to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - added the pattern `^[A-Z][A-Z0-9_]*$` to the request property `name`
  - the request property `name` became optional
  - the request property `permissions` became optional

---

[Operation](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/docs/api/roles/:name/put.md) - [API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) - [Page](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/changes/api/roles/:name/put)