get_run_output

Use get_run_output for named JSON, projections, continuation, streams, or lineage; query_data for SQL; get_run(summary=true) for KPIs. For dependency traces pass output_name and trace_selector (metric_name, json_pointer, or node_id); no sheet or run is created. Show known outputs with present_run_output(run_id, output_name) without pre-reading.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
run_id	Annotated[str, Field(description='UUID of a completed model run, or a short UUID prefix. Use list_runs to discover run IDs.')]	Yes	—
output_name	`Annotated[str	None, Field(description=“Key in the run’s outputs dict to retrieve (e.g. ‘forecast.json’ or ‘revenue’). Provide exactly one of output_name or stream.”)]`	No	None
encoding	Annotated[Literal['auto', 'json', 'text', 'base64'], Field(description="How to encode the returned content: 'auto' (default) sniffs content type; 'json' returns raw JSON; 'text' returns text; 'base64' returns base64-encoded bytes.")]	No	'auto'
stream	`Annotated[Literal[‘stdout’, ‘stderr’]	None, Field(description=‘Retained run stream to retrieve in bounded pages. Provide exactly one of stream or output_name.’)]`	No	None
projection	`Annotated[str	None, Field(description=‘RFC 6901 JSON Pointer evaluated within the selected named output. Use an empty string for its root. Valid only with output_name.’)]`	No	None
offset	Annotated[int, Field(description='Zero-based retained-byte offset for a stream page, or item offset for a projected named-output page. Follow the prior continuation.')]	No	0
limit_items	Annotated[int, Field(description=f'Maximum array items or object members in a projected named-output page (1–{MAX_JSON_PROJECTION_ITEMS}). Ignored for streams and unprojected output.')]	No	DEFAULT_JSON_PROJECTION_ITEMS
limit_bytes	Annotated[int, Field(description=f'Maximum raw stream bytes or compact-JSON projected bytes in one page (4–{MAX_STREAM_PAGE_BYTES}). Ignored for unprojected named output.')]	No	DEFAULT_STREAM_PAGE_BYTES
trace_selector	`Annotated[GetRunOutputTraceSelector	None, Field(description=‘Optional bounded read-only lineage view for one metric alias, JSON Pointer, or authored node in the selected output. Include input_node_id to check whether that input has a declared path to the selected result.’)]`	No	None
workspace_id	`Annotated[str	None, Field(description=ID_BACKED_WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• run_id (string)
• model_name (string)
• output_name (string)
• resolved_output_name (string)
• content (array<object>)
• encoding (string)
• size_bytes (integer)
• truncated (boolean)
• resolution_path (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_run_output",
  "arguments": {
    "run_id": "66666666-6666-6666-6666-666666666666",
    "output_name": "revenue",
    "encoding": "auto"
  }
}

Response

{
  "run_id": "66666666-6666-6666-6666-666666666666",
  "model_name": "forecasts",
  "output_name": "revenue",
  "resolved_output_name": "revenue",
  "content": [
    {
      "month": "2026-01",
      "revenue": 100
    },
    {
      "month": "2026-02",
      "revenue": 110
    }
  ],
  "encoding": "json",
  "size_bytes": 78,
  "truncated": false,
  "resolution_path": "literal"
}

Notes

• Module: Execution
• Requires an authenticated Bridge Town session (OAuth) or an API token.
• When get_run returns truncated: true, call this tool directly with a name from output.outputs_index — do not re-call get_run or ask the user which output to fetch first.