Covendocs
API ReferenceEventsRead append-only session events GET
Report issue

Read append-only session events

Read append-only events for a session, with cursor-based pagination for incremental reads.

1 min read

GET
/events

Query Parameters

sessionId*string

Session id whose events should be returned.

afterSeq?integer

Preferred cursor. Returns events with seq > afterSeq.

Range0 <= value
afterEventId?string

Compatibility cursor, resolved by the daemon to a sequence position.

limit?integer

Maximum number of events to return. The daemon enforces a maximum of 1000.

Default100
Range1 <= value <= 1000

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/events?sessionId=session-1"
{
  "events": [
    {
      "seq": 42,
      "id": "event-1",
      "session_id": "session-1",
      "kind": "output",
      "payload_json": "{\"data\":\"hello\"}",
      "created_at": "2026-05-09T06:43:10.000Z"
    }
  ],
  "nextCursor": {
    "afterSeq": 42
  },
  "hasMore": false
}
{
  "error": {
    "code": "invalid_request",
    "message": "Required field \"sessionId\" is missing.",
    "details": {
      "field": "sessionId"
    }
  }
}
{
  "error": {
    "code": "session_not_found",
    "message": "Session was not found.",
    "details": {
      "sessionId": "session-1"
    }
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "Unexpected internal daemon error.",
    "details": {}
  }
}
Was this page helpful?No