Brand Perception

Change the wording and/or active state of facts by id. Each item sets text, is_active, or both. Changing the wording keeps the old wording for verdicts already judged against it. Setting is_active to false keeps the fact listed but excludes it from future fact-checking. Returns per-item results { updated, skipped, rejected }; the batch never fails as a whole. Skip reasons: not_found. Rejection reasons: duplicate_id (the same fact appears twice in the request), plan_limit (activating it would exceed the plan's fact_limit).

post/facts/update

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/facts/update
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key
    • or HTTP bearer

Request body

project_idstring

Required if using a company api key

Example request

{
  "project_id": "or_f45b94ba-5e35-4982-93ed-285e72ee14eb"
}

Response

Per-item update results

Example response

{
  "updated": [
    {
      "id": "0198f000-0000-7000-8000-000000000001",
      "text": "Plans start at €99 per month.",
      "origin": "manual",
      "edited_at": "2026-09-18T10:00:00.000Z",
      "created_at": "2026-09-01T10:00:00.000Z"
    }
  ]
}

Changes