sdkDeterministic

List workflow runs

pipeline.listWorkflowRuns

List recent executions of a workflow. Returns up to `limit` runs (default 20, max 100) ordered newest first, each carrying status, trigger_type, started_at, finished_at, and aggregate counts. Pair with get-workflow-run to drill into a specific execution.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

workflowIdrequired

string

Workflow UUID.

limit

number

Max rows to return (1-100, default 20).

Example

TypeScripttypescript

await pipeline.listWorkflowRuns({
  "workflowId": "00000000-0000-4000-8000-000000000000"
})

Response

The operation is available, but its typed response schema has not been published yet.

Exceptions

PipelineError: Thrown for validation, authentication, JSON-RPC, HTTP, and network failures. Inspect code and data when present.