Skip to content

docs: document /v1/decisions and /v1/systemone with supported providers - #2141

Merged
mateo-berri merged 6 commits into
mainfrom
litellm_docs_decisions_api
Oct 8, 2026
Merged

mateo-berri merged 6 commits into
mainfrom
litellm_docs_decisions_api

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Rewrites the decisions page for the two routes added in BerriAI/litellm#45184 and BerriAI/litellm#45214. /v1/decisions now takes the OpenAI Decisions format and /v1/systemone takes the System One format, and both work with every provider: OpenAI, TypeSafe, Perplexity, OpenRouter, Cloudflare Workers AI and Strands Decider

The page covers what each route is for, a providers table with credentials, upstream paths and image support, a proxy config with an OpenAI model (luna) and a TypeSafe model (jev), one curl per route, an image request on luna, the 400 that System One providers return for images, SDK usage for litellm.decisions and litellm.adecisions, and the limits that matter when sending System One bodies to OpenAI. It also says the routes are not in a published release yet and are coming to v1.104.2 and the next v1.105.0 release candidate

The Strands Decider row names the model the cost map ships, strands_decider/strands-decider-2B-hobson-v19. The top-level docs banner and the links out to each provider's own Decisions docs are a follow-up for after the page is up, so this PR carries neither

The TypeSafe pass-through page now points to /v1/systemone for the same body through model_list, and the sidebar entry under Supported Endpoints is unchanged

Every response on the page was captured from a live proxy at BerriAI/litellm@1348de864f calling real OpenAI gpt-6-luna and TypeSafe jev-latest, and the SDK snippets were run against the same APIs

Screenshots / Proof of Fix

Before, on the live site today (2026-10-07 PT): the page does not exist and the home page has no banner

$ curl -s -o /dev/null -w 'GET https://docs.litellm.ai/docs/decisions -> %{http_code}\n' https://docs.litellm.ai/docs/decisions
GET https://docs.litellm.ai/docs/decisions -> 404
$ curl -s https://docs.litellm.ai/ | grep -c 'Decisions API is here'
0

After, at 7546488: npm run build passes, and these are the rendered page from docusaurus serve of that build

pr2141-7546488016-lit9283-v3-decisions-page-top.png
pr2141-7546488016-lit9283-v3-decisions-providers.png
pr2141-7546488016-lit9283-v3-decisions-limits.png

  • 7546488 passes /audit (skipped: no product code on a request path, docs)

Caveats

@devin-ai-integration

devin-ai-integration Bot commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@vercel

vercel Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
litellm Ready Ready Preview Oct 8, 2026 5:09am UTC

Request Review

@mateo-berri
mateo-berri force-pushed the litellm_docs_decisions_api branch from b195e7a to d9a9deb Compare October 8, 2026 02:21
@mateo-berri mateo-berri changed the title docs: add /v1/decisions endpoint page docs: document /v1/decisions and /v1/systemone with supported providers Oct 8, 2026
@mateo-berri

Copy link
Copy Markdown
Contributor

bugbot run

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

@mateo-berri

Copy link
Copy Markdown
Contributor

bugbot run

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

…ption 400, and note the playground tab is not on v1.104.2 or v1.105.0
@mateo-berri

Copy link
Copy Markdown
Contributor

bugbot run

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

@mateo-berri

Copy link
Copy Markdown
Contributor

bugbot run

@mateo-berri
mateo-berri enabled auto-merge (squash) October 8, 2026 05:07

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 7546488. Configure here.

@mateo-berri
mateo-berri merged commit f1fce54 into main Oct 8, 2026
6 checks passed
@mateo-berri
mateo-berri deleted the litellm_docs_decisions_api branch October 8, 2026 05:10

@mateo-berri mateo-berri left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

This branch was successfully deployed

1 active deployment
Preview — 75464880 Deployed Oct 8, 2026 by vercel[bot]
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.

2 participants