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

# Changes to Search Grants

`POST /api/v1/search/grants`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 36 revisions.

- **2026-08-21** `f2cf3228f366`: 12 breaking, 11 warning, 1 info
- **2026-05-15** `f6e337c979e4`: 1 info
- **2026-04-30** `fa2bb307d6fa`: 2 info
- **2026-03-10** `7fa698b04b81`: 2 info
- **2026-02-05** `417c5bf9b0a2`: 1 warning, 3 info
- **2025-11-12** `6f49a3969499`: 2 info
- **2025-10-17** `964bf86d9be5`: 2 info
- **2025-08-20** `182cb087dfa4`: 1 info
- **2025-06-24** `f5a989bebcdb`: 2 info
- **2025-05-07** `112d28188277`: 1 info

## Changes

- **2026-08-21** `f2cf3228f366`: 12 breaking, 11 warning, 1 info
  - the request property `appIds` became not nullable
  - the request property `appUserIds` became not nullable
  - the request property `entitlementRefs` became not nullable
  - the request property `entitlementSlugs` became not nullable
  - the request property `purpose` became not nullable
  - the request property `resourceIds` became not nullable
  - the request property `resourceTypeIds` became not nullable
  - the `expandMask` request property type changed from `object` to no type
  - added `#/components/schemas/c1.api.app.v1.AppEntitlementUserView, subschema #2` to the `list/items/appEntitlementUserBinding` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/c1.api.app.v1.AppEntitlementView, subschema #2` to the `list/items/entitlement` response property `oneOf` list for the response status `200`
  - the `list/items/appEntitlementUserBinding` response's property type changed from `object` to no type for status `200`
  - the `list/items/entitlement` 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/appEntitlementUserBinding/appEntitlementUserBindingCreatedAt` from the response with the `200` status
  - removed the optional property `list/items/appEntitlementUserBinding/appEntitlementUserBindingDeprovisionAt` from the response with the `200` status
  - removed the optional property `list/items/appEntitlementUserBinding/appUser` from the response with the `200` status
  - removed the optional property `list/items/appEntitlementUserBinding/grantSources` from the response with the `200` status
  - removed the optional property `list/items/appEntitlementUserBinding/originatingTicketId` from the response with the `200` status
  - removed the optional property `list/items/entitlement/appEntitlement` from the response with the `200` status
  - removed the optional property `list/items/entitlement/appPath` from the response with the `200` status
  - removed the optional property `list/items/entitlement/appResourcePath` from the response with the `200` status
  - removed the optional property `list/items/entitlement/appResourceTypePath` from the response with the `200` status
  - removed the optional property `list/items/entitlement/objectPermissions` from the response with the `200` status
  - added `#/components/schemas/c1.api.app.v1.AppEntitlementExpandMask, subschema #2` to the `expandMask` request property `oneOf` list
- **2026-05-15** `f6e337c979e4`: 1 info
  - added the optional property `list/items/entitlement/appEntitlement/annotations` to the response with the `200` status
- **2026-04-30** `fa2bb307d6fa`: 2 info
  - added the new optional request property `entitlementSlugs`
  - added the optional property `list/items/entitlement/appEntitlement/externalId` to the response with the `200` status
- **2026-03-10** `7fa698b04b81`: 2 info
  - added the optional property `list/items/entitlement/appEntitlement/deprovisionerPolicy/manual/assignee` to the response with the `200` status
  - added the optional property `list/items/entitlement/appEntitlement/provisionerPolicy/manual/assignee` to the response with the `200` status
- **2026-02-05** `417c5bf9b0a2`: 1 warning, 3 info
  - added the new `APP_ENTITLEMENT_PURPOSE_VALUE_OWNERSHIP` enum value to the `list/items/entitlement/appEntitlement/purpose` response property for the response status `200`
  - added the new optional request property `purpose`
  - added the optional property `list/items/appEntitlementUserBinding/originatingTicketId` to the response with the `200` status
  - added the optional property `list/items/entitlement/objectPermissions` to the response with the `200` status
- **2025-11-12** `6f49a3969499`: 2 info
  - added the optional property `list/items/entitlement/appEntitlement/deprovisionerPolicy/action/displayName` to the response with the `200` status
  - added the optional property `list/items/entitlement/appEntitlement/provisionerPolicy/action/displayName` to the response with the `200` status
- **2025-10-17** `964bf86d9be5`: 2 info
  - added the optional property `list/items/entitlement/appEntitlement/deprovisionerPolicy/action` to the response with the `200` status
  - added the optional property `list/items/entitlement/appEntitlement/provisionerPolicy/action` to the response with the `200` status
- **2025-08-20** `182cb087dfa4`: 1 info
  - added the optional property `list/items/entitlement/appEntitlement/requestSchemaId` to the response with the `200` status
- **2025-06-24** `f5a989bebcdb`: 2 info
  - added the optional property `list/items/entitlement/appEntitlement/deprovisionerPolicy/connector/deleteAccount` to the response with the `200` status
  - added the optional property `list/items/entitlement/appEntitlement/provisionerPolicy/connector/deleteAccount` to the response with the `200` status
- **2025-05-07** `112d28188277`: 1 info
  - endpoint added

---

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