FruxonDocs
AgentsExecution Records

Gets the execution trace projected at read time from the raw OTel spans archived during ingest.

Rebuilds the step tree from the execution's stored raw spans with the current trace mapper, so mapper improvements reach existing executions without a re-run. Returns a `rawSpanCount` of 0 and no traces when the execution produced no OpenTelemetry spans (native agents, or external runs that emitted none); use `/trace` in that case.

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

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

The execution record identifier.

tenant*string

The tenant identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/executionRecords/string/projectedTrace"
{
  "executionRecordId": "00000000-0000-0000-0000-000000000000",
  "rawSpanCount": 0,
  "traces": [
    {
      "id": "string",
      "displayName": "string",
      "type": "TOOL",
      "llmStepTrace": {
        "providerId": "string",
        "model": "string",
        "inputTokens": 0,
        "outputTokens": 0,
        "cachedTokens": 0,
        "cacheWriteTokens": 0,
        "thinkingTokens": 0,
        "webSearchCalls": 0,
        "finishReason": "UNSPECIFIED",
        "inputCost": 0,
        "outputCost": 0,
        "cachedCost": 0,
        "cacheWriteCost": 0,
        "thinkingCost": 0,
        "webSearchCost": 0,
        "totalCost": 0,
        "providerReportedCost": null,
        "tools": [],
        "systemInstructions": [],
        "systemPromptHash": "string",
        "llmMessages": [],
        "llmCallCount": 0,
        "llmCalls": [],
        "promptComposition": null,
        "serverToolInvocations": [],
        "reasoningBlocks": [],
        "knowledgeNotices": null,
        "systemBlocks": null,
        "systemCacheBreakpointIndex": null,
        "judgeDowngradedFrom": null,
        "toolLoopsDowngradedFrom": null
      },
      "toolTrace": {
        "tool": null,
        "displayName": "string",
        "toolType": "UNSPECIFIED",
        "parameters": {},
        "secretParameters": null,
        "cost": null,
        "resultDelivery": null,
        "asyncOperationId": null,
        "upstream": null,
        "asyncDelivery": null,
        "prefetch": null
      },
      "hitlTrace": {
        "requestId": "00000000-0000-0000-0000-000000000000",
        "gateType": "UNSPECIFIED",
        "toolKey": "string",
        "stepIdentifier": "string",
        "requestedAt": 0,
        "respondedAt": null,
        "respondedBy": "string",
        "decision": null,
        "responseText": "string",
        "outboundMessage": "string",
        "proposedParameters": null,
        "deliveryRoute": null,
        "correlationToken": "string",
        "durationMs": null
      },
      "steps": [],
      "result": {
        "strValue": "string",
        "jsonValue": null,
        "fileLink": "string",
        "flowControl": null
      },
      "status": "SUCCESS",
      "error": "string",
      "startTime": 0,
      "endTime": 0,
      "duration": 0,
      "creditsCharged": 0
    }
  ]
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets the execution trace in OTLP/HTTP JSON format.

Returns the trace as an `ExportTraceServiceRequest` compatible with the OpenTelemetry Collector, Jaeger, Grafana Tempo, and other OTLP-compatible backends.

Gets the raw OTLP spans archived for this execution.

Returns each span as we received it from the customer's tracer, no platform mapper applied. Used by the trace sidebar's "raw OTel" view and by external tooling driven off the source-of-truth (mapper validation, attribute audits). Empty `spans` array means the execution didn't go through OTLP ingest (native agent, or external run that emitted no spans).