---
title: "Get an agent run"
description: "Read one run: what started it, its caps, the approvals it is waiting on, and — once it is terminal — what it cost. Every brain run is read here: an ask, a skill run, a routine run."
url: https://docs.roasos.com/api-reference/agent/getAgentRun
---

# Get an agent run

Read one run: what started it, its caps, the approvals it is waiting on, and — once it is terminal — what it cost. Every brain run is read here: an ask, a skill run, a routine run.

## `GET /v1/agent-runs/{id}`

Endpoint: `GET https://api.roasos.com/v1/agent-runs/{id}`

Get an agent run

Read one run: what started it, its caps, the approvals it is waiting on, and — once it is terminal — what it cost. Every brain run is read here: an ask, a skill run, a routine run.

### Parameters

- `id` (path) — required

### Responses

- `200`: Agent run projection
- `400`: The run ID is not a UUID
- `404`: Run not found in this workspace
- `503`: The run projection is temporarily unavailable

Read the full reference at https://docs.roasos.com/api-reference/agent/getAgentRun.