--- title: "Changes to Update" method: POST path: "/api/v1/policies/{id}" --- # Changes to Update `POST /api/v1/policies/{id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 19 of 36 revisions. - **2026-10-20** `fe943bedf41b`: 2 info - **2026-10-06** `918a4e749f56`: 2 info - **2026-08-21** `f2cf3228f366`: 4 breaking, 21 warning, 1 info - **2026-05-15** `f6e337c979e4`: 4 info - **2026-04-30** `fa2bb307d6fa`: 6 info - **2026-03-10** `7fa698b04b81`: 2 info - **2026-02-05** `417c5bf9b0a2`: 46 info - **2025-12-05** `db31ee81cba5`: 4 info - **2025-11-12** `6f49a3969499`: 18 info - **2025-10-17** `964bf86d9be5`: 4 info - **2025-09-19** `ee097034afbe`: 6 info - **2025-09-08** `d8ad3d78289e`: 4 info - **2025-08-20** `182cb087dfa4`: 2 warning, 2 info - **2025-08-06** `e09d811ca082`: 10 info - **2025-06-24** `f5a989bebcdb`: 2 info - **2025-05-30** `d5c56e8615fe`: 6 info - **2025-05-07** `112d28188277`: 8 info - **2025-04-21** `967857a504a0`: 2 info - **2025-04-10** `17f9f3bcedd5`: 1 info ## Changes - **2026-10-20** `fe943bedf41b`: 2 info - added the new optional request property `policy/oneOf[subschema #1: Policy]/policySteps/additionalProperties/steps/items/approval/oneOf[subschema #1: Approval]/accessProfileOwners` - added the optional property `policy/oneOf[subschema #1: Policy]/policySteps/additionalProperties/steps/items/approval/oneOf[subschema #1: Approval]/accessProfileOwners` to the response with the `200` status - **2026-10-06** `918a4e749f56`: 2 info - added the new optional request property `policy/oneOf[subschema #1: Policy]/policySteps/additionalProperties/steps/items/form/oneOf[subschema #1: Form]/form/oneOf[subschema #1: Form]/fields/items/stringField/oneOf[subschema #1: String Field]/passwordField/oneOf[subschema #1: Password Field]/multiline` - added the optional property `policy/oneOf[subschema #1: Policy]/policySteps/additionalProperties/steps/items/form/oneOf[subschema #1: Form]/form/oneOf[subschema #1: Form]/fields/items/stringField/oneOf[subschema #1: String Field]/passwordField/oneOf[subschema #1: Password Field]/multiline` to the response with the `200` status - **2026-08-21** `f2cf3228f366`: 4 breaking, 21 warning, 1 info - the request property `updateMask` became not nullable - the `policy` request property type changed from `object` to no type - added `#/components/schemas/c1.api.policy.v1.Policy, subschema #2` to the `policy` response property `oneOf` list for the response status `200` - the `policy` response's property type changed from `object` to no type for status `200` - removed the request property `policy/annotations` - removed the request property `policy/description` - removed the request property `policy/displayName` - removed the request property `policy/policySteps` - removed the request property `policy/policyType` - removed the request property `policy/postActions` - removed the request property `policy/reassignTasksToDelegates` - removed the request property `policy/rules` - removed the optional property `policy/annotations` from the response with the `200` status - removed the optional property `policy/createdAt` from the response with the `200` status - removed the optional property `policy/deletedAt` from the response with the `200` status - removed the optional property `policy/description` from the response with the `200` status - removed the optional property `policy/displayName` from the response with the `200` status - removed the optional property `policy/id` from the response with the `200` status - removed the optional property `policy/policySteps` from the response with the `200` status - removed the optional property `policy/policyType` from the response with the `200` status - removed the optional property `policy/postActions` from the response with the `200` status - removed the optional property `policy/reassignTasksToDelegates` from the response with the `200` status - removed the optional property `policy/rules` from the response with the `200` status - removed the optional property `policy/systemBuiltin` from the response with the `200` status - removed the optional property `policy/updatedAt` from the response with the `200` status - added `#/components/schemas/c1.api.policy.v1.Policy, subschema #2` to the `policy` request property `oneOf` list - **2026-05-15** `f6e337c979e4`: 4 info - added the new optional request property `policy/annotations` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/readOnly` - added the optional property `policy/annotations` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/readOnly` to the response with the `200` status - **2026-04-30** `fa2bb307d6fa`: 6 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/action/clientIdApproval` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/textField/suffix` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringMapField` - added the optional property `policy/policySteps/additionalProperties/steps/items/action/clientIdApproval` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/textField/suffix` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringMapField` to the response with the `200` status - **2026-03-10** `7fa698b04b81`: 2 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/manual/assignee` - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/manual/assignee` to the response with the `200` status - **2026-02-05** `417c5bf9b0a2`: 46 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/action/batonResourceAction` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/escalation/cancelTicket` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/escalation/skipStep` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/expression/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/expression/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/manager/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/manager/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/self/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/self/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fieldRelationships/items/dependentOn` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/adminConfig` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/boolField/toggleField` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/required` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/sharedConfig` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/pickerField` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField/options/items/description` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField/type` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringSliceField/pickerField` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/userConfig` - added the optional property `policy/policySteps/additionalProperties/steps/items/action/batonResourceAction` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/escalation/cancelTicket` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/escalation/skipStep` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/expression/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/expression/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/manager/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/manager/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/self/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/self/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fieldRelationships/items/dependentOn` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/adminConfig` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/boolField/toggleField` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/required` to the response with the `200` status - …6 more - **2025-12-05** `db31ee81cba5`: 4 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fieldGroups` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/oauth2Field` - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fieldGroups` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/oauth2Field` to the response with the `200` status - **2025-11-12** `6f49a3969499`: 18 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/action` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/appOwners/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/expression/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/group/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/manager/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/users/requireDistinctApprovers` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/action/displayName` - added the optional property `policy/policySteps/additionalProperties/steps/items/action` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/appOwners/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/entitlementOwners/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/expression/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/group/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/manager/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/resourceOwners/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/users/requireDistinctApprovers` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/action/displayName` to the response with the `200` status - **2025-10-17** `964bf86d9be5`: 4 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/fileField` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/action` - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/fileField` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/action` to the response with the `200` status - **2025-09-19** `ee097034afbe`: 6 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/group/fallbackGroupIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/group/isGroupFallbackEnabled` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField` - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/group/fallbackGroupIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/group/isGroupFallbackEnabled` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField` to the response with the `200` status - **2025-09-08** `d8ad3d78289e`: 4 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/wait/duration` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/wait/untilTime` - added the optional property `policy/policySteps/additionalProperties/steps/items/wait/duration` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/wait/untilTime` to the response with the `200` status - **2025-08-20** `182cb087dfa4`: 2 warning, 2 info - removed the request property `policy/policySteps/additionalProperties/steps/items/form/form/tenantId` - removed the optional property `policy/policySteps/additionalProperties/steps/items/form/form/tenantId` from the response with the `200` status - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/int64Field` - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/int64Field` to the response with the `200` status - **2025-08-06** `e09d811ca082`: 10 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/agent/agentFailureAction` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/agent/reassignToUserIds` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/allowDelegation` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/form` - request property `policy/reassignTasksToDelegates` deprecated - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/agentFailureAction` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/reassignToUserIds` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/allowDelegation` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/form` to the response with the `200` status - response property `policy/reassignTasksToDelegates` deprecated - **2025-06-24** `f5a989bebcdb`: 2 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/deleteAccount` - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/deleteAccount` to the response with the `200` status - **2025-05-30** `d5c56e8615fe`: 6 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/agent/agentMode` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/escalation` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/escalationEnabled` - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/agentMode` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/escalation` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/escalationEnabled` to the response with the `200` status - **2025-05-07** `112d28188277`: 8 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/allowedReassignees` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/doNotSave` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/saveToVault` - added the new optional request property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/unconfigured` - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/allowedReassignees` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/doNotSave` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/saveToVault` to the response with the `200` status - added the optional property `policy/policySteps/additionalProperties/steps/items/provision/provisionPolicy/unconfigured` to the response with the `200` status - **2025-04-21** `967857a504a0`: 2 info - added the new optional request property `policy/policySteps/additionalProperties/steps/items/approval/agent/policyIds` - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/policyIds` to the response with the `200` status - **2025-04-10** `17f9f3bcedd5`: 1 info - endpoint added --- [Operation](https://skmtc.dev/conductorone/apis/c1-api/docs/api/v1/policies/:id/post.md) - [API](https://skmtc.dev/conductorone/apis/c1-api.md) - [Page](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/policies/:id/post)