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

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/agno/apis/agno-api-reference/docs/sessions/:session_id/runs/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

session_idstring required

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

created_afterinteger nullable

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)

db_idstring nullable

Database ID to query runs from

tablestring nullable

Table to query runs from

Response

Session runs retrieved successfully

Changes

No recorded changes to this operation across all 1 revision of this API.