Skip to content
Letta Platform Letta Platform Letta Docs
Sign up
API Reference
Runs
Trace

Retrieve Trace For Run

get/v1/runs/{run_id}/trace

Retrieve OTEL trace spans for a run.

Returns a filtered set of spans relevant for observability:

  • agent_step: Individual agent reasoning steps
  • tool executions: Tool call spans
  • Root span: The top-level request span
  • time_to_first_token: TTFT measurement span

Requires ClickHouse to be configured for trace storage.

Path ParametersExpand Collapse
run_id: string
Query ParametersExpand Collapse
limit: optional number

Maximum number of spans to return

maximum5000
minimum1
Retrieve Trace For Run
curl https://api.letta.com/v1/runs/$RUN_ID/trace \
    -H "Authorization: Bearer $LETTA_API_KEY"
[
  {
    "foo": "bar"
  }
]
Returns Examples
[
  {
    "foo": "bar"
  }
]