---
title: "Changes to Get Roles"
method: GET
path: "/v1/admin/roles"
---

# Changes to Get Roles

`GET /v1/admin/roles`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-08-20** `0db3023472ef`: 1 info
- **2026-05-23** `d3e7e6dcdd41`: 1 info
- **2026-04-30** `d5f1d3d5614e`: 1 breaking, 2 warning, 11 info
- **2026-03-04** `46bc88767a37`: 7 breaking, 2 warning, 6 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-08-20** `0db3023472ef`: 1 info
  - removed the `create_public_collection` enum value from the `data/items/permissions/items/` response property for the response status `200`
- **2026-05-23** `d3e7e6dcdd41`: 1 info
  - added the non-success response with the status `403`
- **2026-04-30** `d5f1d3d5614e`: 1 breaking, 2 warning, 11 info
  - removed the required property `data/items/limits/items/router` from the response with the `200` status
  - deleted the `query` request parameter `order_by`
  - deleted the `query` request parameter `order_direction`
  - added the new optional `query` request parameter `sort_by`
  - added the new optional `query` request parameter `sort_order`
  - added the non-success response with the status `401`
  - the response property `data/items/created` became required for the status `200`
  - the response property `data/items/updated` became required for the status `200`
  - the response property `data/items/users` became required for the status `200`
  - the `users` response's property default value `0` was removed for the status `200`
  - added the required property `data/items/limits/items/router_id` to the response with the `200` status
  - added the required property `limit` to the response with the `200` status
  - added the required property `offset` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
- **2026-03-04** `46bc88767a37`: 7 breaking, 2 warning, 6 info
  - the response property `data/items/created` became optional for the status `200`
  - the response property `data/items/updated` became optional for the status `200`
  - the response property `data/items/users` became optional for the status `200`
  - removed the required property `data/items/limits/items/router_id` from the response with the `200` status
  - removed the required property `limit` from the response with the `200` status
  - removed the required property `offset` from the response with the `200` status
  - removed the required property `total` from the response with the `200` status
  - deleted the `query` request parameter `sort_by`
  - deleted the `query` request parameter `sort_order`
  - added the new optional `query` request parameter `order_by`
  - added the new optional `query` request parameter `order_direction`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - the `users` response's property default value `0` was added for the status `200`
  - added the required property `data/items/limits/items/router` to the response with the `200` status

---

[Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/admin/roles/get.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/admin/roles/get)