v1

latestOpenAPI 3.1.02026-07-26142186376.1 KB
Sessions

Get Session Runs

Retrieve all runs (executions) for a specific session with optional timestamp filtering. Runs represent individual interactions or executions within a session. Response schema varies based on session type.

get/sessions/{session_id}/runs

Path parameters

session_idstring required

Session ID to get runs from

Session ID to get runs from

Query parameters

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

Session type (agent, team, or workflow). If not provided, auto-detected from session data.

user_idstring nullable

User ID to query runs from

User ID to query runs from

created_afterinteger nullable

Filter runs created after this Unix timestamp (epoch time in seconds)

Filter runs created after this Unix timestamp (epoch time in seconds)

created_beforeinteger nullable

Filter runs created before this Unix timestamp (epoch time in seconds)

Filter runs created before this Unix timestamp (epoch time in seconds)

db_idstring nullable

Database ID to query runs from

Database ID to query runs from

tablestring nullable

Table to query runs from

Table to query runs from

Response

Session runs retrieved successfully