---
title: "Changes to List Roles"
method: GET
path: "/api/configs/role"
---

# Changes to List Roles

`GET /api/configs/role`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-04-08** `a8157dc3279d`: 3 breaking, 5 warning, 2 info
- **2026-03-31** `639e39b0d1eb`: 1 breaking

## Changes

- **2026-04-08** `a8157dc3279d`: 3 breaking, 5 warning, 2 info
  - response property `items/external_roles` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `items/policies/items/effect` response's property type changed from no type to `string` for status `200`
  - the `items/sync_mode` response's property type changed from no type to `string` for status `200`
  - added the new `Allow` enum value to the `items/policies/items/effect` response property for the response status `200`
  - added the new `Deny` enum value to the `items/policies/items/effect` response property for the response status `200`
  - added the new `force` enum value to the `items/sync_mode` response property for the response status `200`
  - added the new `ignore` enum value to the `items/sync_mode` response property for the response status `200`
  - added the new `import` enum value to the `items/sync_mode` response property for the response status `200`
  - removed `#/components/schemas/PolicyEffect` from the `items/policies/items/effect` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/SyncMode` from the `items/sync_mode` response property `allOf` list for the response status `200`
- **2026-03-31** `639e39b0d1eb`: 1 breaking
  - the response's body type changed from `string` to `array` for status `200`

---

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