Briefs

Contribute claims, sources, or both to a brief's fact ledger

Records what only the customer knows. Each entry is either a claim they are asserting (stored as theirs and cited to them) or a URL alone, which is fetched so its claims can be extracted. A claim may also carry source_url: the page the caller says backs that claim, attached in the SAME write and recorded as the caller's own decision (human_verified), never as machine grounding. A claim and its source_url land together or not at all, so no result ever means "the fact saved but its source did not" — such an entry comes back failed. Reported per contribution: a body of three where one is rejected is a 200 naming that one with its reason, not a 400 discarding the other two.

post/briefs/{id}/facts

Request

  • Base URL: https://next.frase.io/api/v1
  • URL: https://next.frase.io/api/v1/briefs/{id}/facts
  • Auth: API key in header X-API-KEY

Path parameters

idstring uuid required

Request body

split_multi_itemboolean

Split one entry's text into several facts when it lists separate claims. One contribution can then produce several results, so do not assume the results array matches the input by index.

Response

Per-contribution results. status is written | already_existed | queued | failed. On a success, source_url echoes back only when the source was actually attached, and source_skipped says why when a URL was sent and deliberately not attached.

Changes

No recorded changes to this operation across all 1 revision of this API.