v22

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

PolicySetDrafts

List policies in a policy set draft

Returns the policy versions referenced by the draft's manifest as a paginated list. Mirrors the published /policy-sets/{policy_set_id}/versions/{version_id}/policies endpoint but sources entries from the policy set's mutable draft. Archived policy versions referenced by the manifest are still returned.

get/zones/{zone_id}/policy-sets/{policy_set_id}/draft/policies

Path parameters

zone_idstring required

The zone identifier

policy_set_idstring required

The policy set identifier

Query parameters

afterstring

An opaque cursor used for paginating through a list of results

Cursor for forward pagination. Returned in Pagination.after_cursor. Mutually exclusive with before.

beforestring

An opaque cursor used for paginating through a list of results

Cursor for backward pagination. Returned in Pagination.before_cursor. Mutually exclusive with after.

limitinteger

Maximum number of items to return per page.

expand[]PdpExpandField[]

Opt-in to additional response fields. Repeatable; matches the expand[] convention used across the Keycard API.

sort'created_at'

Field to sort by.

order'asc' | 'desc'

Sort direction. Default is desc (newest first).

format'cedar' | 'json'

Narrows which Cedar representation the response includes. When omitted, both cedar_json and cedar_raw are populated. Pass json to receive only cedar_json, or cedar to receive only cedar_raw. Callers that don't care about payload size can skip this parameter.

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.

Response

A paginated list of policy versions pinned by this draft's manifest