コンテンツにスキップ
Subako Docs
日本語
English日本語未翻訳
Esc
↑↓移動↵開く⌘Jプレビュー

List session events

The session’s log, read a page at a time. For a live view use the stream route, which renders the same 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
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
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
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
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
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
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
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
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
}