@devries-cameron20 / composio Mirror · read-only / commits / 6a046c803
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 04:45 UTC

docs: add a guide to avoiding and recovering from rate limits (#5323)

## What and why The Rate limits reference lists the limits and headers but does not show customers how to write code that avoids them or recovers well. This PR adds a practical guide, "Avoid and recover from rate limits", under Guides › Production readiness. ## The guide 1. **Know which limit you hit.** A table of the Composio org limit, plan usage, provider short-window limits, and provider daily or monthly quotas. It shows how each one reaches your code and whether to retry. Python, TypeScript and API examples tell a Composio `429` (an exception) apart from a provider error (inside the tool result). 2. **Retry the limits that clear.** A Mermaid decision flow, plus retry helpers that honor `Retry-After`, use full-jitter exponential backoff with a cap, never retry an exhausted daily or monthly quota, and only resend writes that are safe to repeat. 3. **What the SDK already does.** A Python vs TypeScript table: read retries, no execution retries, schema caching, typed rate-limit errors (`isComposioRateLimitError`, `retryAfterSeconds`), and connection polling backoff. 4. **Shape your traffic.** A per-connected-account concurrency cap, small pages, triggers instead of polling loops, reusing sessions, and watching `X-RateLimit-Remaining`. 5. **When you outgrow a Composio-managed app.** Move to your own OAuth app. ## Other changes - `reference/rate-limits.mdx`: "Best practices" links to the guide. "Need higher limits?" adds that a provider quota on a Composio-managed app is fixed by moving to your own OAuth app. - `poc-to-prod/meta.json` and `tests/static/product-navigation.test.ts` register the page. Every SDK name and behavior was checked against `ts/packages/core` and `python/` source. No prices, caps, or dates are stated. ## Checks - `bun run lint`, `bun run lint:links`, and `bun run types:check` pass. - `check:code-examples`, `check:api-snippets`, and `check:python-snippets` are clean. - The TypeScript snippets type-check in strict mode against the installed SDK. - `bun run test`: the 5 failures in `content-freshness.test.ts` also fail on untouched `next`. - The full build (Twoslash and Mermaid render) was not run locally. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Jeevesh Jain committed Nov 16, 2026 at 23:52 UTC 6a046c80322d6f2297364d66a5cd9ff9d7e3acfc

No changes.