List workflow runs
Returns workflow run summaries for a workspace, newest first (createdAt descending). Use workflowId to narrow the list to one workflow, or responseId to find the runs a specific survey response produced.
List items are summaries without triggerPayload, data, or logs; fetch GET /api/v3/workflows/runs/{runId} for the full debug-oriented payload. This keeps response-level data out of list reads by default.
Query parameters
Workspace identifier. This is the canonical container ID for v3 APIs.
Page size (max 100).
Opaque cursor returned as meta.nextCursor from the previous page. Omit on the first request.
Optional workflow scoping. Returns only runs of this workflow.
Optional response scoping. Returns only runs triggered by this survey response.
Run lifecycle-state filter. Repeat the parameter or use comma-separated values (filter[status][in]=failed,canceled). Invalid values → 400.
Filter for dry runs created by POST /api/v3/workflows/{workflowId}/test (true) or for real trigger-initiated runs only (false). Omit to return both.
Response
Workflow runs retrieved successfully