Sessions
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.
get/sessions
Request
- The document declares no server URL.
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
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
Changes
No recorded changes to this operation across all 1 revision of this API.