Versions

List versions of a policy

GET/zones/{zone_id}/policies/{policy_id}/versions

Create a new immutable policy version

POST/zones/{zone_id}/policies/{policy_id}/versions

Get a specific policy version

GET/zones/{zone_id}/policies/{policy_id}/versions/{version_id}

Archive a policy version

DELETE/zones/{zone_id}/policies/{policy_id}/versions/{version_id}

ModelsExpand Collapse

PolicyVersion = object { id, created_at, created_by, 10 more }

id: string

created_at: string

formatdate-time

created_by: string

owner_type: "platform" or "customer"

Who manages this policy version:

"platform" — managed by the Keycard platform (system policy versions).
"customer" — managed by the tenant (custom policy versions).

Accepts one of the following:

"platform"

"customer"

policy_id: string

schema_version: string

Schema version this policy was validated against when created.

sha: string

Hex-encoded content hash

version: number

zone_id: string

archived_at: optional string

formatdate-time

archived_by: optional string

cedar_json: optional unknown

Cedar policy in JSON representation. Populated by default and when format=json is passed; null when format=cedar narrows the response to the text representation only.

cedar_raw: optional string

Cedar policy in human-readable syntax. Populated by default and when format=cedar is passed; null when format=json narrows the response to the JSON representation only.