FruxonDocs
AgentsExecution Records

Gets the whole spawn tree this execution belongs to, in one request.

Returns every run descending from this execution's root — the run itself, whatever spawned it, and every sub-task or consult anywhere beneath — in pre-order with a depth on each node, plus rollups (run count, failures, combined cost, wall-clock span) computed across the tree. This is the whole-session view that `/children` can only serve one level at a time. Because the tree is resolved from the shared root rather than walked link by link, it is neither depth-capped nor truncated, and it does not lose the branches that belong to another agent — a consult child runs under the *consulted* agent, so a level-by-level walk from here cannot see it. Each node carries its own `agentId` for navigation. A run with no lineage returns a single-node tree, not an error.

GET
/v1/tenants/{tenant}/agents/{agent}/executionRecords/{executionRecord}/tree

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

executionRecord*string

Any execution in the tree — the anchor, not necessarily the root.

tenant*string

The tenant identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/executionRecords/string/tree"
{
  "rootExecutionId": "00000000-0000-0000-0000-000000000000",
  "nodes": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "parentExecutionRecordId": "00000000-0000-0000-0000-000000000000",
      "parentAsyncOperationId": "00000000-0000-0000-0000-000000000000",
      "depth": 0,
      "runType": "ROOT",
      "status": "IN_PROGRESS",
      "startTime": 0,
      "endTime": 0,
      "durationMs": 0,
      "totalCost": 0,
      "creditsCharged": 0,
      "subject": "string",
      "trigger": {
        "type": "UNSPECIFIED",
        "id": "string",
        "provider": "string",
        "triggerFireAttemptId": null,
        "participantId": null,
        "displayName": "string",
        "participantDisplayName": "string",
        "participantKind": null,
        "participantAvatarFileId": "string",
        "pipelineId": null
      }
    }
  ],
  "totals": {
    "runs": 0,
    "failed": 0,
    "cost": 0,
    "credits": 0,
    "elapsedMs": 0
  }
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets the detailed trace of a specific execution.

Returns the full execution trace including all intermediate steps, tool calls, AI model interactions, and timing breakdowns.

Gets the agent's judge-verdict counts (+ average score) for the operator overview Quality card.

Returns passed / failed / scored counts, the average run-level score, and a pass rate over the requested origin + window. Null/null window covers all time; otherwise it defaults to 30 days before to, mirroring the cost-timeseries windowing so the surfaces reconcile.