Skip to content

docs(proxy): document the mock testing request params opt-in - #730

Open
yuneng-berri wants to merge 1 commit into
mainfrom
litellm_mock-testing-flag-docs
Open

docs(proxy): document the mock testing request params opt-in#730
yuneng-berri wants to merge 1 commit into
mainfrom
litellm_mock-testing-flag-docs

Conversation

@yuneng-berri

@yuneng-berri yuneng-berri commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Companion to BerriAI/litellm#35423, which puts the six mock testing request params behind one opt-in on the Proxy

Both fallback testing pages have been wrong since the params were first gated. docs/proxy/reliability.md and docs/proxy/fallback_management.md told readers the flags were stripped from Proxy requests and had no effect, with the only suggested alternative being to stand up a deliberately broken deployment. That is what customers were actually doing, and on a production server it means injecting a failing model into a live config just to exercise routing

Both pages now document the opt-in instead, with a working curl on each. Two details the pages spell out rather than leave to inference: the setting covers mock_timeout and mock_delay as well as the three mock_testing_* params, even though the key name only says mock_testing; and it is read from config.yaml only, so it cannot be set from the Admin UI or /config/update

The production guidance is deliberately not a blanket "never enable this". The use case that prompted it is verifying failover on a live server, so the pages frame it as staging plus controlled production drills, state plainly that any caller with a valid key can use it while it is on, and say to turn it off when the drill is done

npm run build passes and reports no broken links on either page

Both fallback testing pages still said the mock_testing_* params were
stripped from Proxy requests with no way to force a fallback, which sent
readers off to stand up a deliberately broken deployment instead

Replace that with the opt-in, the full list of params it covers, a working
curl for each page, and what to weigh before turning it on in production
@vercel

vercel Bot commented Aug 1, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview Aug 1, 2026 12:26am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant