Levain LabsLevain Labs
ApiSessions

Get Session Events

Tail a session: events since since plus state snapshots.

Returns events newer than since along with the session's current state, last_activity_at, and an authoritative per-round summary. Designed for short-poll loops — consumers can render straight from the response without deriving run lifecycle from event payloads.

GET
/api/v1/sessions/{session_id}/events

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

session_id*Session Id
Formatuuid

Query Parameters

since?Since
Default0

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

curl -X GET "https://api.levainlabs.com/api/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/events"
{
  "state": "string",
  "last_activity_at": "string",
  "rounds": [
    {
      "run_id": "string",
      "started_at": "string",
      "finished_at": "string",
      "status": "string",
      "user_prompt": "string",
      "error": "string"
    }
  ],
  "events": [
    {
      "sequence_no": 0,
      "type": "string",
      "payload": {},
      "created_at": "string"
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}