---
title: "Get agent run status"
description: "The light poll: the run id, its status, and when it last changed."
url: https://docs.roasos.com/api-reference/agent/getAgentRunStatus
---

# Get agent run status

The light poll: the run id, its status, and when it last changed.

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

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

Get agent run status

The light poll: the run id, its status, and when it last changed.

### Parameters

- `id` (path) — required

### Responses

- `200`: Agent run status
- `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/getAgentRunStatus.