Extraction
Start hosted extraction, follow runs, read proposals, retract a proposal, and regenerate summaries.
See Grounded extraction for what each check means.
#POST/v1/radar/documents/:id/extract
Start hosted extraction on all stored recitals of a document.
| Body field | Required | Description |
|---|---|---|
requestedBy | yes | Who started the run. Max 120 characters. |
| Status | Meaning |
|---|---|
202 | Run started. Body has run, statusPath, proposalsPath. |
200 | An identical completed run is reused. |
400 | requestedBy missing or too long. |
409 | Offline (CLEARY_OFFLINE=1). |
503 | No extraction provider configured. |
#GET/v1/radar/documents/:id/extractions
Every run and proposal for a document.
Response 200: { runs, proposals, llm }. Proposals from every prompt version are kept; incomplete or older-method coverage is labelled.
#GET/v1/radar/extractions/:runId
One run with its progress, provenance (source version, model, prompt hash, raw response hash), coverage, usage and its own proposals.
Errors: 404 — no extraction run with that ID.
#POST/v1/radar/extractions/:id/review
Approve or reject a proposal. Rejection is the retraction path for auto-accepted items.
| Body field | Required | Description |
|---|---|---|
outcome | yes | approved or rejected. |
reviewedBy | yes | Max 120 characters. |
note | no | Max 500 characters. |
Refused for stale, incomplete or already-reviewed proposals; re-approving an accepted item is refused. Recorded as radar.extraction.reviewed.
#POST/v1/radar/extractions/:runId/summarize
Rewrite the plain-language summary lines, party charts and BINA hypotheses for a completed run, without extracting again.
Response 200: { summary, charts, hypotheses }.
Errors: 409 when offline.