FruxonDocs
Agent NetworkTriggers

Every run one item caused, across all of its stages.

The item's combined execution record: each claim of the item as an attempt — its stage, what the ledger made of it — with the runs it caused, and the whole set as one run tree. It reaches runs the transition log never names: the one running now, one whose lease ran out before it finished, and the sub-tasks and consults a stage agent spawned. Totals are the item's own: its runs and their children, and its share of each batch run it was a member of. Run summaries only. A run's trace is read through its agent, under that agent's own access check.

GET
/v1/tenants/{tenant}/triggers/{trigger}/ledger/items/{item}/runs
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

representation?string

The requested view. Original history requires verified sources in a Legacy workspace.

Default"AUTOMATIC"
Value in"UNSPECIFIED" | "SAFE" | "MASKED" | "ORIGINAL" | "AUTOMATIC"

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/runs"
{
  "itemId": "f11b669d-7201-4c21-88af-d85092f0c005",
  "itemKey": "string",
  "label": "string",
  "status": "UNSPECIFIED",
  "stageId": "string",
  "admittedAt": 0,
  "terminalAt": 0,
  "totals": {
    "cost": 0.1,
    "runs": 0,
    "elapsedMs": 0,
    "waitingOnPeopleMs": 0,
    "waitingOnTimeMs": 0,
    "truncatedByRetention": true
  },
  "attempts": [
    {
      "claimToken": "0af054b7-7705-4d1d-ad73-930d88e7cb87",
      "stageId": "string",
      "stageName": "string",
      "attempt": 0,
      "claimedAt": 0,
      "outcome": {
        "cause": "string",
        "toStatus": "UNSPECIFIED",
        "detail": "string",
        "executionRecordId": "d8c229ad-5dbe-4d6d-a9d6-0d84bee34375",
        "at": 0
      },
      "runIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "missingRunIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "cost": 0.1,
      "runs": 0,
      "batch": {
        "batchRunId": "a74c20d6-643b-4445-9430-2d7b7d7f915e",
        "memberCount": 0
      },
      "ask": {
        "batchId": "5579c111-9c50-47e2-af92-f16d52e63189",
        "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21",
        "settledCause": "string",
        "settledAt": 0,
        "waitingMs": 0
      },
      "wait": {
        "wakeAt": 0,
        "settledCause": "string",
        "settledAt": 0,
        "waitingMs": 0
      }
    }
  ],
  "tree": {
    "rootExecutionId": "26628fc2-6868-4a41-b37d-eccf8e413d65",
    "nodes": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "agentId": "string",
        "rootExecutionId": "26628fc2-6868-4a41-b37d-eccf8e413d65",
        "parentExecutionRecordId": "e7a69e62-8b51-4d78-a24b-b091282d1fb6",
        "parentAsyncOperationId": "3551cf93-e880-485a-be20-519cc8437037",
        "depth": 0,
        "joinedByConversation": true,
        "runType": "UNSPECIFIED",
        "status": "UNSPECIFIED",
        "startTime": 0,
        "endTime": 0,
        "durationMs": 0,
        "totalCost": 0,
        "creditsCharged": 0,
        "subject": "string",
        "trigger": {
          "type": "UNSPECIFIED",
          "id": "string",
          "provider": "string",
          "triggerFireAttemptId": "c6e920dd-a0e0-421a-add7-39f14cc8f9ee",
          "participantId": "9f6624b5-5f99-42b6-899f-30f2b369cbd7",
          "displayName": "string",
          "participantDisplayName": "string",
          "participantKind": "UNSPECIFIED",
          "participantAvatarFileId": "string",
          "pipelineId": "621ef2b0-ba1d-48e5-89dc-b778e6ed42fd",
          "ledgerItemId": "e699cc8c-0d8a-4133-978c-1822d2b9d6c4",
          "ledgerBatchId": "312b24b1-2e90-4846-b858-106188d9e768"
        }
      }
    ],
    "totals": {
      "runs": 0,
      "failed": 0,
      "cost": 0.1,
      "credits": 0,
      "elapsedMs": 0,
      "truncatedByRetention": true
    }
  },
  "unpairedRunIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "truncated": true,
  "metadata": {
    "contentVisibility": "UNSPECIFIED",
    "redactedFields": [
      "string"
    ],
    "canReadOriginal": true,
    "policyVersions": {
      "property1": 0,
      "property2": 0
    },
    "profile": "string"
  }
}
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
}

Returns a stuck or excluded work item to the queue.

The dead-letter escape hatch. A DEAD item has exhausted its attempts, a FAILED one is waiting out a backoff, and an IGNORED one was set aside by a business rule; re-driving any of the three 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. The item returns to the stage it left, exclusions included. Returns 409 when the item is not in a state an operator may act on — notably while a pass still holds its claim. Protected responses return verified IDs with withholding metadata. Protected history records the operation with a fixed description where required.

Corrects a stuck or excluded work item's data, optionally re-driving it.

For a value an earlier stage recorded wrong — an ASK answer written as `SKIP` for a reply that said otherwise — which a re-drive alone would route on again. `set` maps paths to JSON values: a top-level key the item carries (or a declared path's root), or a dotted path a stage declares in `produces` or as an ASK stage's `answeredWhenPath`. A declared path takes only values its declaration allows — its type, null only when nullable, and for a form-asked answer only what the form accepts. Anything else is 400, naming what is settable. The reason is required. The correction is recorded as an `OPERATOR_SET_DATA` transition whose detail is the reason followed by each path's old and new value (credential-named paths masked); the status does not move. A correction that changes nothing records nothing. With `redrive: true` the item is also re-driven in the same transaction, exactly as `:redrive` does. Protected corrections require separately approved paths and non-null scalar values. They return the verified item and ledger IDs with withholding metadata. Their history records the operation without the reason or old and new values. Only DEAD, FAILED or IGNORED items: 409 otherwise, and 409 when the item changed between the read and the write.