--- title: "Changes to Create" method: POST path: "/api/v1/policies" --- # Changes to Create `POST /api/v1/policies` > 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`: 20 breaking, 48 warning, 12 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 breaking, 11 warning, 7 info ## Changes - **2026-10-20** `fe943bedf41b`: 2 info - added the new optional request property `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 `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`: 20 breaking, 48 warning, 12 info - the request property `policySteps/additionalProperties/steps` became not nullable - the request property `policySteps/additionalProperties/steps/items/accept` became not nullable - the request property `policySteps/additionalProperties/steps/items/action` became not nullable - the request property `policySteps/additionalProperties/steps/items/approval` became not nullable - the request property `policySteps/additionalProperties/steps/items/form` became not nullable - the request property `policySteps/additionalProperties/steps/items/provision` became not nullable - the request property `policySteps/additionalProperties/steps/items/reject` became not nullable - the request property `policySteps/additionalProperties/steps/items/wait` became not nullable - the request property `postActions` became not nullable - the request property `postActions/items/certifyRemediateImmediately` became not nullable - the request property `rules` became not nullable - the `policySteps/additionalProperties/steps/items/accept` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/action` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/approval` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/form` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/provision` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/reject` request property type changed from `object` to no type - the `policySteps/additionalProperties/steps/items/wait` 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 `policySteps/additionalProperties/steps/items/accept/acceptMessage` - removed the request property `policySteps/additionalProperties/steps/items/action/automation` - removed the request property `policySteps/additionalProperties/steps/items/action/batonResourceAction` - removed the request property `policySteps/additionalProperties/steps/items/action/clientIdApproval` - removed the request property `policySteps/additionalProperties/steps/items/approval/agent` - removed the request property `policySteps/additionalProperties/steps/items/approval/allowDelegation` - removed the request property `policySteps/additionalProperties/steps/items/approval/allowReassignment` - removed the request property `policySteps/additionalProperties/steps/items/approval/allowedReassignees` - removed the request property `policySteps/additionalProperties/steps/items/approval/appOwners` - removed the request property `policySteps/additionalProperties/steps/items/approval/entitlementOwners` - removed the request property `policySteps/additionalProperties/steps/items/approval/escalation` - removed the request property `policySteps/additionalProperties/steps/items/approval/escalationEnabled` - removed the request property `policySteps/additionalProperties/steps/items/approval/expression` - removed the request property `policySteps/additionalProperties/steps/items/approval/group` - removed the request property `policySteps/additionalProperties/steps/items/approval/manager` - removed the request property `policySteps/additionalProperties/steps/items/approval/requireApprovalReason` - removed the request property `policySteps/additionalProperties/steps/items/approval/requireDenialReason` - removed the request property `policySteps/additionalProperties/steps/items/approval/requireReassignmentReason` - removed the request property `policySteps/additionalProperties/steps/items/approval/requiresStepUpProviderId` - removed the request property `policySteps/additionalProperties/steps/items/approval/resourceOwners` - …40 more - **2026-05-15** `f6e337c979e4`: 4 info - added the new optional request property `annotations` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/action/clientIdApproval` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/textField/suffix` - added the new optional request property `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 `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 `policySteps/additionalProperties/steps/items/action/batonResourceAction` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/entitlementOwners/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/entitlementOwners/isGroupFallbackEnabled` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/escalation/cancelTicket` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/escalation/skipStep` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/expression/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/expression/isGroupFallbackEnabled` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/manager/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/manager/isGroupFallbackEnabled` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/resourceOwners/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/resourceOwners/isGroupFallbackEnabled` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/self/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/self/isGroupFallbackEnabled` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fieldRelationships/items/dependentOn` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/adminConfig` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/boolField/toggleField` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/required` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/sharedConfig` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/pickerField` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField/options/items/description` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/stringField/selectField/type` - added the new optional request property `policySteps/additionalProperties/steps/items/form/form/fields/items/stringSliceField/pickerField` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/form/form/fieldGroups` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/action` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/appOwners/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/entitlementOwners/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/expression/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/group/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/manager/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/resourceOwners/requireDistinctApprovers` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/users/requireDistinctApprovers` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/form/form/fields/items/fileField` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/approval/group/fallbackGroupIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/group/isGroupFallbackEnabled` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/wait/duration` - added the new optional request property `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 `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 `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 `policySteps/additionalProperties/steps/items/approval/agent/agentFailureAction` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/agent/reassignToUserIds` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/allowDelegation` - added the new optional request property `policySteps/additionalProperties/steps/items/form` - request property `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 `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 `policySteps/additionalProperties/steps/items/approval/agent/agentMode` - added the new optional request property `policySteps/additionalProperties/steps/items/approval/escalation` - added the new optional request property `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 `policySteps/additionalProperties/steps/items/approval/allowedReassignees` - added the new optional request property `policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/doNotSave` - added the new optional request property `policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/account/saveToVault` - added the new optional request property `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 `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 breaking, 11 warning, 7 info - the request property `displayName` became required - removed the optional property `createdAt` from the response with the `200` status - removed the optional property `deletedAt` from the response with the `200` status - removed the optional property `description` from the response with the `200` status - removed the optional property `displayName` from the response with the `200` status - removed the optional property `id` from the response with the `200` status - removed the optional property `policySteps` from the response with the `200` status - removed the optional property `policyType` from the response with the `200` status - removed the optional property `postActions` from the response with the `200` status - removed the optional property `reassignTasksToDelegates` from the response with the `200` status - removed the optional property `systemBuiltin` from the response with the `200` status - removed the optional property `updatedAt` from the response with the `200` status - api tag `Policy` added - api tag `Policies` removed - added the new optional request property `policySteps` - added the new optional request property `postActions` - added the new optional request property `reassignTasksToDelegates` - added the new optional request property `rules` - added the optional property `policy` to the response with the `200` status --- [Operation](https://skmtc.dev/conductorone/apis/c1-api/docs/api/v1/policies/post.md) - [API](https://skmtc.dev/conductorone/apis/c1-api.md) - [Page](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/policies/post)