Skip to main content
GET
List captured sessions visible to the caller

Authorizations

Authorization
string
header
required

OAuth 2.0 access token obtained through RFC 8628 at /api/auth/device/code and /api/auth/oauth2/token. The API enforces governance:read, session:write, and client-status:write as appropriate.

Query Parameters

limit
integer
Required range: 1 <= x <= 100
cursor
string<uuid>
page
integer
default:1
Required range: x >= 1
per_page
integer
default:25
Required range: 1 <= x <= 100
q
string

Case-insensitive literal substring matched against native session ID and working directory.

Maximum string length: 200
harness
string
user_id
string<uuid>
status
enum<string>
Available options:
pending,
complete,
superseded,
failed
updated_from
string<date>

Inclusive UTC calendar date.

updated_to
string<date>

Inclusive UTC calendar date.

sort
enum<string>
default:updated_desc
Available options:
updated_desc,
updated_asc
resumable
boolean

Return only owned or explicitly shared portable sessions; administrator audit access is not applied.

Response

A cursor page or numbered page of database-registered captured sessions

items
object[]
required
next_cursor
string<uuid> | null
page
integer
per_page
integer
total
integer
total_pages
integer