Skip to content

docs(api): clarify burst and daily rate limits - #6949

Open
JacobisEpic wants to merge 1 commit into
koala73:mainfrom
JacobisEpic:docs/6595-api-rate-limit-model
Open

docs(api): clarify burst and daily rate limits#6949
JacobisEpic wants to merge 1 commit into
koala73:mainfrom
JacobisEpic:docs/6595-api-rate-limit-model

Conversation

@JacobisEpic

Copy link
Copy Markdown
Contributor

Fixes #6595

Summary

Correct the rate-limit documentation to match the current gateway contract after #4635 replaced the former 10× safety ceiling with hard enforcement at each plan's sold daily allowance.

Documentation changed

  • Separate per-minute burst limits from daily plan limits, including their 429 and reset behavior.
  • State that usage-based overage billing is not active and link epic: usage-based overage billing on Dodo (Phase 2 of #3199) #4560 as its roadmap.
  • Document the existing REST SDK transport-error behavior and the per_minute / daily limit_type values.
  • Align the Chinese rate-limits page with the current contract.

Validation

  • npm run --silent docs:check
  • npm run --silent lint:public-docs
  • npm run --silent lint:mintlify-slugs
  • npm run --silent lint:unicode
  • tsx --test tests/api-key-rate-limit.test.mts
  • vitest run server/__tests__/gateway-api-rate-limit.test.ts
  • git diff --check

Docs-only change.

@vercel

vercel Bot commented Aug 18, 2026

Copy link
Copy Markdown

@JacobisEpic is attempting to deploy a commit to the World Monitor Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions Bot added the trust:safe Brin: contributor trust score safe label Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

trust:safe Brin: contributor trust score safe

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(api): make the two-limit model explicit on the rate-limits page

1 participant