---
title: "Get run nodes"
method: GET
path: "/agent_run/{run_id}/nodes"
tags: ["Agents"]
---

# Get run nodes

`GET /agent_run/{run_id}/nodes`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/agent_run/{run_id}/nodes`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Retrieve node-level status details for a run, including node type metadata and whether any node task is currently credit-blocked.

## Path parameters

- `run_id` string, required

## Response `200`

Run nodes retrieved successfully

- AgentRunNodesResponse
  - `run_id` string, required
  - `nodes` AgentRunNode[], required
    - `agent_node_id` string, required: Runtime agent node ID for this run.
    - `original_node_id` string, nullable, required: Template agent_node_id this runtime node was cloned from.
    - `status` string, required: Current runtime status for the node.
    - `status_message` string, nullable, required: Optional status details for the node.
    - `node_type` NodeTypeSummary, required
      - `node_type_id` string, uuid
      - `node_type_name` string, nullable
      - `docs_url` string, nullable: Canonical docs page URL derived from nodes.docs_path.
      - `params_docs_url` string, nullable: Exact docs section URL derived from nodes.docs_anchor (for node params/API details).
    - `needs_credits` boolean, required: True when any runtime task attached to this node is currently marked `needs_credits`.
    - `errors` string[], required: Error messages from failed tasks in this node. Empty array when the node has no errors.

## Other responses

- `401`: Authentication failed
- `403`: Access denied
- `404`: Resource not found

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)