Skip to main content
GET
Requires version 2.0.1 or later of the Archetype platform.

Overview

This endpoint returns a page of a session’s lifecycle events, newest first. The platform records an event when the session is opened, dispatched, finished, or cancelled, and when it fails, with why. A serving session’s events also say why it ended when its deployment ended it.

Request

string
required
Session ses_ id.
integer
default:"100"
Page size. Minimum 1, maximum 1000.
string
Forward cursor: return events older than this page. Pass the previous page’s next_cursor. The cursor is opaque: never compute on it. Mutually exclusive with before.
string
Backward cursor: return events newer than this page. Opaque, as after is. Mutually exclusive with after.

Response

array
required
The page, newest first.
boolean
required
True when more events exist beyond this page in the direction of travel.
string
Cursor for the next page in the same direction. Pass it as after when paging forward, or as before when you supplied before. null when has_more is false.
string
Cursor to step back the way this page was reached. Pass it as before after a forward page, or as after after a backward one. null when the request carried no cursor.

Event object

string
required
Severity of the event: info, warning, or error.
string
required
What happened: the session was dispatched, finished, was cancelled, or failed and why.
string
required
When the event was recorded (date-time).

Important Notes

  • Passing both after and before returns 400, as does a malformed cursor.
  • A 404 means the session does not exist, belongs to another organization, or is in a project you cannot see.
  • Events are the platform’s record of the session’s lifecycle, not its job’s log lines.