Batches

Update batch inputs

Edits an existing batch’s inputs — the API equivalent of the dashboard’s edit-batch flow. Use it to re-attach data points, adjust upstream batch allocations, or skip data point types so they are recorded as skipped_input rather than left missing. Each array replaces the current set for that field (it is not merged). The batch’s model runs are re-staged and recomputed asynchronously, so the response returns the batch immediately, before recomputation finishes. A batch that already has allocations cannot be edited.

PATCH

ledgers

{ledger_id}

batches

{id}

update_inputs

curl --request PATCH \
  --url https://app.gomangrove.com/api/v1/ledgers/{ledger_id}/batches/{id}/update_inputs \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skipped_data_point_type_ids": [
    42,
    99
  ]
}
'

{
  "id": "bat_abc123def456",
  "tracking_id": "MG-2025-001",
  "start_time": "2025-01-01T00:00:00.000Z",
  "end_time": "2025-03-31T23:59:59.000Z",
  "state": "processing",
  "error_message": null,
  "primary_output": {
    "id": 1,
    "name": "RNG produced",
    "unit": "MMBtu",
    "data_point_type_id": 5,
    "value": 9146
  },
  "has_rule_alerts": false,
  "created_at": "2025-01-15T10:00:00.000Z",
  "updated_at": "2025-04-02T11:30:00.000Z"
}

Authorizations

Authorization

string

header

required

Path Parameters

ledger_id

string

required

Ledger friendly ID (e.g., lgr_abc123def456)

string

required

Batch friendly ID (e.g., bat_abc123def456)

Body

application/json

data_point_ids

string[]

Data point friendly IDs to attach as the batch's inputs. Replaces the current set. Unknown IDs return 422.

batch_amounts

object[]

Upstream batch allocations. Replaces the current set. An unknown batch_id returns 404.

Show child attributes

skipped_data_point_type_ids

integer[]

Numeric data point type IDs to skip. Each skipped type is recorded as a zero-value skipped_input placeholder so the batch stays auditable. Replaces the current set. Unknown or out-of-config IDs return 422.

Response

200

Delete a batchDeletes a batch.

curl --request PATCH \
  --url https://app.gomangrove.com/api/v1/ledgers/{ledger_id}/batches/{id}/update_inputs \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skipped_data_point_type_ids": [
    42,
    99
  ]
}
'

{
  "id": "bat_abc123def456",
  "tracking_id": "MG-2025-001",
  "start_time": "2025-01-01T00:00:00.000Z",
  "end_time": "2025-03-31T23:59:59.000Z",
  "state": "processing",
  "error_message": null,
  "primary_output": {
    "id": 1,
    "name": "RNG produced",
    "unit": "MMBtu",
    "data_point_type_id": 5,
    "value": 9146
  },
  "has_rule_alerts": false,
  "created_at": "2025-01-15T10:00:00.000Z",
  "updated_at": "2025-04-02T11:30:00.000Z"
}