Skip to main content

​
update_content_standards

Update an existing content standards configuration. Creates a new version. Response time: < 1s

​
Request

Schema: update-content-standards-request.json
ParameterTypeRequiredDescription
standards_idstringYesID of the standards configuration to update
scopeobjectNoUpdated scope
policiesPolicyEntry[]NoUpdated array of policies. Replaces existing policies; use stable policy_id values to track policies across versions.
calibration_exemplarsobjectNoUpdated training exemplars (pass/fail)

​
Example Request

{
  "$schema": "/schemas/content-standards/update-content-standards-request.json",
  "idempotency_key": "b0c1d2e3-f4a5-4678-b901-678901234567",
  "standards_id": "nike_emea_safety",
  "policies": [
    {
      "policy_id": "no_violence",
      "policy_categories": ["brand_safety"],
      "enforcement": "must",
      "policy": "Avoid content depicting violence, weapons, or physical aggression."
    },
    {
      "policy_id": "no_controversial_politics",
      "policy_categories": ["brand_suitability"],
      "enforcement": "must",
      "policy": "Avoid controversial political content."
    },
    {
      "policy_id": "no_adult_themes",
      "policy_categories": ["brand_safety"],
      "enforcement": "must",
      "policy": "Avoid adult, sexual, or mature themes."
    },
    {
      "policy_id": "no_hate_speech",
      "policy_categories": ["brand_safety"],
      "enforcement": "must",
      "policy": "Block hate speech and illegal activities."
    }
  ],
  "calibration_exemplars": {
    "pass": [
      { "type": "url", "value": "https://espn.com/nba/story/_/id/12345/lakers-win", "language": "en" },
      { "type": "url", "value": "https://healthline.com/fitness/cardio-workout", "language": "en" },
      { "type": "url", "value": "https://runnersworld.com/training/marathon-tips", "language": "en" }
    ],
    "fail": [
      { "type": "url", "value": "https://tabloid.example.com/celebrity-scandal", "language": "en" },
      { "type": "url", "value": "https://gambling.example.com/betting-guide", "language": "en" }
    ]
  }
}

​
Response

Schema: update-content-standards-response.json

​
Success Response

{
  "$schema": "/schemas/content-standards/update-content-standards-response.json",
  "status": "completed",
  "success": true,
  "standards_id": "nike_emea_safety"
}

​
Error Response

{
  "$schema": "/schemas/content-standards/update-content-standards-response.json",
  "status": "completed",
  "success": false,
  "errors": [
    {
      "code": "REFERENCE_NOT_FOUND",
      "field": "standards_id",
      "message": "Referenced resource does not exist or is not accessible"
    }
  ]
}