List sessions
GET /v1/sessions
| Param | Type | Description |
|---|---|---|
userId | string | Filter by user |
status | string | active, dropped, stopped |
from | ISO date | Start of date range |
to | ISO date | End of date range |
limit | number | Max results (default: 20, max: 100) |
{
"sessions": [
{
"id": "sess_8xK2mP9q",
"userId": "alice@acme.com",
"score": 94,
"status": "active",
"context": "dashboard",
"startedAt": "2026-04-28T14:32:08Z"
}
],
"total": 128,
"cursor": "sess_3mL7zR2x"
}
Get a session
GET /v1/sessions/:id
{
"id": "sess_8xK2mP9q",
"userId": "alice@acme.com",
"score": 94,
"status": "active",
"context": "dashboard",
"signals": 1243,
"interventions": 0,
"startedAt": "2026-04-28T14:32:08Z",
"updatedAt": "2026-04-28T14:46:21Z"
}