search_workflows
Search workflow executions in Netflix Conductor using query syntax to filter by type, status, or other criteria for troubleshooting and management.
Instructions
Advanced search for workflow executions using query syntax. Supports complex queries with multiple criteria.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED') | |
| start | No | Start index for pagination (default: 0) | |
| size | No | Number of results to return (default: 100) | |
| sort | No | Sort field and order (e.g., 'startTime:DESC') |
Implementation Reference
- src/index.ts:975-996 (handler)The handler function for the 'search_workflows' tool. It destructures input arguments, constructs query parameters, calls the Conductor API endpoint '/workflow/search-v2', and returns the response as formatted JSON text.
case "search_workflows": { const { query, start = 0, size = 100, sort } = args as any; const params: any = { start, size, query, }; if (sort) params.sort = sort; const response = await conductorClient.get("/workflow/search-v2", { params }); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } - src/index.ts:368-389 (schema)The input schema definition for the 'search_workflows' tool, specifying properties for query, pagination (start, size), and sorting.
inputSchema: { type: "object", properties: { query: { type: "string", description: "Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED')", }, start: { type: "number", description: "Start index for pagination (default: 0)", }, size: { type: "number", description: "Number of results to return (default: 100)", }, sort: { type: "string", description: "Sort field and order (e.g., 'startTime:DESC')", }, }, required: ["query"], }, - src/index.ts:364-390 (registration)The complete tool registration object for 'search_workflows' in the tools array, which is returned by the list_tools handler.
{ name: "search_workflows", description: "Advanced search for workflow executions using query syntax. Supports complex queries with multiple criteria.", inputSchema: { type: "object", properties: { query: { type: "string", description: "Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED')", }, start: { type: "number", description: "Start index for pagination (default: 0)", }, size: { type: "number", description: "Number of results to return (default: 100)", }, sort: { type: "string", description: "Sort field and order (e.g., 'startTime:DESC')", }, }, required: ["query"], }, }, - src/index.ts:54-56 (helper)Helper function formatError provides a specific suggestion mentioning 'search_workflows' when Elasticsearch errors occur.
if (message.includes("Elasticsearch")) { suggestion = "\n\nš” Suggestion: Elasticsearch is not configured or unavailable. Try using list_workflows instead of search_workflows."; } else {