---
title: getNodeOutput
description: Gateway RPC for task output inspection.
maturity: stable
apiVersion: v1
---

- Method: `getNodeOutput`
- Scope: `run:read`
- Transports: HTTP RPC, WebSocket RPC
- Request: `{ runId, nodeId, iteration? }`
- Response: `NodeOutputResponse`

A `failed` response carries `error` (why the node failed, from the latest
attempt's stored error): `{ name?, code?, message, attempt? }` (message capped
at 4000 chars). It is `null` when no attempt error was recorded.

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `RunNotFound`, `NodeNotFound`, `IterationNotFound`, `NodeHasNoOutput`, `PayloadTooLarge`, and `Internal`.
