mcpDeterministic

List workflow runs

tools/call

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

MCP tools/calljson
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list-workflow-runs",
"arguments": {
"workflowId": "00000000-0000-4000-8000-000000000000"
}
}
}

Response

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

JSON-RPC errors

-32602
Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001
Authentication or hosted AI consent is required.
-32003
Workspace access is denied.
-32029
The request was rate limited.
Pipeline MCP documentation | Pipeline