ATathenahq
Knowledge Base

Update Brand Fact

Changed on

Updates one brand fact's text, source URL, or confidence. Only provided fields change; pass source_url: "" to clear the stored source. Changing the text creates a new fact (new id) and archives the current one; the new fact keeps the current review status and is the fact returned. Source URL and confidence edits update the fact in place and re-match the source to the internal link bank. Review status never changes through this endpoint. Requires a website-admin API key. Also available as the MCP tool update_brand_fact.

patch/api/v1/knowledge-base/facts/{fact_id}

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Path parameters

fact_idstring uuid required

The fact to update.

Request body

website_idstring uuid required

The website the fact belongs to.

textstring

New fact statement. Caps at 10000 characters, matching the in-app edit dialog (add_brand_facts caps new facts at 2000).

source_urlstring

New source URL. An empty string clears the stored source URL.

confidence'high' | 'medium' | 'low'

New confidence level.

Response

The updated fact plus a pre-update snapshot of the editable fields

Changes