---
title: "Changes to Put Role"
method: PUT
path: "/api/configs/role/{name}"
---

# Changes to Put Role

`PUT /api/configs/role/{name}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-08-03** `b9d312a13f5d`: 2 info
- **2026-04-08** `a8157dc3279d`: 4 breaking, 2 warning, 10 info
- **2026-02-27** `3b4b243276b5`: 1 breaking, 3 warning, 4 info

## Changes

- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 4 breaking, 2 warning, 10 info
  - request property `configs/policies/items/effect` was restricted to a list of enum values
  - request property `configs/sync_mode` was restricted to a list of enum values
  - the `configs/policies/items/effect` request property type changed from no type to `string`
  - the `configs/sync_mode` request property type changed from no type to `string`
  - removed `#/components/schemas/PolicyEffect` from the `configs/policies/items/effect` request property `allOf` list
  - removed `#/components/schemas/SyncMode` from the `configs/sync_mode` request property `allOf` list
  - `header` request parameter `x-osmo-user` list-of-types was widened by adding types `null`
  - for the `header` request parameter `x-osmo-user`, the type was generalized from `string` to no type
  - added the new `Allow` enum value to the request property `configs/policies/items/effect`
  - added the new `Deny` enum value to the request property `configs/policies/items/effect`
  - added the new `force` enum value to the request property `configs/sync_mode`
  - added the new `ignore` enum value to the request property `configs/sync_mode`
  - added the new `import` enum value to the request property `configs/sync_mode`
  - request property `configs/external_roles` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `description` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `tags` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-02-27** `3b4b243276b5`: 1 breaking, 3 warning, 4 info
  - the `configs/policies/items/actions/items/` request property type changed from `object` to `string`
  - removed the request property `configs/policies/items/actions/items/base`
  - removed the request property `configs/policies/items/actions/items/method`
  - removed the request property `configs/policies/items/actions/items/path`
  - added the new optional request property `configs/external_roles`
  - added the new optional request property `configs/policies/items/effect`
  - added the new optional request property `configs/policies/items/resources`
  - added the new optional request property `configs/sync_mode`

---

[Operation](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/docs/api/configs/role/:name/put.md) - [API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [Page](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/configs/role/:name/put)