[GH-ISSUE #20795] issue: Batch file processing API fails due to missing required field in error response #139017

Closed
opened 2026-05-25 12:06:34 -05:00 by GiteaMirror · 2 comments
Owner

Originally created by @amit-p-dev on GitHub (Jan 19, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/20795

Check Existing Issues

  • I have searched for any existing and/or related issues.
  • I have searched for any existing and/or related discussions.
  • I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!).
  • I am using the latest version of Open WebUI.

Installation Method

Git Clone

Open WebUI Version

latest

Ollama Version (if applicable)

No response

Operating System

Windows 10

Browser (if applicable)

No response

Confirmation

  • I have read and followed all instructions in README.md.
  • I am using the latest version of both Open WebUI and Ollama.
  • I have included the browser console logs.
  • I have included the Docker container logs.
  • I have provided every relevant configuration, setting, and environment variable used in my setup.
  • I have clearly listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc).
  • I have documented step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation. My steps:
  • Start with the initial platform/version/OS and dependencies used,
  • Specify exact install/launch/configure commands,
  • List URLs visited, user input (incl. example values/emails/passwords if needed),
  • Describe all options and toggles enabled or changed,
  • Include any files or environmental changes,
  • Identify the expected and actual result at each stage,
  • Ensure any reasonably skilled user can follow and hit the same issue.

Expected Behavior

API should return a structured response with:

results: processed files

errors: failed files with status="failed"

Actual Behavior

API crashes with a Pydantic validation error

No valid response is returned to the client

Steps to Reproduce

Call POST /process/files/batch

Ensure vector DB insertion fails (e.g., invalid embedding dimension, connection issue)

API crashes instead of returning a valid error response

Proposed Fix

Always include the required status field when creating BatchProcessFilesResult:

BatchProcessFilesResult(
file_id=result.file_id,
status="failed",
error=str(e)
)

Logs & Screenshots

Root Cause

BatchProcessFilesResult requires the status field:

class BatchProcessFilesResult(BaseModel):
file_id: str
status: str
error: Optional[str] = None

But in the vector DB failure handler, it is created without status:

BatchProcessFilesResult(
file_id=result.file_id,
error=str(e)
)

Additional Information

Root Cause

BatchProcessFilesResult requires the status field:

class BatchProcessFilesResult(BaseModel):
file_id: str
status: str
error: Optional[str] = None

But in the vector DB failure handler, it is created without status:

BatchProcessFilesResult(
file_id=result.file_id,
error=str(e)
)

Originally created by @amit-p-dev on GitHub (Jan 19, 2026). Original GitHub issue: https://github.com/open-webui/open-webui/issues/20795 ### Check Existing Issues - [x] I have searched for any existing and/or related issues. - [x] I have searched for any existing and/or related discussions. - [x] I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!). - [x] I am using the latest version of Open WebUI. ### Installation Method Git Clone ### Open WebUI Version latest ### Ollama Version (if applicable) _No response_ ### Operating System Windows 10 ### Browser (if applicable) _No response_ ### Confirmation - [x] I have read and followed all instructions in `README.md`. - [x] I am using the latest version of **both** Open WebUI and Ollama. - [x] I have included the browser console logs. - [x] I have included the Docker container logs. - [x] I have **provided every relevant configuration, setting, and environment variable used in my setup.** - [x] I have clearly **listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup** (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc). - [x] I have documented **step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation**. My steps: - Start with the initial platform/version/OS and dependencies used, - Specify exact install/launch/configure commands, - List URLs visited, user input (incl. example values/emails/passwords if needed), - Describe all options and toggles enabled or changed, - Include any files or environmental changes, - Identify the expected and actual result at each stage, - Ensure any reasonably skilled user can follow and hit the same issue. ### Expected Behavior API should return a structured response with: results: processed files errors: failed files with status="failed" ### Actual Behavior API crashes with a Pydantic validation error No valid response is returned to the client ### Steps to Reproduce Call POST /process/files/batch Ensure vector DB insertion fails (e.g., invalid embedding dimension, connection issue) API crashes instead of returning a valid error response ### Proposed Fix Always include the required status field when creating BatchProcessFilesResult: BatchProcessFilesResult( file_id=result.file_id, status="failed", error=str(e) ) ### Logs & Screenshots Root Cause BatchProcessFilesResult requires the status field: class BatchProcessFilesResult(BaseModel): file_id: str status: str error: Optional[str] = None But in the vector DB failure handler, it is created without status: BatchProcessFilesResult( file_id=result.file_id, error=str(e) ) ### Additional Information Root Cause BatchProcessFilesResult requires the status field: class BatchProcessFilesResult(BaseModel): file_id: str status: str error: Optional[str] = None But in the vector DB failure handler, it is created without status: BatchProcessFilesResult( file_id=result.file_id, error=str(e) )
GiteaMirror added the bug label 2026-05-25 12:06:34 -05:00
Author
Owner

@owui-terminator[bot] commented on GitHub (Jan 19, 2026):

🔍 Similar Issues Found

I found some existing issues that might be related to this one. Please check if any of these are duplicates or contain helpful solutions:

  1. #20361 Issue: Large-scale model setting-related functionality fails.
    by shentong0722 • Jan 04, 2026 • bug

  2. #20544 issue: Document uploading - Docling API
    by n4gY1 • Jan 10, 2026 • bug


💡 Tips:

  • If this is a duplicate, please consider closing this issue and adding any additional details to the existing one
  • If you found a solution in any of these issues, please share it here to help others

This comment was generated automatically by a bot. Please react with a 👍 if this comment was helpful, or a 👎 if it was not.

<!-- gh-comment-id:3768685194 --> @owui-terminator[bot] commented on GitHub (Jan 19, 2026): 🔍 **Similar Issues Found** I found some existing issues that might be related to this one. Please check if any of these are duplicates or contain helpful solutions: 1. [#20361](https://github.com/open-webui/open-webui/issues/20361) **Issue: Large-scale model setting-related functionality fails.** *by shentong0722 • Jan 04, 2026 • `bug`* 2. [#20544](https://github.com/open-webui/open-webui/issues/20544) **issue: Document uploading - Docling API** *by n4gY1 • Jan 10, 2026 • `bug`* --- 💡 **Tips:** - If this is a duplicate, please consider closing this issue and adding any additional details to the existing one - If you found a solution in any of these issues, please share it here to help others *This comment was generated automatically by a bot.* Please react with a 👍 if this comment was helpful, or a 👎 if it was not.
Author
Owner

@silentoplayz commented on GitHub (Jan 22, 2026):

Should be solved on the dev branch with 68b2872ed6. Testing is wanted!

<!-- gh-comment-id:3785360464 --> @silentoplayz commented on GitHub (Jan 22, 2026): Should be solved on the dev branch with https://github.com/open-webui/open-webui/commit/68b2872ed645cffb641fa5a21a784d6e9ea0d72b. Testing is wanted!
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#139017