---
title: "Changes to Search Users"
method: POST
path: "/Users/.search"
---

# Changes to Search Users

`POST /Users/.search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-07-17** `7978594f207e`: 5 breaking
- **2025-08-14** `d290ee2c70fc`: 3 breaking, 2 info

## Changes

- **2026-07-17** `7978594f207e`: 5 breaking
  - the request property `schemas` became required
  - response property `Resources/items/emails/items/` list-of-types was widened by adding types `string` to media type `application/scim+json` of response `200`
  - the `Resources/items/roles` response's property type changed from `object` to `array` for status `200`
  - the `Resources/items/schemas` response's property type changed from `object` to `array` for status `200`
  - the `schemas` response's property type changed from `object` to `array` for status `200`
- **2025-08-14** `d290ee2c70fc`: 3 breaking, 2 info
  - the `Resources/items/roles` response's property type changed from `array` to `object` for status `200`
  - the `Resources/items/schemas` response's property type changed from `array` to `object` for status `200`
  - the `schemas` response's property type changed from `array` to `object` for status `200`
  - the request property `schemas` became optional
  - response property `Resources/items/emails/items/` list-of-types was narrowed by removing types `string` from media type `application/scim+json` of response `200`

---

[Operation](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/docs/Users/.search/post.md) - [API](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api.md) - [Page](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/changes/Users/.search/post)