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

# Changes to Search

`POST /api/v1/search/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 36 revisions.

- **2026-08-21** `f2cf3228f366`: 15 breaking, 33 warning, 4 info
- **2026-03-10** `7fa698b04b81`: 6 info
- **2025-09-19** `528a3253300a`: 3 info
- **2025-05-07** `112d28188277`: 1 info
- **2025-04-10** `17f9f3bcedd5`: 1 breaking, 1 warning, 35 info

## Changes

- **2026-08-21** `f2cf3228f366`: 15 breaking, 33 warning, 4 info
  - the request property `delegatedUserIds` became not nullable
  - the request property `departments` became not nullable
  - the request property `excludeIds` became not nullable
  - the request property `excludeOrigins` became not nullable
  - the request property `excludeTypes` became not nullable
  - the request property `ids` became not nullable
  - the request property `jobTitles` became not nullable
  - the request property `managerIds` became not nullable
  - the request property `origins` became not nullable
  - the request property `refs` became not nullable
  - the request property `roleIds` became not nullable
  - the request property `userStatuses` became not nullable
  - the `expandMask` request property type changed from `object` to no type
  - added `#/components/schemas/c1.api.user.v1.User, subschema #2` to the `list/items/user` response property `oneOf` list for the response status `200`
  - the `list/items/user` response's property type changed from `object` to no type for status `200`
  - removed the request property `expandMask/paths`
  - removed the optional property `list/items/user/createdAt` from the response with the `200` status
  - removed the optional property `list/items/user/delegatedUserId` from the response with the `200` status
  - removed the optional property `list/items/user/deletedAt` from the response with the `200` status
  - removed the optional property `list/items/user/department` from the response with the `200` status
  - removed the optional property `list/items/user/departmentSources` from the response with the `200` status
  - removed the optional property `list/items/user/directoryIds` from the response with the `200` status
  - removed the optional property `list/items/user/directoryStatus` from the response with the `200` status
  - removed the optional property `list/items/user/directoryStatusSources` from the response with the `200` status
  - removed the optional property `list/items/user/displayName` from the response with the `200` status
  - removed the optional property `list/items/user/email` from the response with the `200` status
  - removed the optional property `list/items/user/emailSources` from the response with the `200` status
  - removed the optional property `list/items/user/emails` from the response with the `200` status
  - removed the optional property `list/items/user/employeeIdSources` from the response with the `200` status
  - removed the optional property `list/items/user/employeeIds` from the response with the `200` status
  - removed the optional property `list/items/user/employmentStatus` from the response with the `200` status
  - removed the optional property `list/items/user/employmentStatusSources` from the response with the `200` status
  - removed the optional property `list/items/user/employmentType` from the response with the `200` status
  - removed the optional property `list/items/user/employmentTypeSources` from the response with the `200` status
  - removed the optional property `list/items/user/id` from the response with the `200` status
  - removed the optional property `list/items/user/jobTitle` from the response with the `200` status
  - removed the optional property `list/items/user/jobTitleSources` from the response with the `200` status
  - removed the optional property `list/items/user/managerIds` from the response with the `200` status
  - removed the optional property `list/items/user/managerSources` from the response with the `200` status
  - removed the optional property `list/items/user/origin` from the response with the `200` status
  - …12 more
- **2026-03-10** `7fa698b04b81`: 6 info
  - added the new optional request property `delegateStatus`
  - added the new optional request property `delegatedUserIds`
  - added the new optional request property `excludeOrigins`
  - added the new optional request property `isDelegate`
  - added the new optional request property `origins`
  - added the optional property `list/items/user/origin` to the response with the `200` status
- **2025-09-19** `528a3253300a`: 3 info
  - added the new optional request property `departments`
  - added the new optional request property `jobTitles`
  - added the new optional request property `managerIds`
- **2025-05-07** `112d28188277`: 1 info
  - added the optional property `list/items/user/type` to the response with the `200` status
- **2025-04-10** `17f9f3bcedd5`: 1 breaking, 1 warning, 35 info
  - the `pageSize` request property type changed from `number` to `integer`
  - removed the optional property `notificationToken` from the response with the `200` status
  - api tag `User` added
  - api tag `UserSearch` removed
  - added the new optional request property `email`
  - added the new optional request property `excludeTypes`
  - added the optional property `list/items/user/emailSources` to the response with the `200` status
  - added the optional property `list/items/user/emails` to the response with the `200` status
  - added the optional property `list/items/user/employeeIdSources` to the response with the `200` status
  - added the optional property `list/items/user/employeeIds` to the response with the `200` status
  - added the optional property `list/items/user/profile` to the response with the `200` status
  - added the optional property `list/items/user/username` to the response with the `200` status
  - added the optional property `list/items/user/usernameSources` to the response with the `200` status
  - added the optional property `list/items/user/usernames` to the response with the `200` status
  - the response optional property `list/items/delegatedUserPath` became read-only for the status `200`
  - the response optional property `list/items/directoriesPath` became read-only for the status `200`
  - the response optional property `list/items/managersPath` became read-only for the status `200`
  - the response optional property `list/items/rolesPath` became read-only for the status `200`
  - the response optional property `list/items/user/createdAt` became read-only for the status `200`
  - the response optional property `list/items/user/deletedAt` became read-only for the status `200`
  - the response optional property `list/items/user/department` became read-only for the status `200`
  - the response optional property `list/items/user/departmentSources` became read-only for the status `200`
  - the response optional property `list/items/user/directoryIds` became read-only for the status `200`
  - the response optional property `list/items/user/directoryStatus` became read-only for the status `200`
  - the response optional property `list/items/user/directoryStatusSources` became read-only for the status `200`
  - the response optional property `list/items/user/displayName` became read-only for the status `200`
  - the response optional property `list/items/user/email` became read-only for the status `200`
  - the response optional property `list/items/user/employmentStatus` became read-only for the status `200`
  - the response optional property `list/items/user/employmentStatusSources` became read-only for the status `200`
  - the response optional property `list/items/user/employmentType` became read-only for the status `200`
  - the response optional property `list/items/user/employmentTypeSources` became read-only for the status `200`
  - the response optional property `list/items/user/id` became read-only for the status `200`
  - the response optional property `list/items/user/jobTitle` became read-only for the status `200`
  - the response optional property `list/items/user/jobTitleSources` became read-only for the status `200`
  - the response optional property `list/items/user/managerIds` became read-only for the status `200`
  - the response optional property `list/items/user/managerSources` became read-only for the status `200`
  - the response optional property `list/items/user/updatedAt` became read-only for the status `200`

---

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