Skip to main content
GET
List sessions

Query Parameters

cursor
string

Opaque pagination cursor from a previous page's nextCursor or prevCursor.

Maximum string length: 1024
limit
integer
default:25

Maximum items per page.

Required range: 1 <= x <= 100
repository
string

Filter to sessions bound to this repository path.

Maximum string length: 4096
status
enum<string>

Filter by session status.

Available options:
idle,
running,
waiting,
archived

Filter to sessions whose title contains this text, matched case-insensitively. It exists so a client can reach a session by name past whatever prefix of the list it has read: a picker that filters the newest few hundred rows it holds cannot find a conversation from three months ago, and only the host can. Combines with the other filters.

Maximum string length: 512

Response

One page of sessions.

One page of sessions.

items
object[]
required
limit
integer
required
Required range: x >= 1
nextCursor
string

Cursor for the next page; absent on the last page.

prevCursor
string

Cursor for the previous page; absent on the first page.