FruxonDocs
Agent NetworkTriggers

Lists the automation's work items.

The Work view's item grid. Filter by stage and status; the UI defaults to DEAD + FAILED first, because the dead-letter queue is the reason this view exists.

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

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

stageId?string

Optional stage filter.

status?string

Optional status filter.

Value in"UNSPECIFIED" | "READY" | "CLAIMED" | "WAITING" | "DONE" | "FAILED" | "DEAD" | "IGNORED"

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/items"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "ledgerId": "00000000-0000-0000-0000-000000000000",
      "itemKey": "string",
      "label": "string",
      "stageId": "string",
      "status": "READY",
      "stageAttempts": 0,
      "nextAttemptAt": 0,
      "lastError": "string",
      "admittedAt": 0,
      "terminalAt": 0,
      "lastExecutionRecordId": "00000000-0000-0000-0000-000000000000",
      "data": null
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Item counts per stage and status.

The stage funnel — design §6.5's accounting query as an endpoint, so "15 items sat in awaiting_destination for 3 days" is visible at a glance instead of being a memory blob someone has to know to read.

One item's durable side effects, and how sure the platform is about each.

What this item has done to the outside world. The status that matters is `UNKNOWN`: a previous attempt left the record open, so the platform refuses to repeat the effect and the item cannot pass its stage — re-driving it hits the same refusal. Those rows carry `canSettle`, and `:settle` is how a person who has gone and looked ends the doubt. `docs/design/item-ledger.md §6.4`.