Documented Reversibility
Does the contract say what can be UNDONE, how, and within what window. roadmap#68 proposed this over a consequence multiplier on dry-run and idempotency, and preferred it for a reason that holds up: a multiplier needs whole markets classified by hazard, which is the hard part, while this measures something no dimension covers and needs no such classification. It is what an agent actually needs BEFORE it acts. Dry-run lets it rehearse and idempotency stops it double-firing; neither tells it whether the action it is about to take can be taken back. GRADED. `documented` = a reversal operation exists in the contract (cancel, refund, void, reverse, undo, rollback, restore). `verified` = that AND a stated window (grace_period, cancellation_window, "within 30 days"). A path says the capability exists; the window is what makes it plannable. A window with NO reversal operation behind it earns nothing -- that is a policy sentence, not a capability. MEASURED 2026-08-18 across 7,579 providers holding a contract: 1,353 (17.8%) expose a reversal operation, 343 (4.5%) document a window, 171 (2.3%) do both. It discriminates without being near-empty, which is what a new dimension has to clear. GATED ON WRITE SURFACE like the other hazard dimensions: a read-only API has nothing to reverse, and a zero there would measure the absence of a hazard rather than the absence of work.
na on this
dimension, not zero. A read-only surface carries no write hazard to mitigate, so since
rubric 0.12 this dimension leaves their denominator entirely rather than handing them a zero for
something they cannot have. Every number on this page is over the
26,503 providers it does apply to.
How it is scored
One signal, read from what the provider publishes, worth 6 points of the 139 in the agent-readiness score.
| Signal the scorer reads | Points |
|---|---|
a reversal operation in the contract, graded up when a window is documented too | 6 |
Grades and what each earns
This dimension is graded rather than pass/fail: how the signal was evidenced decides what fraction of the points it earns.
| Grade | Credit | Points | Providers |
|---|---|---|---|
| verified | 1.0× | 6.0 | 168 |
| documented | 0.4× | 2.4 | 1,170 |
Top providers
The top 500 of 1,338 providers publishing this signal, ranked by credit earned, ties broken by composite.
The other 18 dimensions
github.com/api-evangelist/<provider>, and each check above names the exact artifact it
reads. Publish the artifact, open a pull request, and the next scoring run picks it up — no gatekeeping
and no fee. The full rubric is at apis.io/rating/, and
prioritized profiling
is the fast lane if you would rather have it done for you.
Scored on rubric v0.17.2 across 27,504 providers · lists rebuilt 2026-09-01 · capped at the top 500 per page.