---
title: "Changes to Create a new immutable policy set version"
method: POST
path: "/zones/{zone_id}/policy-sets/{policy_set_id}/versions"
---

# Changes to Create a new immutable policy set version

`POST /zones/{zone_id}/policy-sets/{policy_set_id}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 25 revisions.

- **2026-10-16** `0cfaff865771`: 26 breaking, 8 warning, 83 info
- **2026-04-02** `aee6e66de0d3`: 3 breaking, 12 info
- **2026-03-16** `d3d69f45bfed`: 1 info

## Changes

- **2026-10-16** `0cfaff865771`: 26 breaking, 8 warning, 83 info
  - the response property `details/items/field` became optional for the status `400`
  - the response property `details/items/field` became optional for the status `401`
  - the response property `details/items/field` became optional for the status `403`
  - the response property `details/items/field` became optional for the status `404`
  - the response property `details/items/field` became optional for the status `429`
  - the response property `details/items/field` became optional for the status `500`
  - the response property `details/items/field` became optional for the status `503`
  - the response property `details/items/field` became optional for the status `default`
  - the `details/items/code` response's property type changed from `string` to no type for status `400`
  - the `details/items/code` response's property type changed from `string` to no type for status `401`
  - the `details/items/code` response's property type changed from `string` to no type for status `403`
  - the `details/items/code` response's property type changed from `string` to no type for status `404`
  - the `details/items/code` response's property type changed from `string` to no type for status `429`
  - the `details/items/code` response's property type changed from `string` to no type for status `500`
  - the `details/items/code` response's property type changed from `string` to no type for status `503`
  - the `details/items/code` response's property type changed from `string` to no type for status `default`
  - removed the required property `attestation/attested_at` from the response with the `201` status
  - removed the required property `attestation/attested_by` from the response with the `201` status
  - removed the required property `attestation/key_id` from the response with the `201` status
  - removed the required property `attestation/manifest_sha` from the response with the `201` status
  - removed the required property `attestation/policy_set_id` from the response with the `201` status
  - removed the required property `attestation/policy_set_version` from the response with the `201` status
  - removed the required property `attestation/status` from the response with the `201` status
  - removed the required property `attestation/type` from the response with the `201` status
  - removed the required property `attestation/v` from the response with the `201` status
  - removed the required property `attestation/zone_id` from the response with the `201` status
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `401`
  - added the new `not_implemented` enum value to the `code` response property for the response status `403`
  - added the new `not_implemented` enum value to the `code` response property for the response status `404`
  - added the new `not_implemented` enum value to the `code` response property for the response status `429`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new `not_implemented` enum value to the `code` response property for the response status `503`
  - added the new `not_implemented` enum value to the `code` response property for the response status `default`
  - added the optional property `archived_by_user` to the response with the `201` status
  - added the optional property `created_by_user` to the response with the `201` status
  - added `#/components/schemas/pdp_AttestationStatement` to the `attestation` response property `allOf` list for the response status `201`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `400`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `401`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `403`
  - …77 more
- **2026-04-02** `aee6e66de0d3`: 3 breaking, 12 info
  - removed the required property `attestation/payload` from the response with the `201` status
  - removed the required property `attestation/protected` from the response with the `201` status
  - removed the required property `attestation/signature` from the response with the `201` status
  - the endpoint scheme security `OAuth2` was added to the API
  - added the required property `attestation/attested_at` to the response with the `201` status
  - added the required property `attestation/attested_by` to the response with the `201` status
  - added the required property `attestation/key_id` to the response with the `201` status
  - added the required property `attestation/manifest_sha` to the response with the `201` status
  - added the required property `attestation/policy_set_id` to the response with the `201` status
  - added the required property `attestation/policy_set_version` to the response with the `201` status
  - added the required property `attestation/status` to the response with the `201` status
  - added the required property `attestation/type` to the response with the `201` status
  - added the required property `attestation/v` to the response with the `201` status
  - added the required property `attestation/zone_id` to the response with the `201` status
  - added the required property `owner_type` to the response with the `201` status
- **2026-03-16** `d3d69f45bfed`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/keycardai/apis/untitled-api/docs/zones/:zone_id/policy-sets/:policy_set_id/versions/post.md) - [API](https://skmtc.dev/keycardai/apis/untitled-api.md) - [Page](https://skmtc.dev/keycardai/apis/untitled-api/changes/zones/:zone_id/policy-sets/:policy_set_id/versions/post)
