Rule Runs

Revert a rule run

Takes a run back, reverting the verdicts it wrote. The run transitions immediately, so a second call finds a run that can no longer transition, while the unwinding itself happens in the background.

Corrections the run wrote are removed and each value goes back to the one it replaced, except where the correction sits in a reported batch or somebody has corrected the value since. reversal_summary counts them as corrections_planned and corrections_deleted.

Rows are left untouched where a verdict was dismissed, where the row sits in a batch that has been reported, and where a later run has taken it over. Each is listed in reversal_summary.

Check reversible before calling. When it is false, non_reversible_reason says why.

POST

projects

{project_id}

rules

{rule_id}

runs

{id}

reverse

Revert a rule run

curl --request POST \
  --url https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "rrun_AbCd1234567890Ef",
  "rule_id": "rule_AbCd1234567890Ef",
  "state": "reversing",
  "phase": "evaluating",
  "trigger": "on_demand",
  "range_start": "2026-07-01T00:00:00Z",
  "range_end": "2026-07-31T23:59:59Z",
  "started_at": "2026-08-28T14:22:06Z",
  "finished_at": null,
  "last_evaluated_at": "2026-08-28T14:22:31Z",
  "targets_total": 1450,
  "targets_processed": 600,
  "passed_count": 580,
  "alerted_count": 20,
  "results_changed_count": 12,
  "newly_alerted_count": 9,
  "newly_cleared_count": 3,
  "reversible": false,
  "non_reversible_reason": "This run is still going. Revert is available once it finishes.",
  "reversal_summary": null,
  "triggered_by": "Sam Okonkwo",
  "error_message": null
}

{
  "errors": [
    {
      "message": "Another revert is in progress for this rule. Try again once it finishes."
    }
  ]
}

Authorizations

Authorization

string

header

required

Path Parameters

project_id

string

required

Project friendly ID (e.g. prj_AbCd1234567890Ef).

rule_id

string

required

Rule friendly ID.

string

required

Run friendly ID (e.g. rrun_AbCd1234567890Ef).

Response

200

string

Run friendly ID (e.g. rrun_AbCd1234567890Ef).

rule_id

string

state

enum<string>

Available options:

running,

completed,

failed,

superseded,

reversing,

reversed,

reversal_failed

phase

enum<string> | null

Where a running run has got to. Null once it is no longer running.

Available options:

queued,

preparing,

evaluating

trigger

enum<string>

What started the run. A run you create here is on_demand.

Available options:

authoring,

ingestion,

schedule_sweep,

on_demand

range_start

string<date-time>

range_end

string<date-time>

started_at

string<date-time> | null

finished_at

string<date-time> | null

last_evaluated_at

string<date-time> | null

targets_total

integer

targets_processed

integer

passed_count

integer

alerted_count

integer

results_changed_count

integer

How many verdicts this run actually changed.

newly_alerted_count

integer

newly_cleared_count

integer

reversible

boolean

Whether this run can still be taken back.

non_reversible_reason

string | null

Why it cannot, when reversible is false.

reversal_summary

object | null

What a revert did, once one has run, including the rows it declined to touch and why.

triggered_by

string | null

The name of the person who started it. Null for a run started by an account-scoped token, which has no person behind it.

error_message

string | null

Revert a rule run

curl --request POST \
  --url https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.gomangrove.com/api/v1/projects/{project_id}/rules/{rule_id}/runs/{id}/reverse")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "rrun_AbCd1234567890Ef",
  "rule_id": "rule_AbCd1234567890Ef",
  "state": "reversing",
  "phase": "evaluating",
  "trigger": "on_demand",
  "range_start": "2026-07-01T00:00:00Z",
  "range_end": "2026-07-31T23:59:59Z",
  "started_at": "2026-08-28T14:22:06Z",
  "finished_at": null,
  "last_evaluated_at": "2026-08-28T14:22:31Z",
  "targets_total": 1450,
  "targets_processed": 600,
  "passed_count": 580,
  "alerted_count": 20,
  "results_changed_count": 12,
  "newly_alerted_count": 9,
  "newly_cleared_count": 3,
  "reversible": false,
  "non_reversible_reason": "This run is still going. Revert is available once it finishes.",
  "reversal_summary": null,
  "triggered_by": "Sam Okonkwo",
  "error_message": null
}

{
  "errors": [
    {
      "message": "Another revert is in progress for this rule. Try again once it finishes."
    }
  ]
}

Getting Started

API Cookbooks

Production Data

Accounting and Reporting

Credit Inventory Management

Account Admin

Revert a rule run

Authorizations

Path Parameters

Response