What each pass admitted, dispatched, finished and spent.
The fire log with the ledger's own accounting joined onto it, newest pass first. The Fires tab already said a pass happened; this says what it did and what it cost, which is the pair that answers "at this rate, what will the rest of this backfill cost" before it is started rather than after. Counts come from the append-only transition log, not from the fire row, and a pass's runs are gathered by the claim that dispatched them rather than by timestamp — a sweep records itself after claiming, and its runs report their spend when they finish, so timestamps alone would credit every pass with the previous one's cost. `cost` therefore rises after `firedAt` as the pass drains, and a pass read moments after firing reports less than it will. `docs/design/item-ledger.md §6.5`.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The trigger identifier.
uuidThe tenant identifier
Query Parameters
The maximum number of items to return per page
int32int32Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/passes"{
"items": [
{
"id": "00000000-0000-0000-0000-000000000000",
"firedAt": 0,
"source": "SCHEDULE",
"outcome": "FIRED",
"detail": "string",
"admitted": 0,
"dispatched": 0,
"completed": 0,
"runs": 0,
"cost": 0
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}One item's attempt history.
The append-only transition log (§6.6) — the accountability grain, answering "what happened to this item and why". The run tree answers the different question of why one attempt behaved badly; neither grain is asked to do the other's job.
Starts the ledger over.
Destructive. Cancels every open batch (settling its human task and closing its conversation), deletes every item, effect and transition, and moves the cursor to an empty position under a new version so an in-flight pass loses its write. Refused with 409 when `confirmItems` is not the ledger's current item count, or while a running pass holds a claim. The effects' external targets are not touched — the next pass performs them again.