---
title: "Changes to Search for users by a given filter"
method: POST
path: "/users/search"
---

# Changes to Search for users by a given filter

`POST /users/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 63 revisions.

- **2026-11-01** `8522e66913b4`: 5 info
- **2026-10-27** `69a0bee18b33`: 1 info
- **2026-10-11** `dfb481067e5a`: 4 breaking, 105 info
- **2026-09-17** `fcfd7a1bd7b4`: 1 breaking, 3 warning, 5 info
- **2026-09-12** `e85c0a2a3253`: 4 info
- **2026-09-10** `8a1a71062385`: 3 info
- **2026-08-28** `fe3adb90ea45`: 1 info
- **2026-08-18** `b387b041ea8e`: 1 info
- **2026-08-14** `ad855d921ee9`: 4 warning
- **2026-08-12** `4e84bb73bb7d`: 1 info

## Changes

- **2026-11-01** `8522e66913b4`: 5 info
  - added the new `not` enum value to the request property `filter/operator`
  - added the new `time_is_in_last` enum value to the request property `filter/operator`
  - added the new `time_is_in_next` enum value to the request property `filter/operator`
  - added the new `time_is_not_in_last` enum value to the request property `filter/operator`
  - added the new `time_is_not_in_next` enum value to the request property `filter/operator`
- **2026-10-27** `69a0bee18b33`: 1 info
  - added the optional property `data/items/skills` to the response with the `200` status
- **2026-10-11** `dfb481067e5a`: 4 breaking, 105 info
  - the response property `data/items/emails` became nullable for the status `200`
  - the response property `data/items/role` became nullable for the status `200`
  - the response property `data/items/role_ids` became nullable for the status `200`
  - the response property `data/items/roles` became nullable for the status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - the response property `data` became required for the status `200`
  - the response property `data/items/avatar_url` became required for the status `200`
  - the response property `data/items/email` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/is_deactivated` became required for the status `200`
  - the response property `data/items/name` became required for the status `200`
  - the response property `data/items/role/allOf[#/components/schemas/MiniRole]/id` became required for the status `200`
  - the response property `data/items/role/allOf[#/components/schemas/MiniRole]/name` became required for the status `200`
  - the response property `data/items/role/allOf[#/components/schemas/MiniRole]/slug` became required for the status `200`
  - the response property `data/items/role_id` became required for the status `200`
  - the response property `data/items/roles/items/id` became required for the status `200`
  - the response property `data/items/roles/items/name` became required for the status `200`
  - the response property `data/items/roles/items/slug` became required for the status `200`
  - the response property `data/items/status` became required for the status `200`
  - the response property `request_id` became required for the status `200`
  - the response property `request_id` became required for the status `400`
  - the response property `request_id` became required for the status `403`
  - the response property `request_id` became required for the status `404`
  - the response property `request_id` became required for the status `500`
  - removed the `` enum value from the `data/items/status` response property for the response status `200`
  - removed the `active` enum value from the `data/items/status` response property for the response status `200`
  - removed the `away` enum value from the `data/items/status` response property for the response status `200`
  - removed the `duplicate_object` enum value from the `code` response property for the response status `400`
  - removed the `duplicate_object` enum value from the `code` response property for the response status `403`
  - removed the `duplicate_object` enum value from the `code` response property for the response status `404`
  - removed the `duplicate_object` enum value from the `code` response property for the response status `500`
  - removed the `email_bounced` enum value from the `code` response property for the response status `400`
  - removed the `email_bounced` enum value from the `code` response property for the response status `403`
  - removed the `email_bounced` enum value from the `code` response property for the response status `404`
  - removed the `email_bounced` enum value from the `code` response property for the response status `500`
  - removed the `internal_error` enum value from the `code` response property for the response status `400`
  - removed the `internal_error` enum value from the `code` response property for the response status `403`
  - removed the `internal_error` enum value from the `code` response property for the response status `404`
  - removed the `internal_error` enum value from the `code` response property for the response status `500`
  - …69 more
- **2026-09-17** `fcfd7a1bd7b4`: 1 breaking, 3 warning, 5 info
  - the `data/items/role` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/items/role/id` from the response with the `200` status
  - removed the optional property `data/items/role/name` from the response with the `200` status
  - removed the optional property `data/items/role/slug` from the response with the `200` status
  - added the optional property `data/items/role_ids` to the response with the `200` status
  - added the optional property `data/items/roles` to the response with the `200` status
  - added `#/components/schemas/MiniRole` to the `data/items/role` response property `allOf` list for the response status `200`
  - response property `data/items/role` deprecated
  - response property `data/items/role_id` deprecated
- **2026-09-12** `e85c0a2a3253`: 4 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-09-10** `8a1a71062385`: 3 info
  - added the new `ends_with` enum value to the request property `filter/operator`
  - added the new `includes_all_of` enum value to the request property `filter/operator`
  - added the new `starts_with` enum value to the request property `filter/operator`
- **2026-08-28** `fe3adb90ea45`: 1 info
  - added the non-success response with the status `403`
- **2026-08-18** `b387b041ea8e`: 1 info
  - the request property `filter/field` became optional
- **2026-08-14** `ad855d921ee9`: 4 warning
  - added the new `` enum value to the `data/items/status` response property for the response status `200`
  - added the new `active` enum value to the `data/items/status` response property for the response status `200`
  - added the new `away` enum value to the `data/items/status` response property for the response status `200`
  - added the new `out_of_office` enum value to the `data/items/status` response property for the response status `200`
- **2026-08-12** `4e84bb73bb7d`: 1 info
  - added the optional property `data/items/is_deactivated` to the response with the `200` status

---

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