Run and retract an extraction

Start hosted extraction on a decision, follow its progress, and reject a proposal that the quote does not actually support.

Use this guide to extract proposals from one decision and to retract one afterwards. You need a configured provider (Configure hosted extraction) and a live document with stored text.

#1. Find the document ID

bash

curl -s http://127.0.0.1:8787/v1/radar/status | python3 -c "import json,sys;print(json.load(sys.stdin)['example'])"

example.documentId is a document with parsed recitals you can use. Any ID from GET /v1/radar/documents also works.

#2. Start the run

bash

curl -s -X POST http://127.0.0.1:8787/v1/radar/documents/DOCUMENT_ID/extract \
  -H 'Content-Type: application/json' \
  -d '{"requestedBy":"A. Lawyer"}'

Status	Meaning
`202`	A new run started. Follow `statusPath`.
`200`	An identical completed run (same source, recital parse, prompt and model) already exists and is reused.
`503`	No provider is configured.
`409`	The server is offline (`CLEARY_OFFLINE=1`).

Opening a case report also queues extraction automatically for any document not yet extracted with the current prompt.

#3. Follow progress

bash

curl -s http://127.0.0.1:8787/v1/radar/extractions/RUN_ID | python3 -m json.tool

Every stored numbered recital is processed, including oversized paragraphs split into overlapping sections. Failed or interrupted runs cannot publish proposals.

#4. Read the proposals

bash

curl -s http://127.0.0.1:8787/v1/radar/documents/DOCUMENT_ID/extractions | python3 -m json.tool

Proposals that passed the checks carry autoApproved: true and the reviewer auto-approve policy. Party proposals are promoted to category 1 on arrival.

#5. Retract a proposal

The quote gate proves the words occur in the recital — not that they support the statement. If a lawyer reads a proposal in context and disagrees, reject it:

bash

curl -s -X POST http://127.0.0.1:8787/v1/radar/extractions/PROPOSAL_ID/review \
  -H 'Content-Type: application/json' \
  -d '{"outcome":"rejected","reviewedBy":"A. Lawyer","note":"Quote describes the market, not this company."}'

The rejection is written to the append-only log. Summary lines that cited the rejected note are withdrawn.

#6. Regenerate summaries and hypotheses

To rebuild the summary lines, charts and BINA hypotheses for a completed run without extracting again:

bash

curl -s -X POST http://127.0.0.1:8787/v1/radar/extractions/RUN_ID/summarize \
  -H 'Content-Type: application/json' -d '{}'