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

# Changes to Read Role

`GET /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`: 3 breaking, 5 warning, 2 info
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 6 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`: 3 breaking, 5 warning, 2 info
  - response property `external_roles` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `policies/items/effect` response's property type changed from no type to `string` for status `200`
  - the `sync_mode` response's property type changed from no type to `string` for status `200`
  - added the new `Allow` enum value to the `policies/items/effect` response property for the response status `200`
  - added the new `Deny` enum value to the `policies/items/effect` response property for the response status `200`
  - added the new `force` enum value to the `sync_mode` response property for the response status `200`
  - added the new `ignore` enum value to the `sync_mode` response property for the response status `200`
  - added the new `import` enum value to the `sync_mode` response property for the response status `200`
  - removed `#/components/schemas/PolicyEffect` from the `policies/items/effect` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/SyncMode` from the `sync_mode` response property `allOf` list for the response status `200`
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 6 info
  - the response's body type changed from `string` to `object` for status `200`
  - added the optional property `external_roles` to the response with the `200` status
  - added the optional property `immutable` to the response with the `200` status
  - added the optional property `sync_mode` to the response with the `200` status
  - added the required property `description` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `policies` to the response with the `200` status

---

[Operation](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/docs/api/configs/role/:name/get.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/get)