List Sessions

Retrieve paginated list of sessions with filtering and sorting options. Supports filtering by session type (agent, team, workflow), component, user, and name. Sessions represent conversation histories and execution contexts.

type'agent' | 'team' | 'workflow'

Type of sessions to retrieve (agent, team, or workflow). If not provided, returns all session types.

component_idstring nullable

Filter sessions by component ID (agent/team/workflow ID)

user_idstring nullable

Filter sessions by user ID

session_namestring nullable

Filter sessions by name (partial match)

limitinteger nullable

Number of sessions to return per page

pageinteger nullable

Page number for pagination

sort_bystring nullable

Field to sort sessions by

sort_order'asc' | 'desc'

Sort order (asc or desc)

db_idstring nullable

Database ID to query sessions from

tablestring nullable

The database table to use

Response

Sessions retrieved successfully

v1

List Sessions

Query parameters

Response