{"id":"d3a3f9eb92952038","repo":"spring-projects/spring-boot","slug":"docker-api-version-must-be-at-least-s-to-support","errorCode":null,"errorMessage":"Docker API version must be at least %s to support this feature, but current API version is %s","messagePattern":"Docker API version must be at least (.+?) to support this feature, but current API version is (.+?)","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"buildpack/spring-boot-buildpack-platform/src/main/java/org/springframework/boot/buildpack/platform/docker/DockerApi.java","lineNumber":151,"sourceCode":"\n\tprivate URI buildUrl(String path, @Nullable Collection<?> params) {\n\t\treturn buildUrl(Feature.BASELINE, path, (params != null) ? params.toArray() : null);\n\t}\n\n\tprivate URI buildUrl(String path, Object... params) {\n\t\treturn buildUrl(Feature.BASELINE, path, params);\n\t}\n\n\tURI buildUrl(Feature feature, String path, Object @Nullable ... params) {\n\t\tApiVersion version = getApiVersion();\n\t\tif (version.equals(UNKNOWN_API_VERSION) || (version.compareTo(PREFERRED_API_VERSION) >= 0\n\t\t\t\t&& version.compareTo(feature.minimumVersion()) >= 0)) {\n\t\t\treturn buildVersionedUrl(PREFERRED_API_VERSION, path, params);\n\t\t}\n\t\tif (version.compareTo(feature.minimumVersion()) >= 0) {\n\t\t\treturn buildVersionedUrl(version, path, params);\n\t\t}\n\t\tthrow new IllegalStateException(\n\t\t\t\t\"Docker API version must be at least %s to support this feature, but current API version is %s\"\n\t\t\t\t\t.formatted(feature.minimumVersion(), version));\n\t}\n\n\tprivate URI buildVersionedUrl(ApiVersion version, String path, Object @Nullable ... params) {\n\t\ttry {\n\t\t\tURIBuilder builder = new URIBuilder(\"/v\" + version + path);\n\t\t\tif (params != null) {\n\t\t\t\tint param = 0;\n\t\t\t\twhile (param < params.length) {\n\t\t\t\t\tbuilder.addParameter(Objects.toString(params[param++]), Objects.toString(params[param++]));\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn builder.build();\n\t\t}\n\t\tcatch (URISyntaxException ex) {\n\t\t\tthrow new IllegalStateException(ex);\n\t\t}","sourceCodeStart":133,"sourceCodeEnd":169,"githubUrl":"https://github.com/spring-projects/spring-boot/blob/5b2dbdbb8be64415eb6552f81ff7c449c8d251e6/buildpack/spring-boot-buildpack-platform/src/main/java/org/springframework/boot/buildpack/platform/docker/DockerApi.java#L133-L169","documentation":"Error \"Docker API version must be at least %s to support this feature, but current API version is %s\" thrown in spring-projects/spring-boot.","triggerScenarios":"Thrown at buildpack/spring-boot-buildpack-platform/src/main/java/org/springframework/boot/buildpack/platform/docker/DockerApi.java:151 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"5b2dbdbb8be64415eb6552f81ff7c449c8d251e6","analyzedAt":"2026-08-04T18:53:14.967Z","schemaVersion":2}