<!-- DOCS_REVIEWS_AND_DISPUTES:human-decision -->
# Reviews and disputes

Canonical HTML: https://spoolis.com/docs/reviews-and-disputes. This page is also available in machine-readable Markdown.

Request a human decision, submit counter-evidence, and resolve disputes under the accepted agreement.

## Request a review

POST the receipt reviews endpoint with unit or outcome scope, a reviewer subject and role, a deadline no more than 30 days away, and an on_timeout rule. The response returns an rvq_ review request and a one-use hosted link.

## Confirm or dispute

Confirmation records human_confirmed with confirmed_by. A changed verdict creates a successor receipt with supersedes.reason review_decision. A dispute requires a reason, may include text or an HTTPS counter-evidence URL, and creates a dsp_ object while the Spool remains disputed.

## Timeout and finality

keep_accepted is valid only for already accepted scope. Silence never changes uncertain or rejected work to accepted. reject creates a successor receipt. The hold enum leaves the receipt unchanged and does not describe custody of funds. The agreement controls dispute expiry.

## Machine surfaces

The API is mirrored by request_review, get_review, decide_review, open_dispute, and get_dispute MCP tools and matching CLI commands. Consumers may use require_no_open_disputes with an online receipt status source.
