---
title: "Changes to Get Users"
method: GET
path: "/v1/admin/users"
---

# Changes to Get Users

`GET /v1/admin/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-09-21** `5fdbd3614b8c`: 2 info
- **2026-08-27** `1627e468291c`: 1 breaking, 1 info
- **2026-07-11** `0fd1d281f985`: 1 warning, 1 info
- **2026-06-12** `0c595f53fc63`: 1 breaking, 4 warning, 11 info
- **2026-03-04** `46bc88767a37`: 5 breaking, 5 warning, 6 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 2 info
  - the response property `data/items/organization_id` became required for the status `200`
  - response property `data/items/organization_id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-08-27** `1627e468291c`: 1 breaking, 1 info
  - removed the required property `data/items/role` from the response with the `200` status
  - added the required property `data/items/role_id` to the response with the `200` status
- **2026-07-11** `0fd1d281f985`: 1 warning, 1 info
  - removed the optional property `data/items/organization` from the response with the `200` status
  - added the optional property `data/items/organization_id` to the response with the `200` status
- **2026-06-12** `0c595f53fc63`: 1 breaking, 4 warning, 11 info
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `query` request parameter `order_by`
  - deleted the `query` request parameter `order_direction`
  - deleted the `query` request parameter `organization`
  - deleted the `query` request parameter `role`
  - added the new optional `query` request parameter `organization_id`
  - added the new optional `query` request parameter `role_id`
  - 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`
  - added the non-success response with the status `403`
  - added the optional property `object` to the response with the `200` status
  - added the required property `data` 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`: 5 breaking, 5 warning, 6 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `data` 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 `organization_id`
  - deleted the `query` request parameter `role_id`
  - deleted the `query` request parameter `sort_by`
  - deleted the `query` request parameter `sort_order`
  - removed the optional property `object` from the response with the `200` status
  - added the new optional `query` request parameter `order_by`
  - added the new optional `query` request parameter `order_direction`
  - added the new optional `query` request parameter `organization`
  - added the new optional `query` request parameter `role`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`

---

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