---
title: "List Events"
method: GET
path: "/events"
tags: ["Events"]
---

# List Events

`GET /events`

List events for a specific task and agent.

Optionally filter for events after a specific sequence ID.
Results are ordered by sequence_id.

## Query parameters

- `last_processed_event_id` string, nullable — Optional event ID to get events after this ID
- `limit` integer, nullable — Optional limit on number of results
- `task_id` string, required — The task ID
- `agent_id` string, required — The agent ID

## Response `200`

Successful Response

- Event[]
  - `agent_id` string, required — The UUID of the agent that the event belongs to
  - `content` union — The content of the event (TextPart or DataPart)
    - TextPart — Text content part.
      - `text` string, required — The text content
      - `type` 'text' — Part type discriminator
    - DataPart — Generic data part for unknown/passthrough content.
      - `data` unknown, required
      - `type` 'data' — Part type discriminator
  - `created_at` string, date-time, nullable — The timestamp of the event
  - `id` string, required — The UUID of the event
  - `sequence_id` integer, required — The sequence ID of the event
  - `streamCapabilities` string[], nullable — Server-advertised stream lifecycle capabilities for this event
  - `task_id` string, required — The UUID of the task that the event belongs to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)