Corrections
Correct many data point values
Applies many corrections in one all-or-nothing request. Each item takes the same fields as a single correction and addresses its data point by event friendly ID and slug, so one call can span many events and event types. Requires the write:event token scope.
If any item fails, nothing is persisted, and the response reports every item: a failing item carries status: error with a message, and items that would have succeeded come back as not_applied. Fix the reported item and resend the whole batch.
POST
/
projects
/
{project_id}
/
corrections
/
batch
Apply many corrections at once
curl --request POST \
--url https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"corrections": [
{
"event": "evt_mNoP2345qRsT6789",
"slug": "ambient-temperature-c",
"value": 12.4,
"notes": "Sensor drift confirmed against the calibration log."
},
{
"event": "evt_kLmN3456oPqR7890",
"slug": "mass-flow-rate",
"value": 0,
"method": "zero_fill",
"expect": "gap"
}
]
}
'import requests
url = "https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch"
payload = { "corrections": [
{
"event": "evt_mNoP2345qRsT6789",
"slug": "ambient-temperature-c",
"value": 12.4,
"notes": "Sensor drift confirmed against the calibration log."
},
{
"event": "evt_kLmN3456oPqR7890",
"slug": "mass-flow-rate",
"value": 0,
"method": "zero_fill",
"expect": "gap"
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
corrections: [
{
event: 'evt_mNoP2345qRsT6789',
slug: 'ambient-temperature-c',
value: 12.4,
notes: 'Sensor drift confirmed against the calibration log.'
},
{
event: 'evt_kLmN3456oPqR7890',
slug: 'mass-flow-rate',
value: 0,
method: 'zero_fill',
expect: 'gap'
}
]
})
};
fetch('https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch', 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}/corrections/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'corrections' => [
[
'event' => 'evt_mNoP2345qRsT6789',
'slug' => 'ambient-temperature-c',
'value' => 12.4,
'notes' => 'Sensor drift confirmed against the calibration log.'
],
[
'event' => 'evt_kLmN3456oPqR7890',
'slug' => 'mass-flow-rate',
'value' => 0,
'method' => 'zero_fill',
'expect' => 'gap'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch"
payload := strings.NewReader("{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"applied": true,
"results": [
{
"index": 0,
"status": "created",
"correction": {
"id": "sub_aBcD1234eFgH5678",
"data_point_id": "in_kLmN3456oPqR7890",
"stage": "ingestion",
"source": "api",
"method": "manual_entry",
"origin": "substituted",
"from_value": 14.9,
"to_value": 12.4,
"notes": "Sensor drift confirmed against the calibration log.",
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
},
{
"index": 1,
"status": "created",
"correction": {
"id": "sub_kLmN3456oPqR7890",
"data_point_id": "in_mNoP2345qRsT6789",
"stage": "ingestion",
"source": "api",
"method": "zero_fill",
"origin": "imputed",
"from_value": null,
"to_value": 0,
"notes": null,
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
}
]
}{
"errors": [
{
"message": "API token has expired"
}
]
}{
"errors": [
{
"message": "You are not authorized to perform this action"
}
]
}{
"errors": [
{
"message": "Record not found"
}
]
}{
"applied": false,
"results": [
{
"index": 0,
"status": "not_applied",
"correction": {
"id": "sub_aBcD1234eFgH5678",
"data_point_id": "in_kLmN3456oPqR7890",
"stage": "ingestion",
"source": "api",
"method": "manual_entry",
"origin": "substituted",
"from_value": 14.9,
"to_value": 12.4,
"notes": "Sensor drift confirmed against the calibration log.",
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
},
{
"index": 1,
"status": "error",
"error": "Unknown event 'evt_doesNotExist0001'"
}
]
}Authorizations
Path Parameters
The project's friendly ID (e.g. prj_aBcD1234eFgH5678).
Body
application/json
The corrections to apply, in order. Each item is reported back by its index.
Show child attributes
Show child attributes
⌘I
Apply many corrections at once
curl --request POST \
--url https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"corrections": [
{
"event": "evt_mNoP2345qRsT6789",
"slug": "ambient-temperature-c",
"value": 12.4,
"notes": "Sensor drift confirmed against the calibration log."
},
{
"event": "evt_kLmN3456oPqR7890",
"slug": "mass-flow-rate",
"value": 0,
"method": "zero_fill",
"expect": "gap"
}
]
}
'import requests
url = "https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch"
payload = { "corrections": [
{
"event": "evt_mNoP2345qRsT6789",
"slug": "ambient-temperature-c",
"value": 12.4,
"notes": "Sensor drift confirmed against the calibration log."
},
{
"event": "evt_kLmN3456oPqR7890",
"slug": "mass-flow-rate",
"value": 0,
"method": "zero_fill",
"expect": "gap"
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
corrections: [
{
event: 'evt_mNoP2345qRsT6789',
slug: 'ambient-temperature-c',
value: 12.4,
notes: 'Sensor drift confirmed against the calibration log.'
},
{
event: 'evt_kLmN3456oPqR7890',
slug: 'mass-flow-rate',
value: 0,
method: 'zero_fill',
expect: 'gap'
}
]
})
};
fetch('https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch', 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}/corrections/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'corrections' => [
[
'event' => 'evt_mNoP2345qRsT6789',
'slug' => 'ambient-temperature-c',
'value' => 12.4,
'notes' => 'Sensor drift confirmed against the calibration log.'
],
[
'event' => 'evt_kLmN3456oPqR7890',
'slug' => 'mass-flow-rate',
'value' => 0,
'method' => 'zero_fill',
'expect' => 'gap'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch"
payload := strings.NewReader("{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gomangrove.com/api/v1/projects/{project_id}/corrections/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"corrections\": [\n {\n \"event\": \"evt_mNoP2345qRsT6789\",\n \"slug\": \"ambient-temperature-c\",\n \"value\": 12.4,\n \"notes\": \"Sensor drift confirmed against the calibration log.\"\n },\n {\n \"event\": \"evt_kLmN3456oPqR7890\",\n \"slug\": \"mass-flow-rate\",\n \"value\": 0,\n \"method\": \"zero_fill\",\n \"expect\": \"gap\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"applied": true,
"results": [
{
"index": 0,
"status": "created",
"correction": {
"id": "sub_aBcD1234eFgH5678",
"data_point_id": "in_kLmN3456oPqR7890",
"stage": "ingestion",
"source": "api",
"method": "manual_entry",
"origin": "substituted",
"from_value": 14.9,
"to_value": 12.4,
"notes": "Sensor drift confirmed against the calibration log.",
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
},
{
"index": 1,
"status": "created",
"correction": {
"id": "sub_kLmN3456oPqR7890",
"data_point_id": "in_mNoP2345qRsT6789",
"stage": "ingestion",
"source": "api",
"method": "zero_fill",
"origin": "imputed",
"from_value": null,
"to_value": 0,
"notes": null,
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
}
]
}{
"errors": [
{
"message": "API token has expired"
}
]
}{
"errors": [
{
"message": "You are not authorized to perform this action"
}
]
}{
"errors": [
{
"message": "Record not found"
}
]
}{
"applied": false,
"results": [
{
"index": 0,
"status": "not_applied",
"correction": {
"id": "sub_aBcD1234eFgH5678",
"data_point_id": "in_kLmN3456oPqR7890",
"stage": "ingestion",
"source": "api",
"method": "manual_entry",
"origin": "substituted",
"from_value": 14.9,
"to_value": 12.4,
"notes": "Sensor drift confirmed against the calibration log.",
"rule": null,
"created_by": "Example User",
"created_at": "2026-07-21T14:02:55.000Z"
}
},
{
"index": 1,
"status": "error",
"error": "Unknown event 'evt_doesNotExist0001'"
}
]
}