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

  • Base URL
    https://agenticadvertising.org
  • URL
    https://agenticadvertising.org/api/policies/save
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://agenticadvertising.org/authorize
      Token URL: https://agenticadvertising.org/token

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

Changes

No recorded changes to this operation across all 71 revisions of this API.