FruxonDocs
Agent NetworkTriggers

Deliberately excludes every work item in a selection, with one reason.

"Drain this stage" is this verb with a stage filter. Same selection and confirmation rules as the re-drive; only READY, FAILED and DEAD items qualify, never one a pass holds. An explicit-id selection gets the same `skipped` list, naming what was left alone and why.

POST
/v1/tenants/{tenant}/triggers/{trigger}/ledger/items:ignore

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

Request Body

The selection, the required reason, and the confirmed count.

selection*

What to exclude. Required.

reason*string

Why — required, recorded on every item and transition.

Length1 <= length <= 4000
confirmCount*integer
Formatint32
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/items:ignore" \  -H "Content-Type: application/json" \  -d '{    "selection": {},    "reason": "string",    "confirmCount": 0  }'
{
  "matched": 0,
  "affected": 0,
  "skipped": [
    {
      "itemId": "00000000-0000-0000-0000-000000000000",
      "itemKey": "string",
      "status": "READY",
      "reason": "NOT_FOUND"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets one cohort, with its progress and cost so far.

Progress is counted from the members now, so it keeps moving after the cohort settles — a redriven item shows here without re-running anything. Also carries the frozen snapshot the follow-up ran over, a sampled cohort's estimate, any budget windows raised for it, and the steps of its current follow-up.

One item of the automation's ledger.

The same row `ledger/items` lists, for a caller holding a link to one item rather than a page of them — a run's trace pointing back at the item it processed, a deep link into the Work view.