Briefs

POST /v1/brief

Generate a brief on demand — the flagship synthesis endpoint. Scope: brief:write. Available on every tier (Free capped at 30/mo). Takes an optional cost_cap_usd spend ceiling (default $1.00). Paragraphs that fail citation validation render insufficient_evidence — never fabricated.

curl "https://api.forumatlas.com/v1/brief" \
  -H "Authorization: Bearer $FORUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "variant": "daily_persona", "sectors": ["cyber"], "persona": "vc" }'

GET /v1/briefs

List briefs in your workspace. Scope: brief:read.

curl "https://api.forumatlas.com/v1/briefs?sector=cyber&limit=10" \
  -H "Authorization: Bearer $FORUM_API_KEY"

GET /v1/briefs/{id}

Single brief with full sections, citations, entities.

GET /v1/briefs/{id}/bibliography

Bibliography export. Query: ?style=apa|mla|chicago|harvard.

GET /v1/briefs/{id}/evidence

The evidence bundle — every claim in the brief paired with the exact chunk it was validated against, the source document (source_url, content_sha256, retrieved_at), the archived snapshot taken at citation time, and the validator verdict. Returned under schema forum.evidence_bundle.v1 with a deterministic bundle_sha256, so two pulls of the same brief are byte-comparable and an auditor can re-derive the hash themselves. Scope: brief:read.

curl "https://api.forumatlas.com/v1/briefs/$BRIEF_ID/evidence" \
  -H "Authorization: Bearer $FORUM_API_KEY"