---
title: "Changes to Search Cohort Users"
method: POST
path: "/api/v1/role-mining/suggestions/{suggestion_id}/users"
---

# Changes to Search Cohort Users

`POST /api/v1/role-mining/suggestions/{suggestion_id}/users`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 34 revisions.

- **2026-09-01** `f76d07868c0c` — 2 info
- **2026-08-21** `f2cf3228f366` — 9 breaking, 32 warning, 9 info
- **2026-05-15** `f6e337c979e4` — 2 info
- **2026-04-30** `fa2bb307d6fa` — 1 info

## Changes

- **2026-09-01** `f76d07868c0c` — 2 info
  - request property `selectedEntitlements` deprecated
  - response property `usersWithCoverage` deprecated
- **2026-08-21** `f2cf3228f366` — 9 breaking, 32 warning, 9 info
  - the request property `profileFilters` became not nullable
  - the request property `profileFilters/items/values` became not nullable
  - the request property `selectedEntitlements` became not nullable
  - the response property `list/items/createdAt` became nullable for the status `200`
  - the response property `list/items/deletedAt` became nullable for the status `200`
  - the response property `list/items/profile` became nullable for the status `200`
  - the response property `list/items/updatedAt` became nullable for the status `200`
  - added `#/components/schemas/c1.api.user.v1.User, subschema #2` to the `usersWithCoverage/items/user` response property `oneOf` list for the response status `200`
  - the `usersWithCoverage/items/user` response's property type changed from `object` to no type for status `200`
  - removed the optional property `usersWithCoverage/items/user/createdAt` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/delegatedUserId` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/deletedAt` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/department` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/departmentSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/directoryIds` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/directoryStatus` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/directoryStatusSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/displayName` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/email` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/emailSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/emails` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employeeIdSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employeeIds` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employmentStatus` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employmentStatusSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employmentType` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/employmentTypeSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/id` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/jobTitle` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/jobTitleSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/managerIds` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/managerSources` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/origin` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/profile` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/roleIds` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/status` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/type` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/updatedAt` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/username` from the response with the `200` status
  - removed the optional property `usersWithCoverage/items/user/usernameSources` from the response with the `200` status
  - …10 more
- **2026-05-15** `f6e337c979e4` — 2 info
  - added the new optional request property `selectedEntitlements`
  - added the optional property `usersWithCoverage` to the response with the `200` status
- **2026-04-30** `fa2bb307d6fa` — 1 info
  - endpoint added

---

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