v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB
Policy Registry

Save policy

Create or update a community-contributed policy. Requires authentication. Registry-sourced and pending-review policies cannot be edited (returns 409). Updates automatically create a revision record.

post/api/policies/save

Request body

policy_idstring required

Lowercase alphanumeric with underscores

versionstring required
namestring required
category'regulation' | 'standard' required
enforcement'must' | 'should' | 'may' required
policystring required
descriptionstring
jurisdictionsstring[]
region_aliasesobject
policy_categoriesstring[]
channelsstring[]
effective_datestring
sunset_datestring
governance_domainsstring[]
source_urlstring

Must use http:// or https://

source_namestring
guidancestring
extobject

Example request

{
  "policy_id": "my_brand_safety",
  "version": "1.0.0",
  "name": "Acme Corp Brand Safety",
  "policy": "Ads must not appear adjacent to content depicting violence..."
}

Response

Policy saved

successtrue required
messagestring required
policy_idstring required
revision_numberinteger nullable required