list_workflows
Retrieve workflow executions from Conductor with filters for name, status, time range, or text search to monitor and troubleshoot processes.
Instructions
List workflow executions with optional filters. Returns a list of workflow executions matching the criteria.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflowName | No | Filter by workflow name/type | |
| status | No | Filter by workflow status (RUNNING, COMPLETED, FAILED, TIMED_OUT, TERMINATED, PAUSED) | |
| startTime | No | Filter workflows started after this time (epoch milliseconds) | |
| endTime | No | Filter workflows started before this time (epoch milliseconds) | |
| freeText | No | Free text search across workflow executions |
Implementation Reference
- src/index.ts:447-469 (handler)Handler that executes the list_workflows tool by mapping input parameters to Conductor API query params, fetching workflow executions from /workflow/search, and returning formatted JSON response.case "list_workflows": { const params: any = { start: 0, size: 100, }; if ((args as any).workflowName) params.workflowType = (args as any).workflowName; if ((args as any).status) params.status = (args as any).status; if ((args as any).startTime) params.startTime = (args as any).startTime; if ((args as any).endTime) params.endTime = (args as any).endTime; if ((args as any).freeText) params.freeText = (args as any).freeText; const response = await conductorClient.get("/workflow/search", { params }); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; }
- src/index.ts:39-64 (schema)Input schema for list_workflows tool defining optional filter parameters: workflowName, status (enum), startTime/endTime (epoch ms), freeText.inputSchema: { type: "object", properties: { workflowName: { type: "string", description: "Filter by workflow name/type", }, status: { type: "string", description: "Filter by workflow status (RUNNING, COMPLETED, FAILED, TIMED_OUT, TERMINATED, PAUSED)", enum: ["RUNNING", "COMPLETED", "FAILED", "TIMED_OUT", "TERMINATED", "PAUSED"], }, startTime: { type: "number", description: "Filter workflows started after this time (epoch milliseconds)", }, endTime: { type: "number", description: "Filter workflows started before this time (epoch milliseconds)", }, freeText: { type: "string", description: "Free text search across workflow executions", }, }, },
- src/index.ts:35-65 (registration)Tool registration in the tools array, including name, description, and inputSchema, used in the ListTools response.{ name: "list_workflows", description: "List workflow executions with optional filters. Returns a list of workflow executions matching the criteria.", inputSchema: { type: "object", properties: { workflowName: { type: "string", description: "Filter by workflow name/type", }, status: { type: "string", description: "Filter by workflow status (RUNNING, COMPLETED, FAILED, TIMED_OUT, TERMINATED, PAUSED)", enum: ["RUNNING", "COMPLETED", "FAILED", "TIMED_OUT", "TERMINATED", "PAUSED"], }, startTime: { type: "number", description: "Filter workflows started after this time (epoch milliseconds)", }, endTime: { type: "number", description: "Filter workflows started before this time (epoch milliseconds)", }, freeText: { type: "string", description: "Free text search across workflow executions", }, }, }, },