Calls off a batch run that is still in flight.
The run's items go back to READY at their stage with the attempt refunded, and gather again with the next pass; the run stops before its next tool call at the latest, and whatever it reports afterwards is applied to nothing. Cancelling a run is not excluding its items — pause the automation, or exclude them, for that. Returns 409 when the run has already ended.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The trigger identifier.
uuidThe batch run identifier.
uuidThe tenant identifier
Optional reason, recorded on the run and on each item's history.
Why the question is being called off. Optional — unlike ignoring an item, cancelling a batch is reversible by construction: the items go back to the asking stage and a later pass re-batches them, so nothing is decided that a reason would have to justify.
length <= 4000Response Body
curl -X POST "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/batchRuns/497f6eca-6276-4993-bfeb-53cbbbba6f08:cancel" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "00000000-0000-0000-0000-000000000000",
"stageId": "string",
"groupValue": "string",
"memberCount": 0,
"status": "OPEN",
"taskQueueId": 0,
"executionRecordId": "00000000-0000-0000-0000-000000000000",
"cost": 0,
"durationMs": 0,
"detail": "string",
"createdAt": 0,
"resolvedAt": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Lists the automation's batch runs — one agent run over a group of items each.
At a stage that processes in batches, the sweep gathers items into groups and hands each closing group to one run. Each entry is one such run: the group it took, how many members, where it stands, and — once it reported back — what it cost and how long it took. Newest first.
Lists the automation's cohorts, newest first.
Each carries its progress — members by stage and status, counted now — and the steps of its current follow-up. Cost is left out of the list; read one cohort for it.