Create policy version

Creates a new draft version based on the current published version (or a specified source version).

POST /v1/policies/{id}/versions

Create policy version

cURL

curl --request POST \
  --url http://localhost:3333/v1/policies/{id}/versions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "sourceVersionId": "pv_abc123def456",
  "changelog": "Initial draft for quarterly updates"
}
'

201

{
  "versionId": "<string>",
  "version": 123
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Headers

X-Organization-Id · string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

id · string · required

Policy ID

Example:

"pol_abc123def456"

Body

application/json

Create a new policy version draft

sourceVersionId · string

Optional version ID to base the new version on

Example:

"pv_abc123def456"

changelog · string

Optional changelog to associate with the new version

Example:

"Initial draft for quarterly updates"

Response

201

application/json

Policy version created

versionId · string

version · number