Skip to main content
GET
List sessions
Lists the sessions visible to you, newest first by default. Returns a page envelope whose items are session summaries (fields below). Read a full session with Retrieve.

Query parameters

string[]
Filter by session status. Repeatable. Values: queued, pending, running, paused, idle, awaiting_tool_results, completed, failed, timed_out, interrupted.
string[]
Filter by agent identifier. Repeatable. Example: web-price-finder.
string
Only sessions tagged with this group.
string
Only child sessions of this parent.
string
Only sessions created by this schedule.
Case-insensitive match on the session’s first message or answer.
string
Only sessions created before this ISO 8601 timestamp.
string
Only sessions created after this ISO 8601 timestamp.
string
Only sessions that finished before this ISO 8601 timestamp.
string
Only sessions that finished after this ISO 8601 timestamp.
string
default:"me-in-organization"
Access scope: me (your sessions anywhere), me-in-organization (your sessions in the current org), organization (everyone’s sessions in the org), or me-or-organization.
integer
default:"1"
Page number (1-based).
integer
default:"10"
Items per page. Maximum: 100.
string
default:"-created_at"
Sort order. Options: created_at, -created_at.

Response

string
Session UUID.
string | null
Name of the agent that ran the session.
string
Current status.
string | null
The session’s Agent View page.
object | null
The first user message: type, message, images, files, caller_id.
string
ISO 8601 creation time.
string | null
When the agent started.
string | null
When the session reached a terminal state.
string | null
When the session’s latest event was ingested (agent steps, status changes, user messages), to spot which live sessions are moving. null for sessions that predate the field.
string | null
When the session’s PII text and screenshots were irreversibly anonymized. null if not anonymized.

Examples

List your recent sessions

Response

Filter by status and agent

List all sessions in a group

Find the subagents a session spawned

Pass a multi-agent parent’s ID as parent_session_id to list its child sessions, each labeled with the agent that ran it. Recurse on a child’s ID for deeper trees.
Response