Cases

Revise case document (E2)

Incorporates the auditor (Node B) feedback into a previous draft. Jurisdiction is INHERITED from the case (NOT a parameter). SSE aggregated to JSON. Loopback: the internal route is the only one that debits (2 cr × tier multiplier).

post/api/v1/cases/{caseId}/draft-revise

Request

  • Base URL: https://legal.nexusquantum.legal
  • URL: https://legal.nexusquantum.legal/api/v1/cases/{caseId}/draft-revise
  • Auth: HTTP bearer

Path parameters

caseIdstring uuid required

Request body

draftstring required

Draft to revise.

nodoBFeedbackstring required

Auditor feedback to incorporate.

language'es' | 'en' | 'fr' | 'de'
modelTierIdstring

Response

READ corpusMissing BEFORE trusting the revision: true means the case corpus came back EMPTY, so the revision was made blind — there was no ground truth to check invention against. truncated means the model stopped mid-output and the revised draft stops mid-sentence: what is missing was NOT written. Both were emitted by the engine and silently dropped by this wrapper until 2026-07-26, so a blind revision arrived over REST with the exact same shape as a grounded one.

draftstring

Revised draft, PII rehydrated and with the truncation notice inside the body when applicable.

citationsOrigenCstring[]

Citations not present in the case corpus (possible invention).

piiResidualsstring[]

Anonymisation markers that could NOT be restored: the draft ships with placeholders where personal data should be.

piiResidualsFromCorpusstring[]

Markers that came from the case file itself: unrecoverable BY DESIGN (Zero Retention). The firm fills them in from its own source document.

piiResidualsInventedstring[]

Markers absent from the case file: engine-produced, no data behind them. Delete or replace.

truncatedboolean

The model stopped mid-output (finish_reason length/max_tokens): what is missing was NOT written. draft carries the same notice inside its body, because exports (.docx/.pdf/clipboard) do not carry this JSON. Do not use or file it without completing it. false asserts the text is complete.

corpusMissingboolean

The case corpus was empty — the revision ran with no ground truth.

chunksUsedinteger

Case fragments that entered the prompt.

chunksTotalinteger nullable

Fragments the case has. null = could not be counted, which is NOT 'there are no more'.

corpusPartialboolean

chunksUsed < chunksTotal: the revision saw only part of the case.

killSwitchobject nullable

Output watchdog. A lexical scan of the generated text for high-risk language (irrevocable waivers, apparent forgery, undisclosed conflicts, ouster of jurisdiction…). Codes are W-OUT-1…W-OUT-9, plus S-LEG-STOP when the model itself raised a halt. It does NOT block delivery — it reports. null = ran and did not fire; absent = not run. Lexicon covers ES/EN only.

processingMsinteger
requestIdstring

Changes

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