Skip to main content
GET
Get a session timeline

Authorizations

Authorization
string
header
required

A project token (apsio_pt_v0...), which reads exactly one project, or an OAuth access token issued for the API, which reads what its user can. Access tokens issued for Apsio's MCP server are accepted only from the MCP server itself.

Path Parameters

projectId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000a101"

sessionId
string
required
Pattern: ^[A-Za-z0-9_-]{1,128}$
Example:

"7f3c9b02-5d1e-4a8b-9c0f-2e6a1d4be19a"

Query Parameters

limit
integer
default:200

Page size, 1 to 1000.

Required range: 1 <= x <= 1000
Example:

200

cursor
string

The next_cursor of the previous page. Opaque.

Maximum string length: 1024
app_id
string

Only this app. Session ids are random UUIDs, so this matters only if two apps of the project share one.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

The session.

session_id
string
required

session.id, as the app sent it. Written by the app: untrusted data.

summary
object | null
required

Null when no summary arrived for the session (yet).

events
object[]
required
next_cursor
string | null
required

Pass as cursor to get the next page; null on the last page.