List events

List everything the agent observed and did in a session, page by page.

GET /api/v2/sessions/{id}/events

Python

from hai_agents import Client

client = Client()

page = client.sessions.list_session_events(session_id, size=10)
for event in page.items:
    print(event.type, event.timestamp)

Behavior

Events come oldest first. For live tailing, use /changes. Works without a key on shared sessions.

Path parameters

id · string · required

The session ID.

Query parameters

page · integer · default: "1"

Page number (1-based).

size · integer · default: "50"

Items per page. Maximum: 200.

sort · string · default: "timestamp"

Sort order. Options: timestamp, -timestamp.

type · string

Filter by event type, for example AgentEvent or MetricsUpdateEvent.

Response

200 with a page envelope of events, each an Event object.

Python

from hai_agents import Client

client = Client()

page = client.sessions.list_session_events(session_id, size=10)
for event in page.items:
    print(event.type, event.timestamp)

Errors

Status	Cause
404	Not found, or not in your organization.