feat(proxy): add NO_OPENAPI env var to disable /openapi.json endpoint

[lovek629]

Relevant issues

Fixes #25538

Pre-Submission checklist

Please complete all items before asking a LiteLLM maintainer to review your PR

• I have Added testing in the tests/proxy_unit_tests/test_proxy_utils.py file
• My PR passes all unit tests on make test-unit
• My PR's scope is as isolated as possible, it only solves 1 specific problem
• I have requested a Greptile review by commenting @greptileai and received a Confidence Score of at least 4/5 before requesting a maintainer review

Delays in PR merge?

If you're seeing a delay in your PR being merged, ping the LiteLLM Team on Slack (#pr-review).

CI (LiteLLM team)

• Branch creation CI run
• CI run for the last commit
• Merge / cherry-pick CI run

Screenshots / Proof of Fix

Feature adds a new env var NO_OPENAPI=true which disables the /openapi.json endpoint by passing openapi_url=None to the FastAPI constructor. No screenshot needed as this is a configuration-only change following the existing NO_DOCS and NO_REDOC pattern.

Type

🆕 New Feature

Changes

• Added _get_openapi_url() helper function in litellm/proxy/utils.py following the exact same pattern as the existing _get_docs_url() and _get_redoc_url() functions
• Added openapi_url=_get_openapi_url() to the FastAPI() constructor in litellm/proxy/proxy_server.py
• Added _get_openapi_url to the import block in proxy_server.py
• Added 4 parametrized tests in tests/proxy_unit_tests/test_proxy_utils.py covering default, custom URL, disabled, and false cases

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
litellm	Ready	Preview, Comment	Apr 14, 2026 1:47pm

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[greptile-apps]

Greptile Summary

Adds a NO_OPENAPI env var (plus an OPENAPI_URL override) to disable or relocate the /openapi.json endpoint, implemented via a new _get_openapi_url() helper that follows the identical pattern as the existing _get_docs_url() and _get_redoc_url() helpers.

All remaining findings are P2 style issues (two missing blank lines and one out-of-order import) that will surface as Black/lint CI failures. Run uv run black . and re-import in alphabetical order before the next CI run.

Confidence Score: 5/5

• Safe to merge after running uv run black . to fix formatting — no logic or security issues.
• All findings are P2 style/formatting issues (missing blank lines, import order) that Black and CI will catch. The implementation is a clean copy of the established _get_docs_url/_get_redoc_url pattern with correct str_to_bool null-handling and adequate test coverage.
• No files require special attention — formatting fixes only.

Important Files Changed

Filename	Overview
litellm/proxy/utils.py	Adds _get_openapi_url() following the exact same pattern as _get_docs_url() and _get_redoc_url(). Logic is correct. Minor: only one blank line precedes the function definition; Black requires two between top-level definitions.
litellm/proxy/proxy_server.py	Imports _get_openapi_url and passes it to the FastAPI constructor as openapi_url=. The import is inserted out of alphabetical order (after _get_redoc_url instead of before _get_projected_spend_over_limit). Functionally correct.
tests/proxy_unit_tests/test_proxy_utils.py	Adds 4 parametrized unit tests matching the pattern of existing _get_docs_url / _get_redoc_url tests. All mock-only, no network calls. Minor: one blank line before the new parametrize decorator; Black requires two.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[FastAPI startup] --> B[_get_openapi_url]
    B --> C{OPENAPI_URL set?}
    C -- Yes --> D[Return custom URL]
    C -- No --> E{NO_OPENAPI=true?}
    E -- Yes --> F[Return None\ndisables /openapi.json]
    E -- No --> G[Return '/openapi.json'\ndefault]
    D --> H[FastAPI openapi_url param]
    F --> H
    G --> H

Loading

_{Reviews (1): Last reviewed commit: "test(proxy): add tests for _get_openapi_..." | Re-trigger Greptile}

[codspeed-hq]

Merging this PR will not alter performance

✅ 16 untouched benchmarks

---

_{Comparing lovek629:feature/no-openapi-env-var-25538 (4848767) with main (e64d98f)}

[greptile-apps]

Missing blank line — Black formatting will fail CI

There is only one blank line between _get_docs_url and _get_openapi_url. Black (and PEP 8) requires two blank lines between top-level function definitions, matching the existing _get_redoc_url → _get_docs_url spacing. Since Black is enforced in CI (make lint), this will block the pipeline.

Suggested change

	def _get_openapi_url() -> Optional[str]:
	def _get_openapi_url() -> Optional[str]:

Add a second blank line before this def so the gap matches the rest of the file.

[greptile-apps]

Import out of alphabetical order

_get_openapi_url is placed after _get_redoc_url, but alphabetically (o before p before r) it should come before _get_projected_spend_over_limit.

Suggested change

	_get_openapi_url,
	_get_openapi_url,
	_get_projected_spend_over_limit,
	_get_redoc_url,

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

[greptile-apps]

Missing blank line before test function

Only one blank line separates test_get_docs_url from this new test. Black requires two blank lines between top-level definitions. Add a second blank line above this decorator to match the rest of the file and pass CI.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!