---
title: "Changes to Search for users"
method: POST
path: "/users/search"
---

# Changes to Search for users

`POST /users/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 75 revisions.

- **2026-10-15** `00f3e37c4d30`: 1 info
- **2023-09-27** `7400aae8fd5c`: 1 breaking
- **2023-09-21** `ea23baac3b30`: 1 info
- **2023-09-20** `8ff141936638`: 1 breaking
- **2023-08-15** `44fbe9f14200`: 3 info
- **2023-08-04** `9f4851dfc828`: 1 breaking, 2 warning
- **2023-03-06** `7de0ab0187e0`: 1 info
- **2023-03-06** `3d206bb302b3`: 1 info
- **2023-02-28** `04020a819bc0`: 1 info
- **2022-09-21** `bdd22064f19e`: 1 info
- **2022-09-20** `eea125543546`: 1 info
- **2022-03-08** `9f5c8bbfe0ed`: 1 info

## Changes

- **2026-10-15** `00f3e37c4d30`: 1 info
  - added the optional property `data/items/userGroups` to the response with the `200` status
- **2023-09-27** `7400aae8fd5c`: 1 breaking
  - the response property `data/items/roles` became optional for the status `200`
- **2023-09-21** `ea23baac3b30`: 1 info
  - the response property `data/items/roles` became required for the status `200`
- **2023-09-20** `8ff141936638`: 1 breaking
  - the response property `data/items/roles` became optional for the status `200`
- **2023-08-15** `44fbe9f14200`: 3 info
  - added the optional property `data/items/admin` to the response with the `200` status
  - added the optional property `data/items/builder` to the response with the `200` status
  - added the required property `data/items/roles` to the response with the `200` status
- **2023-08-04** `9f4851dfc828`: 1 breaking, 2 warning
  - removed the required property `data/items/roles` from the response with the `200` status
  - removed the optional property `data/items/admin` from the response with the `200` status
  - removed the optional property `data/items/builder` from the response with the `200` status
- **2023-03-06** `7de0ab0187e0`: 1 info
  - api operation id `search` removed and replaced with `userSearch`
- **2023-03-06** `3d206bb302b3`: 1 info
  - api operation id `userSearch` removed and replaced with `search`
- **2023-02-28** `04020a819bc0`: 1 info
  - api operation id `search` removed and replaced with `userSearch`
- **2022-09-21** `bdd22064f19e`: 1 info
  - api operation id `searchUsers` removed and replaced with `search`
- **2022-09-20** `eea125543546`: 1 info
  - api operation id `searchUsers` was added
- **2022-03-08** `9f5c8bbfe0ed`: 1 info
  - added the required property `data/items/_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/budibase/apis/budibase-api/docs/users/search/post.md) - [API](https://skmtc.dev/budibase/apis/budibase-api.md) - [Page](https://skmtc.dev/budibase/apis/budibase-api/changes/users/search/post)