{"record":{"id":"75e1ab0d1a54ccd0","repo":"conductor-oss/conductor","slug":"no-such-workflow-found-by-name-s-version-d","errorCode":null,"errorMessage":"No such workflow found by name: %s, version: %d","messagePattern":"No such workflow found by name: (.+?), version: (.+?)","errorType":"exception","errorClass":"NotFoundException","httpStatus":404,"severity":"error","filePath":"core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java","lineNumber":121,"sourceCode":"     * Start a new workflow. Returns the ID of the workflow instance that can be later used for\n     * tracking.\n     *\n     * @param name Name of the workflow you want to start.\n     * @param version Version of the workflow you want to start.\n     * @param correlationId CorrelationID of the workflow you want to start.\n     * @param priority Priority of the workflow you want to start.\n     * @param input Input to the workflow you want to start.\n     * @return the id of the workflow instance that can be use for tracking.\n     */\n    public String startWorkflow(\n            String name,\n            Integer version,\n            String correlationId,\n            Integer priority,\n            Map<String, Object> input) {\n        WorkflowDef workflowDef = metadataService.getWorkflowDef(name, version);\n        if (workflowDef == null) {\n            throw new NotFoundException(\n                    \"No such workflow found by name: %s, version: %d\", name, version);\n        }\n\n        StartWorkflowInput startWorkflowInput = new StartWorkflowInput();\n        startWorkflowInput.setName(workflowDef.getName());\n        startWorkflowInput.setVersion(workflowDef.getVersion());\n        startWorkflowInput.setCorrelationId(correlationId);\n        startWorkflowInput.setPriority(priority);\n        startWorkflowInput.setWorkflowInput(input);\n\n        return workflowExecutor.startWorkflow(startWorkflowInput);\n    }\n\n    /**\n     * Lists workflows for the given correlation id.\n     *\n     * @param name Name of the workflow.\n     * @param correlationId CorrelationID of the workflow you want to start.","sourceCodeStart":103,"sourceCodeEnd":139,"githubUrl":"https://github.com/conductor-oss/conductor/blob/cf7c3e4a8adfb158be778ab1ec525323c363cd3a/core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java#L103-L139","documentation":"Thrown by WorkflowServiceImpl.startWorkflow(name, version, ...) when metadataService.getWorkflowDef returns null, i.e. no WorkflowDef with that name (and version if specified) exists. Maps to HTTP 404. The workflow cannot be started because its definition is unknown to the metadata store.","triggerScenarios":"POST /api/workflow with a workflow name/version that is not registered. Calling startWorkflow(name, version, correlationId, priority, input) directly where name or version does not match a registered WorkflowDef.","commonSituations":"Workflow definition not deployed to the target environment; version requested is higher than what exists; name typo; definition registered in a different namespace/cluster; race where start is called before registration completes.","solutions":["List available definitions: GET /api/metadata/workflow to confirm name/version exist.","Register the workflow definition (PUT /api/metadata/workflow) before starting.","Omit version to start the latest registered version if exact version is not required.","Verify you target the correct conductor instance/environment."],"exampleFix":"// before\nString id = workflowService.startWorkflow(\"orderFlow\", 3, corrId, 0, input); // 404\n\n// after\nWorkflowDef def = metadataService.getWorkflowDef(\"orderFlow\", null);\nString id = workflowService.startWorkflow(def.getName(), def.getVersion(), corrId, 0, input);","handlingStrategy":"validation","validationCode":"WorkflowDef def = metadataService.getWorkflowDef(name, version);\n// getWorkflowDef itself throws NotFoundException; to pre-check without throwing:\nOptional<WorkflowDef> opt = metadataService.findWorkflowDef(name, version);\nif (opt.isEmpty()) { /* register or abort */ }","typeGuard":null,"tryCatchPattern":"try {\n    return workflowService.startWorkflow(name, version, corrId, priority, input);\n} catch (NotFoundException e) {\n    // workflow def missing; register then retry, or surface to caller\n}","preventionTips":["Deploy workflow definitions before starting runs","Use findWorkflowDef for a non-throwing existence check","Omit version to target the latest registered version"],"tags":["workflow","workflow-def","not-found","conductor","java"],"backgroundTag":null,"analyzedSha":"cf7c3e4a8adfb158be778ab1ec525323c363cd3a","analyzedAt":"2026-08-14T03:33:19.897Z","schemaVersion":2},"datasetVersion":"2026-08-14T05:17:29.042Z"}