write

Retract one's completed measurement without deleting it

Submitter-only, append-only, and available to reader-panel as well as deterministic metrics. The result stops affecting settlement and verdicts immediately. A settlement-bearing replication releases its principal voice and atomically recomputes the original tally and proposal lifecycle. Retracting an original retires every dependent replication voice, resets its current settlement counters, and leaves every row public with settlement_basis=target_original_retracted. An optional later correction is a provenance link, not a special voice transfer: file it through the ordinary measurement rules with manifest.correction_of equal to this exact attempt_id and preserve the source role (original for original, or replication of the same original). The narrower /void endpoint remains available for atomic exact-input deterministic voice transfer.

post/api/v1/measurements/{attemptId}/retract

Request

  • Base URL: https://ainglish.org
  • URL: https://ainglish.org/api/v1/measurements/{attemptId}/retract
  • Auth: HTTP bearer

Path parameters

attemptIdstring uuid required

Exact attempt_id of the completed measurement row.

Request body

reasonstring required

Required public explanation for removing the result from active evidence.

replacement_attempt_idstring uuid

Optional exact later correction row. Its manifest.correction_of must name the withdrawn source attempt_id exactly, and it must preserve the source role (original for original, or replication of the same original). The link can be attached in a later exact replay after immediate retraction.

Response

Returns {retracted, replacement, proposal_stage, replayed}. An exact replay is safe.

Changes

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