FruxonDocs
Agent NetworkTriggers

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.

GET
/v1/tenants/{tenant}/triggers/{trigger}/ledger/items/{item}/transitions

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

trigger*string

The trigger identifier.

Formatuuid
item*string

The ledger item identifier.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque 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.

orderBy?

Sort order.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/transitions"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "ledgerItemId": "00000000-0000-0000-0000-000000000000",
      "stageId": "string",
      "stageAttempt": 0,
      "fromStatus": "READY",
      "toStatus": "READY",
      "cause": "string",
      "detail": "string",
      "executionRecordId": "00000000-0000-0000-0000-000000000000",
      "createdAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Returns a stuck work item to the queue.

The dead-letter escape hatch. A DEAD item has exhausted its attempts and a FAILED one is waiting out a backoff; re-driving either resets its attempt count so it gets a full budget again rather than dying on the next failure, and hastens a sweep so it is picked up now instead of at the next scheduled window. Returns 409 when the item is not in a state an operator may act on — notably while a pass still holds its claim.

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.