v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB

Policies

Create policy version

Creates a new draft version of a policy, cloned from the current published version (or a specified source version). Use this when you need to make any change to a published policy — content edits, PDF attachments, anything. Published.

post/v1/policies/{id}/versions

Path parameters

idstring required

Example:pol_abc123def456

Policy ID

Headers

X-Organization-Idstring

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

Request body

sourceVersionIdstring

Optional version ID to base the new version on

changelogstring

Optional changelog to associate with the new version

Example request

{
  "sourceVersionId": "pv_abc123def456",
  "changelog": "Initial draft for quarterly updates"
}

Response

Policy version created

versionIdstring

versionnumber