Skip to content

docs: add per-tag rate limits documentation#458

Open
yassin-berriai wants to merge 1 commit into
mainfrom
docs-per-tag-rate-limits
Open

docs: add per-tag rate limits documentation#458
yassin-berriai wants to merge 1 commit into
mainfrom
docs-per-tag-rate-limits

Conversation

@yassin-berriai

Copy link
Copy Markdown
Contributor

Adds a per-tag rate limits documentation page (docs/proxy/per_tag_rate_limits.md) to the docs site, plus a screenshot of the Per-Tag Rate Limits editor. The page is wired into the Budgets + Rate Limits sidebar after proxy/tag_budgets.

These docs were originally opened against BerriAI/litellm in BerriAI/litellm#31855; they belong in this repo, so that PR is being closed in favor of this one.

The page documents the per-tag RPM limiting feature shipped in BerriAI/litellm#31502, which lets a single key carry independent RPM counters per request tag:

  • Creating keys with tag_rpm_limit via /key/generate (API and UI)
  • Updating tag limits via /key/update
  • Sending tagged requests with the x-litellm-tags header or request body metadata
  • Rate limit behavior, per-tag counters, and fallback to the key-level rpm_limit

The image reference uses the ../../img/ path convention used by the other proxy docs in this repo (the source PR used ../img/, which does not resolve under this repo layout).

Documents the per-tag RPM limiting feature that lets a single key carry
independent RPM counters per request tag (BerriAI/litellm#31502). Covers
creating and updating keys with tag_rpm_limit via the API and the UI, sending
tagged requests, rate limit behavior and fallback to the key-level limit, and
adds a screenshot of the Per-Tag Rate Limits editor. Wires the page into the
Budgets + Rate Limits sidebar after tag_budgets.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 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, Comment Jul 1, 2026 12:05pm

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