list_executions
View and filter workflow execution history by status, workflow ID, or limit results to monitor automation performance and troubleshoot issues.
Instructions
List workflow executions
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_executions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflowId | No | Filter by workflow ID | |
| status | No | Filter by execution status | |
| limit | No | Limit number of results |
Implementation Reference
- src/handlers.ts:346-354 (handler)Handler logic for the 'list_executions' tool in the CallToolRequestSchema switch statement. It calls main.api.listExecutions(args) and returns the result as JSON text content.
case "list_executions": return { content: [ { type: "text", text: JSON.stringify(await main.api.listExecutions(args), null, 2) } ] }; - src/handlers.ts:143-160 (schema)Input schema definition for the 'list_executions' tool, defining optional parameters for filtering executions.
inputSchema: { type: "object", properties: { workflowId: { type: "string", description: "Filter by workflow ID" }, status: { type: "string", enum: ["success", "failure", "running"], description: "Filter by execution status" }, limit: { type: "number", description: "Limit number of results" } } } - src/handlers.ts:140-161 (registration)Registration of the 'list_executions' tool in the tools list returned by ListToolsRequestSchema handler.
{ name: "list_executions", description: "List workflow executions", inputSchema: { type: "object", properties: { workflowId: { type: "string", description: "Filter by workflow ID" }, status: { type: "string", enum: ["success", "failure", "running"], description: "Filter by execution status" }, limit: { type: "number", description: "Limit number of results" } } } }, - src/api.ts:30-32 (helper)Helper function listExecutions in apiHelpers, which is called by the tool handler. Currently a stub awaiting implementation.
listExecutions: async function(args: any = {}) { // ... copy listExecutions logic from index.ts ... },