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
Input Schema
TableJSON 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 ... },