Revert a rule's corrections
Deletes every correction the rule wrote, across all of its versions, and puts each data point back to the value it replaced. The rule can correct those data points again on a later evaluation. Requires the write:rule token scope.
The call returns at once with corrections_outstanding, and the work runs in the background; when it is 0, nothing runs. A correction inside a reported batch, or one somebody has corrected since, is left in place.
To track the revert, list the rule’s runs with GET /projects/{project_id}/rules/{rule_id}/runs. The revert appears there as a run with trigger set to on_demand, no range_start or range_end, and state set to reversing, which moves to reversed once it finishes, or reversal_failed if it fails. Its reversal_summary counts the corrections removed as corrections_deleted and the ones left in place as refused.
Authorizations
Path Parameters
The project's friendly ID (e.g. prj_aBcD1234eFgH5678).
The rule's friendly ID (e.g. rule_aBcD1234eFgH5678).
Response
Accepted; the reverting runs in the background.
Corrections the rule still held when the request was accepted. It includes corrections the revert leaves in place, so it is an upper bound on how many are removed.
629