Workflows

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

Request

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

workflow_idstring required

session_idstring required

Session ID to list runs for

statusstring nullable

Filter by run status (PENDING, RUNNING, COMPLETED, ERROR, PAUSED)

factory_inputstring nullable

JSON object with factory-specific parameters for dynamic workflow reconstruction

List of runs retrieved successfully

unknown required

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