Skip to content
Subako Docs
Esc
↑↓navigate↵open⌘Jpreview

GET /v1/sessions/{session_id}/events

GET/v1/sessions/{session_id}/events
Authorization
AuthorizationBearer token · headerrequired
Path parameters
session_idstring<uuid>required
Session id
Query parameters
limitinteger<int64>
min 1 · max 200
after_seqinteger<int64>
Events with seq strictly greater.
before_seqinteger<int64>
Events with seq strictly less.
orderOrderParam
Newest first when omitted; the page starts at the end this names.
Allowed:ascdesc
Responses
200One page, newest first unless order=asc, keyed by seq: pass next_cursor back as before_seq when descending and after_seq when ascending. Items are the typed event vocabulary; stored rows the wire cannot render are skipped, and the cursor still advances over them.
itemsSessionEventBody[]required
Show properties
Array of SessionEventBody
seqinteger<int64>required
next_cursorinteger<int64> | nullrequired
`None` on the last page. Otherwise the last fetched row's seq in the direction of travel: pass it back as `before_seq` when descending and as `after_seq` when ascending.
400Bad limit, order, or path parameter.
errorErrorDetailrequired
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
401Missing, malformed, or invalid bearer token.
errorErrorDetailrequired
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
403A workspace credential lacking session.read. A session token carries no permissions and never lands here.
errorErrorDetailrequired
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
404No such session, or the caller cannot see it.
errorErrorDetailrequired
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://api.us.cloud.subako.ai/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/events" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "items": [
    {
      "agent_id": "string",
      "agent_version_id": "string",
      "type": "session_created",
      "seq": 0
    }
  ],
  "next_cursor": 0
}