Get session events

GET

/v1/sessions/:session_id/events

GET

/v1/sessions/:session_id/events

$ curl -G https://api.loreos.app/v1/sessions/00000000-0000-0000-0000-000000000000/events \
>      -H "Authorization: Bearer <token>" \
>      -d since=2 \
>      -d limit=100

1 {
2   "schema_version": "v0",
3   "data": {
4     "session_id": "00000000-0000-0000-0000-000000000000",
5     "events": [
6       {
7         "id": "44444444-4444-4444-4444-444444444444",
8         "schema_version": "v0",
9         "cursor": 3,
10         "session_id": "00000000-0000-0000-0000-000000000000",
11         "tenant_id": "55555555-5555-5555-5555-555555555555",
12         "app_id": "66666666-6666-6666-6666-666666666666",
13         "external_user_ref": "user_123",
14         "type": "run.status",
15         "event_type": "run.status",
16         "role": "character",
17         "trace_id": "trace_0000000000000000",
18         "created_at": "2026-06-19T09:04:01Z",
19         "payload": {
20           "status": "generating",
21           "run_ref": "trace_0000000000000000"
22         },
23         "source_ref": {}
24       },
25       {
26         "id": "77777777-7777-7777-7777-777777777777",
27         "schema_version": "v0",
28         "cursor": 4,
29         "session_id": "00000000-0000-0000-0000-000000000000",
30         "tenant_id": "55555555-5555-5555-5555-555555555555",
31         "app_id": "66666666-6666-6666-6666-666666666666",
32         "external_user_ref": "user_123",
33         "type": "message.created",
34         "event_type": "message.created",
35         "role": "character",
36         "trace_id": "trace_0000000000000000",
37         "created_at": "2026-06-19T09:04:10Z",
38         "payload": {
39           "text": "It works.",
40           "bubbles": [
41             "It works."
42           ]
43         },
44         "source_ref": {
45           "interaction_turn_id": "88888888-8888-8888-8888-888888888888"
46         }
47       }
48     ],
49     "next_cursor": 4
50   },
51   "next_actions": [
52     {
53       "command": "GET /v1/sessions/00000000-0000-0000-0000-000000000000/events?since=4",
54       "description": "Poll again for newer events"
55     }
56   ]
57 }

Cursor-poll the session event log. Returns events with cursor > since in order; poll again with since=next_cursor. Polling is the universal fallback; an SSE stream (GET …/events/stream) and signed webhook push (POST …/channels) project the same log.

Authentication

AuthorizationBearer

LoreOS runtime API key (ck_...), sent as Authorization: Bearer <key>.

Path parameters

session_idstringRequired

Query parameters

sinceintegerOptional>=0Defaults to 0

limitintegerOptional1-500Defaults to 100

Response

Successful Response

schema_version"v0"

LoreOS success-envelope version.

dataobject

next_actionslist of objects

Concrete follow-up API actions; empty when no action is required.

Errors

422

Unprocessable Entity Error