Session Trace

GET

/v1/sessions/:session_id/trace

GET

/v1/sessions/:session_id/trace

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

1 {
2   "schema_version": "v0",
3   "data": {
4     "session_id": "00000000-0000-0000-0000-000000000000",
5     "trace": [
6       {
7         "seq": 4,
8         "event_id": "77777777-7777-7777-7777-777777777777",
9         "run_ref": "trace_0000000000000000",
10         "type": "message.created",
11         "role": "character",
12         "created_at": "2026-06-19T09:04:10Z",
13         "text": "It works.",
14         "image_url": null,
15         "delivery_status": null,
16         "delivery_attempts": null,
17         "delivery_error": null,
18         "usage_credits": 0.0034
19       }
20     ]
21   },
22   "next_actions": []
23 }

Unified per-event trace for one session (newest first): each event with its latest push-delivery status and the turn’s settled usage credits — so inbound -> reply -> cost -> delivery is ONE read instead of stitching the events, usage, and delivery logs by hand. App-scoped (404 if the session isn’t this app’s).

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired

Query parameters

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

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error