---
title: "Changes to Create or replace a policy set binding"
method: PUT
path: "/zones/{zone_id}/policy-bindings"
---

# Changes to Create or replace a policy set binding

`PUT /zones/{zone_id}/policy-bindings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 25 revisions.

- **2026-10-16** `0cfaff865771`: 14 breaking, 7 warning, 70 info
- **2026-06-17** `1a0dd4d857ee`: 1 warning, 9 info
- **2026-04-20** `932699a5ea16`: 1 info

## Changes

- **2026-10-16** `0cfaff865771`: 14 breaking, 7 warning, 70 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 `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 `default`
  - 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 `default`
  - 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`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `404`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `429`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `500`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `default`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `400`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `401`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `403`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `404`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `429`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `500`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `default`
  - removed the `conflict` enum value from the `details/items/code` response property for the response status `400`
  - removed the `conflict` enum value from the `details/items/code` response property for the response status `401`
  - removed the `conflict` enum value from the `details/items/code` response property for the response status `403`
  - removed the `conflict` enum value from the `details/items/code` response property for the response status `404`
  - removed the `conflict` enum value from the `details/items/code` response property for the response status `429`
  - …51 more
- **2026-06-17** `1a0dd4d857ee`: 1 warning, 9 info
  - added the new `active` enum value to the `mode` response property for the response status `200`
  - added the new optional request property `target_id`
  - added the new optional request property `target_type`
  - the request property `scope_type` became optional
  - request property `scope_target_id` deprecated
  - request property `scope_type` deprecated
  - response property `scope_target_id` deprecated
  - response property `scope_type` deprecated
  - added the required property `target_id` to the response with the `200` status
  - added the required property `target_type` to the response with the `200` status
- **2026-04-20** `932699a5ea16`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/docs/zones/:zone_id/policy-bindings/put.md) - [API](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api.md) - [Page](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/changes/zones/:zone_id/policy-bindings/put)
