---
title: "List persisted agent run events"
method: GET
path: "/v1/agent/runs/{run_id}/events"
tags: ["Agent Runtime"]
---

# List persisted agent run events

`GET /v1/agent/runs/{run_id}/events`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/agent/runs/{run_id}/events`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `run_id` string, uuid, required

## Query parameters

- `limit` integer
- `stream` boolean

## Response `200`

JSON event list by default, or Server-Sent Events stream when stream=true.

- AgentRunEventsResponse
  - `object` string
  - `run_id` string, required
  - `data` AgentRunEvent[], required
    - `event_id` string, required
    - `event_type` string, required
    - `status` string, required
    - `message` string, required
    - `created_at` string, date-time, required
    - `details` object
  - `total_events` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)