FruxonDocs
Agent NetworkTriggers

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.

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

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.

status?string

Only cohorts in this status.

Value in"UNSPECIFIED" | "OPEN" | "SAMPLING" | "AWAITING_CONFIRMATION" | "SEALED" | "FOLLOWING_UP" | "COMPLETE" | "COMPLETE_WITH_FAILURES" | "CANCELLED"

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/cohorts"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "key": "string",
      "source": "DOOR",
      "name": "string",
      "status": "OPEN",
      "openedBy": "string",
      "createdAt": 0,
      "sealedAt": 0,
      "settleBy": 0,
      "settledAt": 0,
      "completedAt": 0,
      "partial": false,
      "sampleSize": 0,
      "confirmedAt": 0,
      "confirmedBy": "string",
      "detail": "string",
      "progress": {
        "members": 0,
        "live": 0,
        "done": 0,
        "ignored": 0,
        "dead": 0,
        "alreadyHeld": 0,
        "cells": [],
        "held": [],
        "cost": null,
        "credits": null,
        "runs": null
      },
      "snapshot": {
        "takenAt": 0,
        "members": 0,
        "done": 0,
        "setAside": 0,
        "setAsideByHand": 0,
        "dead": 0,
        "live": 0,
        "partial": false,
        "cells": [],
        "reasons": [],
        "stuckItemIds": [],
        "alreadyHeld": 0,
        "cost": 0,
        "credits": 0,
        "runs": 0
      },
      "estimate": {
        "computedAt": 0,
        "sampleSize": 0,
        "remainingCount": null,
        "countIsFloor": false,
        "perItemP50": 0,
        "perItemP90": 0,
        "perItemMax": 0,
        "creditsPerItemP90": 0,
        "totalP50": 0,
        "totalP90": 0,
        "creditsP90": 0,
        "sampleByStatus": {},
        "budgetImpact": [],
        "hash": "string",
        "insufficient": false
      },
      "budgetGrants": [],
      "followUpGeneration": 0,
      "followUps": []
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

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.

Ends the cohort without a follow-up

Any budget windows raised for it are put back, unless someone changed them since, and the automation is free for a new cohort. 409 once the cohort has settled.