FruxonDocs
Agent NetworkTriggers

Lists what the automation is waiting on a human for.

Each batch is one shared question with a set of items waiting on its answer. It is the operator's awaiting-human entry, and its waiting count is the number an operator reads.

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

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 pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

openOnly?boolean

Only batches still awaiting an answer.

Defaultfalse

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/batches"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "ledgerId": "00000000-0000-0000-0000-000000000000",
      "stageId": "string",
      "status": "OPEN",
      "deliveryMode": "DIRECT",
      "waitingCount": 0,
      "draftCount": 0,
      "artifact": null,
      "topicId": "00000000-0000-0000-0000-000000000000",
      "conversationState": "ACTIVE",
      "conversationResolution": "GOAL_MET",
      "conversationEndedAt": 0,
      "conversationEndedUnanswered": false,
      "conversationParticipantName": "string",
      "question": "string",
      "delivery": "DELIVERED",
      "deliveryDetail": "string",
      "slotName": "string",
      "expiresAt": 0,
      "gatheringUntil": 0,
      "lastJoinedAt": 0,
      "resolvedAt": 0,
      "createdAt": 0,
      "detail": "string"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Returns a single trigger with its current agent bindings.

Fetches one trigger by id, including the set of agents it currently fires. Returns 404 when no trigger with that id exists in the tenant.

Reads what one batch question was answered with, item by item.

One row per item the batch held: the value it was handed back (`answer`) beside what the person gave for it (`given`) — the sheet cell or the words in their message, as the agent conducting the conversation copied them; a direct question's reply; a form's field — and where the item is now. The two differ exactly where an answer went wrong, which is the question this read exists for. `topicAgentId` is the agent the batch's conversation belongs to — the stage's asking agent, not the one that talked to the person (`conductorAgentId`) — and is the agent to read its transcript under. A batch answered before answers were recorded has `recorded` false: its values are read back off its conversation's result, with no per-item time.