v1
latestOpenAPI 3.1.02026-07-26142186376.1 KBWorkflows
List Workflow Runs
List runs for a workflow within a session, optionally filtered by status.
Useful for monitoring background runs and viewing run history.
get/workflows/{workflow_id}/runs
Path parameters
workflow_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, PAUSED)
Filter by run status (PENDING, RUNNING, COMPLETED, ERROR, PAUSED)
factory_inputstring nullable
JSON object with factory-specific parameters for dynamic workflow reconstruction
JSON object with factory-specific parameters for dynamic workflow reconstruction
Response
List of runs retrieved successfully
{"stackTrail":"paths:/workflows/{workflow_id}/runs:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}