---
title: "Add Brand Facts"
method: POST
path: "/api/v1/knowledge-base/facts"
tags: ["Knowledge Base"]
---

# Add Brand Facts

`POST /api/v1/knowledge-base/facts`

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. Requires a website-admin API key. Also available as the MCP tool `add_brand_facts`.

## Request body

- object
  - `website_id` string, uuid, required — The website whose Knowledge Base to add facts to.
  - `facts` object[], required — The facts to ingest. No status or approval field exists — the pipeline decides.
    - `text` string, required — The fact statement.
    - `source_url` string — URL backing the fact. Third-party URLs make the fact pending human review; first-party URLs and facts without a URL can auto-approve.
    - `pillar_id` string, uuid — Pin the fact to this pillar (must belong to the website). Omit to let the pipeline route it.

## Response `201`

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

- object
  - `outcomes` BrandFactIngestOutcome[], required
    - `index` integer, required — Position of the fact in the request's facts array.
    - `outcome` 'approved' | 'pending' | 'duplicate', required — What the ingestion pipeline decided. Extensible: new outcome values may be added as the pipeline evolves — treat unknown values as non-terminal.
    - `fact_id` string, nullable, required — The created fact's id; null for duplicates (nothing was inserted).
    - `pillar_id` string, nullable, required — The pillar the fact was filed under (pinned or auto-routed); null when unfiled.

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - No admin access to this website, or the Knowledge Base is not enabled for the organization

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)