Get workflow run traces
get_workflow_run_tracesGet the full per-step execution trace of a run by run id (paged). Each step lists its blocks with the input each consumed and the output it produced, plus any error_message, and the variable scope captured at that step. Use this to debug why an expression or block produced the wrong value. Large captured values are shortened, with a marker saying so: a scope entry may point at the block output beside it rather than repeat it (the value is in the same trace). On UNATTENDED runs only — a live endpoint serve, a schedule falling due — text copied verbatim from the definition (a literal expression) is also replaced by its path there; read it with get_workflow_version. Those runs are shortened harder overall too, so to capture a value in full, re-run it yourself (run_workflow / preview_dynamic_endpoint / run_schedule_now) — runs you trigger keep everything, literals included. A loop block, and an llm block with tools (an agent), lists iterations: each loop iteration or agent turn with the blocks it ran (iterations_total is how many actually ran; a long run keeps the first and last and may drop some between). A run with many or large steps stores some of them with it, from its start and its end (a sub-workflow's steps count, one each), and keeps the complete set separately for two weeks; these pages read the complete set when there is one, and trace_truncated says only part of the run was stored with it. For an agent turn the first block is an llm block recording that one model call — its output carries stop_reason, input/output tokens, tool_calls and the start of the reply, and started_at/finished_at give how long the call took — followed by the tools it called.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | the run id returned by run_workflow | |
| page_size | No | maximum number of step traces to return in this page | |
| page_token | No | token from a previous response's next_page_token to fetch the next page |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | Yes | ||
| next_page_token | Yes |