Publish policy version | Comp AI API

Publishes a draft policy version, making it the active/current version of the policy. Pass the versionId of the draft you want to publish — for example one.

POST /v1/policies/{id}/versions/publish

Publish policy version

cURL

curl --request POST \
  --url https://api.trycomp.ai/v1/policies/{id}/versions/publish \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "versionId": "pv_abc123def456",
  "setAsActive": true,
  "changelog": "Updated access controls section"
}
'

200

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

Authorizations

apikeyoauth2

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

Publish a new policy version

versionId · string

Version ID to publish. PASS THIS after update-version to publish your edits — omitting it publishes stale draftContent (loses your changes).

Example:

"pv_abc123def456"

setAsActive · boolean

Whether to set this version as the active version

Example:

true

changelog · string

Optional changelog to associate with the published version

Example:

"Updated access controls section"

Response

200

application/json

Version published

versionId · string

version · number