[GH-ISSUE #20359] issue: OpenAPI spec invalid: duplicate operationId and missing path parameter Summary

Originally created by @mephmanx on GitHub (Jan 3, 2026). Original GitHub issue: https://github.com/open-webui/open-webui/issues/20359 ### 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 Docker ### Open WebUI Version latest ### Ollama Version (if applicable) _No response_ ### Operating System ubuntu 24.04 ### 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 swagger doc on the /docs url passes validation ### Actual Behavior The OpenWebUI openapi.json served at openapi.json fails OpenAPI validation. Gravitee’s admission webhook rejects it as an invalid Swagger doc. Local validation reports: Duplicate operationId under /openai/{path} Missing path parameter definition for {file_name} in /api/v1/files/{id}/content/{file_name} Environment OpenWebUI version: 0.1.0 (from openapi.json info) Endpoint tested: https://open-webui.teleport.app.suncoast.systems/openapi.json (same issue via cluster service) Steps to reproduce openapi.json > openapi.json Validate with OpenAPI validator: from openapi_spec_validator import validate_spec import json validate_spec(json.load(open("openapi.json"))) Actual result Validation fails with errors similar to: DuplicateOperationIDError: Operation ID 'proxy_openai__path__put' for 'delete' in '/openai/{path}' is not unique UnresolvableParameterError: Path parameter 'file_name' for 'get' operation in '/api/v1/files/{id}/content/{file_name}' was not resolved Expected result openapi.json should validate cleanly so tooling (e.g., Gravitee/GKO) can import and render docs. Suggested fixes Ensure each operation has a unique operationId (e.g., differentiate by method for /openai/{path}). Add missing path parameter definitions, e.g. for {file_name} in /api/v1/files/{id}/content/{file_name} (either path-level or per‑operation parameters). ### Steps to Reproduce access /docs url ### Logs & Screenshots no logs or docs ### Additional Information _No response_

GiteaMirror commented

2026-04-20 01:30:30 -05:00

Owner

Originally created by @mephmanx on GitHub (Jan 3, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/20359

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

Docker

Open WebUI Version

latest

Ollama Version (if applicable)

No response

Operating System

ubuntu 24.04

Browser (if applicable)

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

swagger doc on the /docs url passes validation

Actual Behavior

The OpenWebUI openapi.json served at openapi.json fails OpenAPI validation. Gravitee’s admission webhook rejects it as an invalid Swagger doc. Local validation reports:

Duplicate operationId under /openai/{path}
Missing path parameter definition for {file_name} in /api/v1/files/{id}/content/{file_name}
Environment

OpenWebUI version: 0.1.0 (from openapi.json info)
Endpoint tested: https://open-webui.teleport.app.suncoast.systems/openapi.json (same issue via cluster service)
Steps to reproduce

openapi.json > openapi.json
Validate with OpenAPI validator:
from openapi_spec_validator import validate_spec
import json
validate_spec(json.load(open("openapi.json")))
Actual result
Validation fails with errors similar to:

DuplicateOperationIDError: Operation ID 'proxy_openai__path__put' for 'delete' in '/openai/{path}' is not unique
UnresolvableParameterError: Path parameter 'file_name' for 'get' operation in '/api/v1/files/{id}/content/{file_name}' was not resolved
Expected result
openapi.json should validate cleanly so tooling (e.g., Gravitee/GKO) can import and render docs.

Suggested fixes

Ensure each operation has a unique operationId (e.g., differentiate by method for /openai/{path}).
Add missing path parameter definitions, e.g. for {file_name} in /api/v1/files/{id}/content/{file_name} (either path-level or per‑operation parameters).