---
title: "Get agent run events"
description: "The ordered lifecycle of one run: accepted, started, tool_called, gate_opened, gate_auto_approved, generation_started, settled, failed, cancelled. A run older than the timeline falls back to the steps its own timestamps can prove."
url: https://docs.roasos.com/api-reference/agent/getAgentRunEvents
---

# Get agent run events

The ordered lifecycle of one run: accepted, started, tool_called, gate_opened, gate_auto_approved, generation_started, settled, failed, cancelled. A run older than the timeline falls back to the steps its own timestamps can prove.

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

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

Get agent run events

The ordered lifecycle of one run: accepted, started, tool_called, gate_opened, gate_auto_approved, generation_started, settled, failed, cancelled. A run older than the timeline falls back to the steps its own timestamps can prove.

### Parameters

- `id` (path) — required

### Responses

- `200`: Ordered run events
- `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/getAgentRunEvents.