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

Overview

This endpoint lists your sessions on models, newest first. Ended sessions are listed too, until you delete them. You see the sessions you opened from any of your API keys or your Developer Console login. A service-account key sees the sessions of every service-account key in the organization, and an organization admin sees all of the organization’s.

Request

string
Only sessions on this model, by any of its names. A name no model has returns an empty page. A removed model’s name still lists its sessions.
string
Only sessions in this status: running, completed, failed, or cancelled. Any other value returns 400.
integer
default:"100"
Page size, from 1 to 1000.
string
Forward cursor. Pass the next_cursor of the previous page to get older sessions. Can’t be combined with before.
string
Backward cursor. Pass the prev_cursor of the current page to step back. Can’t be combined with after.

Response

object[]
The page of session objects, newest first.
boolean
Whether more sessions exist beyond this page.
string | null
Cursor for the next page. null when has_more is false.
string | null
Cursor to step back to the previous page. null on a request without a cursor.

Important Notes

  • 400 means a malformed cursor or status, or both after and before.
  • Cursors are opaque. Never build one from session fields.