List sessions

GET /v1/sessions

Permission: read:sessions
Tokens: API key, CLI user token, Session token

List sessions with filters for time, source, service, handler, agent, and attribution.

Query parameters

agentstring

An agent id, or its name: only sessions that agent started.

sourcearray<SessionSource>

serviceenum

Service that triggered the session. Includes built-in responders and legacy sessions without a saved handler.

one ofslackgithublinearsentry

handlerstring

Saved handler id captured when the session started.

daysinteger

startstring, date-time

endstring, date-time

limitdefault 50integer

cursorstring

author_idinteger

A GitHub account id (see GET /v1/integrations/github/members); scopes the list to sessions attributed to that developer.

repostring

"owner/name" (exact) or a bare repo name. Sessions whose repository is named only inside their agent , dashboard starts, cron , do not match.

unfinisheddefault falseboolean

Keep only sessions whose current turn is pending or running.

{

"has_more": bool,

"next_cursor": str,

}

Response

has_moredefault falseboolean

Whether more results exist past this page.

next_cursorstring

Pass as `cursor` to fetch the next page. Null on the last page. Opaque , echo it back rather than parsing it.

pull_requestsobject

sessionsarray<Session>required

Lean wire rows , the same shape GET /v1/sessions/{id} and the stream's session frames carry. The heavy blobs (config snapshot, input/output) live on the detail endpoints.

turn_countsobject

Query parameters

Response

On this page