Skip to content

docs(tag-routing): add negation tags and tag_regex sections - #437

Merged
mateo-berri merged 4 commits into
BerriAI:mainfrom
deepanshululla:litellm_tag_routing_negation
Jun 30, 2026
Merged

docs(tag-routing): add negation tags and tag_regex sections#437
mateo-berri merged 4 commits into
BerriAI:mainfrom
deepanshululla:litellm_tag_routing_negation

Conversation

@deepanshululla

@deepanshululla deepanshululla commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Relevant issues

Companion to litellm OSS PR #31680 (tag routing negation feature).

Changes

  • Rewrites docs/proxy/tag_routing.md to incorporate existing page content (Quick Start, Calling via Request Header, Setting Default Tags, Team based tag routing) with improved formatting
  • Adds Negation Tags (Denylist) section: !-prefix tags to exclude deployments by tag, with examples for single provider, multiple providers, fallback chains, and header-based usage
  • Adds Regex-based tag routing (tag_regex) section: operator-configured regex matching against User-Agent, with config example, verification steps, observability output, and a security caution note clarifying that header-based routing is not a security boundary and requires an upstream auth layer

Type

📖 Documentation


Note

Low Risk
Documentation-only changes to proxy tag routing; no runtime code or config behavior is modified in this PR.

Overview
docs/proxy/tag_routing.md is reworked to keep the existing quick start, header tags, default tags, and enterprise team routing, with cleaner Docusaurus-style examples (showLineNumbers, bash/json fences) and a shorter quick-start flow.

The main new material documents negation (denylist) tags (!tag in request metadata.tags or x-litellm-tags): how to exclude deployments by exact tag, combine with positive tags, handle ban-only requests, fallbacks, failure mode no_deployments_with_tag_routing, and a semantics table (no regex on client negation tags, untagged deployments never excluded).

It also adds/expands tag_regex operator routing on User-Agent, including matching semantics, observability payload, caution that header routing is classification not access control, and how negation runs before regex (with two interaction examples).

Reviewed by Cursor Bugbot for commit 50eccb9. Bugbot is set up for automated code reviews on this repo. Configure here.

@vercel

vercel Bot commented Jun 30, 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, Comment Jun 30, 2026 4:42am

Request Review

@mateo-berri

Copy link
Copy Markdown
Collaborator

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.

✅ 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 cc05be7. Configure here.

@mateo-berri

Copy link
Copy Markdown
Collaborator

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.

✅ 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 50eccb9. Configure here.

@mateo-berri
mateo-berri merged commit 168ff30 into BerriAI:main Jun 30, 2026
3 checks passed
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