v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB

PolicySetDrafts

Create or replace a policy set draft

Full replacement of the draft state. Creates the draft if it does not exist, replaces it if it does. Standard REST PUT idempotency — the caller provides the complete desired state.

put/zones/{zone_id}/policy-sets/{policy_set_id}/draft

Path parameters

zone_idstring required

The zone identifier

policy_set_idstring required

The policy set identifier

Headers

X-API-Versionstring

API version header (date-based, e.g. 2026-02-01)

X-Client-Request-IDstring uuid

Unique request identifier specified by the originating caller and passed along by proxies.

Request body

schema_versionstring required

namestring

descriptionstring

Response

The upserted policy set draft

policy_set_idstring required

schema_versionstring required

namestring nullable

descriptionstring nullable

base_version_idstring nullable

ID of the policy set version this draft was hydrated from. Null when the draft was created without an existing version.

created_atstring date-time required

updated_atstring date-time required

updated_bystring required