---
title: "Read a page of durable step metadata"
method: GET
path: "/v1/sandboxes/{id}/agent-runs/{run_id}/steps"
tags: ["Sandboxes"]
---

# Read a page of durable step metadata

`GET /v1/sandboxes/{id}/agent-runs/{run_id}/steps`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/sandboxes/{id}/agent-runs/{run_id}/steps`
- Auth: HTTP bearer

Unknown external effects block the run until explicitly resolved using independent evidence.

## Path parameters

- `id` string, required
- `run_id` string, required

## Query parameters

- `after` string
- `limit` integer

## Response `200`

Success

- AgentStepPage
  - `steps` AgentStep[], required
    - `checkpoint_id` string: Verified ready or committed state captured for this step's fenced claim. A completed reconciliation must explicitly select matching state when checkpoint recovery is enabled.
    - `checkpoint_status` 'ready' | 'committed': Publication status of the matching checkpoint candidate. Ready files are verified but do not yet replace committed recovery state.
    - `step_id` string, required
    - `name` string, required
    - `version` string, required
    - `effect` 'external' | 'pure' | 'idempotent', required
    - `status` 'started' | 'completed' | 'failed' | 'unknown' | 'expired', required
    - `revision` integer, required
    - `attempts` integer, required
  - `next_after` string

## Other responses

- `default`: Operation refused. Unavailable capability is reported while durable agents are disabled.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)