Knowledge Base

Add Brand Facts

Changed on

Adds brand facts to a website's Knowledge Base in bulk (1-50 per call). Every fact runs the full ingestion pipeline — deduplication, approval gates, and pillar routing — and there is no way to force-approve: inputs are declarative (text, optional source URL, optional pillar pin) and the response reports one outcome per fact. Facts without a pillar_id are routed automatically and may land unfiled. A fact that facts already in the Knowledge Base say something similar to is not added: its outcome is duplicate and lists them under matches, and the response carries a match_token. Resolve them with a second call carrying the same facts, the match_token, one decision per listed match and save_submitted. Requires a website-admin API key. Also available as the MCP tool add_brand_facts.

post/api/v1/knowledge-base/facts

Request

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

Request body

website_idstring uuid required

The website whose Knowledge Base to add facts to.

match_tokenstring

Second call only: the match_token from a response that listed matches. Send it with the same facts that were not added, one decision per listed match and save_submitted.

save_submittedboolean

Second call only: true adds the facts as written, without another similarity check, through the usual approval gates; false only applies the decisions. The decisions and the added facts are written together or not at all.

Response

Facts ingested; one outcome per fact, aligned with the request by index

match_tokenstring

Present when any outcome lists matches. Send it back on the second call.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status