v1
latestOpenAPI 3.1.02026-07-26142186376.1 KBAgents
List Agent Runs
List runs for an agent within a session, optionally filtered by status.
Useful for monitoring background runs and viewing run history.
get/agents/{agent_id}/runs
Path parameters
agent_idstring required
Query parameters
session_idstring required
Session ID to list runs for
Session ID to list runs for
statusstring nullable
Filter by run status (PENDING, RUNNING, COMPLETED, ERROR)
Filter by run status (PENDING, RUNNING, COMPLETED, ERROR)
Response
List of runs retrieved successfully
{"stackTrail":"paths:/agents/{agent_id}/runs:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}