{"record":{"id":"62d562b78351ac7e","repo":"GoogleContainerTools/skaffold","slug":"unable-to-find-a-valid-api-schema-version","errorCode":null,"errorMessage":"unable to find a valid API Schema version","messagePattern":"unable to find a valid API Schema version","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/skaffold/schema/versions.go","lineNumber":360,"sourceCode":"\t\tif matched := V1Pattern.MatchString(curVersion); matched {\n\t\t\tv1Track = append(v1Track, curVersion)\n\t\t} else if matched := V2Pattern.MatchString(curVersion); matched {\n\t\t\tv2Track = append(v2Track, curVersion)\n\t\t} else {\n\t\t\treturn \"\", fmt.Errorf(\"unknown apiVersion %v\", curVersion)\n\t\t}\n\t}\n\n\tif len(v1Track) > 0 && len(v2Track) > 0 {\n\t\treturn \"\", fmt.Errorf(\"detected incompatible versions:%v are incompatible with %v\", v1Track, v2Track)\n\t}\n\tif len(v1Track) > 0 {\n\t\treturn latestV1.Version, nil\n\t}\n\tif len(v2Track) > 0 {\n\t\treturn latest.Version, nil\n\t}\n\treturn \"\", fmt.Errorf(\"unable to find a valid API Schema version\")\n}\n\n// IsCompatibleWith checks if the cfgs versions can be upgraded to toVersion.\nfunc IsCompatibleWith(cfgs []util.VersionedConfig, toVersion string) (bool, error) {\n\tvar pattern *regexp.Regexp\n\tif matched := V1Pattern.MatchString(toVersion); matched {\n\t\tpattern = V1Pattern\n\t} else if matched := V2Pattern.MatchString(toVersion); matched {\n\t\tpattern = V2Pattern\n\t} else {\n\t\treturn false, fmt.Errorf(\"target version %v is invalid\", toVersion)\n\t}\n\tvar badVersions []string\n\tfor _, cfg := range cfgs {\n\t\tcurVersion := cfg.GetVersion()\n\t\tif matched := pattern.MatchString(curVersion); !matched {\n\t\t\tbadVersions = append(badVersions, curVersion)\n\t\t}","sourceCodeStart":342,"sourceCodeEnd":378,"githubUrl":"https://github.com/GoogleContainerTools/skaffold/blob/a1189de023efc32d4b8e11f395acc678aa555011/pkg/skaffold/schema/versions.go#L342-L378","documentation":"Fires in getLatestFromCompatibilityCheck when no config in the parsed set carries any recognizable apiVersion (every entry matched neither pattern), so the latest applicable schema version cannot be determined.","triggerScenarios":"Thrown at pkg/skaffold/schema/versions.go:360 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add a valid apiVersion (e.g. skaffold/v4beta11) to skaffold.yaml","Run `skaffold fix` to repair/normalize the config header","Verify the file being parsed is actually a skaffold config and not another YAML file"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"a1189de023efc32d4b8e11f395acc678aa555011","analyzedAt":"2026-09-05T12:09:27.064Z","contentChangedAt":"2026-09-05T12:09:27.064Z","schemaVersion":2},"datasetVersion":"2026-09-12T17:17:11.597Z"}