Failed to create file. Upload URL was not returned in the create file response

Laith_Mihyar · July 18, 2025, 3:45am

I’m using the com.google.genai:google-genai:1.9.0 SDK in a Spring Boot Java project.

I’m trying to upload a file, but I keep encountering the following error:

“Failed to create file. Upload URL was not returned in the create file response.”

After debugging, I realized that this error occurs because the SDK checks for the response header 'X-Goog-Upload-URL', but the actual header returned by the GenAI API is 'x-goog-upload-url' (all lowercase). Since the Java Map is case-sensitive , the check in line#892:

.containsKey("X-Goog-Upload-URL")

fails, and the upload URL is not found, triggering the error on line #894.

github.com/googleapis/java-genai

src/main/java/com/google/genai/Files.java

e48c7f1e7


      
          
            if (!createFileResponse.sdkHttpResponse().isPresent()
                || !createFileResponse.sdkHttpResponse().get().headers().isPresent()
                || !createFileResponse
                    .sdkHttpResponse()
                    .get()
                    .headers()
                    .get()
                    .containsKey("X-Goog-Upload-URL")) {
              throw new IllegalStateException(
                  "Failed to create file. Upload URL was not returned in the create file response.");
            }
          
            return createFileResponse.sdkHttpResponse().get().headers().get().get("X-Goog-Upload-URL");
          }
          
          /**
           * Downloads a file from the API.
           *
           * @param fileName The name of the file to download.
           * @param downloadPath The path to download the file to.

IndiePixel · July 30, 2025, 9:46pm

2 weeks and library is still broken. It just shows how much google cares about this SDK

Mathieu_Druart · August 18, 2025, 4:04am

Still broken in 1.12.0 version

MrKotlin · August 18, 2025, 2:15pm

Any plans to fix this? I can’t believe this issue still persists after so many releases

Himanshu_Pandey · August 21, 2025, 2:16am

this is great. any ETA on fixing this utterly small but breaking change. This show’s the future of this SDK.

Topic		Replies	Views
I am using google generative ai model gemini-1.5-pro for image analysis but getting error Gemini API	4	1164	August 1, 2024
HTTP 500 error for file APIs Gemini API gemini-15 , bug	20	2092	August 30, 2024
500 error when including a file Gemini API api , model	12	322	September 17, 2024
Did the API related to fileData change? Gemini API api , gemini-api	5	295	November 12, 2024
Google-genai files.upload not working Gemini API api	14	2203	April 19, 2025

Failed to create file. Upload URL was not returned in the create file response

Related topics