@devries-cameron20 / composio-1 / commits / bd803c715
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.

docs(rate-limits): fix frontmatter keyword (429 as string), reconcile reference pages to verified 1-min window, Enterprise = Custom

- frontmatter keywords '429' quoted (was parsed as number -> Vercel build fail) - reference/rate-limits.mdx + reference/v3/rate-limits.mdx: rolling-10min/20k/100k/600s -> fixed 1-min/2k/10k/60s, '429 per 1 minutes' - Enterprise stated as Custom everywhere (not 'unlimited'/number) - reference + v3 index summary lines updated Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Palash Kala committed Jun 23, 2026 at 22:04 UTC bd803c715e5b563a6c0add0e6a9340ac2566636d
5 files changed +19 -19
docs/content/docs/rate-limits.mdx
+3 -3
@@ -1,7 +1,7 @@
1 ---
2 title: Rate limits & usage
3 description: How Composio's API rate limits work, the headers to read, how to handle 429s, how upstream provider limits differ, and what to do for high-volume multi-tenant usage.
4 -keywords: [rate limit, rate limits, 429, too many requests, retry-after, x-ratelimit, throttling, quota, suspension, account suspended, abuse, high volume, multi-tenant, sla, status]
4 +keywords: [rate limit, rate limits, "429", too many requests, retry-after, x-ratelimit, throttling, quota, suspension, account suspended, abuse, high volume, multi-tenant, sla, status]
5 ---
6
7 There are **two independent kinds of rate limit** when you use Composio, and most confusion comes from mixing them up:
@@ -35,7 +35,7 @@ These are the current **default** per-organization, per-minute ceilings. Your au
35 | --- | --- |
36 | Hobby / Starter | 2,000 |
37 | Growth | 10,000 |
38 -| Enterprise | Effectively unlimited |
38 +| Enterprise | Custom |
39
40 ### When you exceed the limit
41
@@ -98,7 +98,7 @@ To scale throughput, **move to a higher plan** (which raises your per-org limit)
98
99 ## Need a higher limit?
100
101 -Per-organization limits can be raised. If you're approaching your ceiling, [reach out](https://calendly.com/composiohq/enterprise) and we'll find the right limit for your workload. Higher-volume and unlimited limits come with the Enterprise plan.
101 +Per-organization limits can be raised. If you're approaching your ceiling, [reach out](https://calendly.com/composiohq/enterprise) and we'll find the right limit for your workload. Custom, higher-volume limits come with the Enterprise plan.
102
103 ## Reliability & SLA
104
docs/content/reference/index.mdx
+1 -1
@@ -10,7 +10,7 @@ Composio powers tool discovery, execution, authentication, and context managemen
10
11 - **Base URL**: <ApiBaseUrl />
12 - **[Authentication](/reference/authentication)**: `x-api-key` (project) or `x-org-api-key` (organization) header
13 -- **[Rate Limits](/reference/rate-limits)**: 20K-100K requests per 10 minutes (plan-dependent)
13 +- **[Rate Limits](/reference/rate-limits)**: 2K-10K requests per minute per org; custom on Enterprise
14
15 ## REST API
16
docs/content/reference/rate-limits.mdx
+7 -7
@@ -4,16 +4,16 @@ description: Composio API rate limits by plan, rate limit headers, and best prac
4 keywords: [API rate limits, rate limiting, throttling, 429 too many requests, API quotas, request limits]
5 ---
6
7 -Rate limits are enforced **per organization** and reset on a rolling 10-minute window.
7 +Rate limits are enforced **per organization** on a fixed one-minute window (aligned to the start of each minute). Your live limit is always returned in the `X-RateLimit` header; the table below lists the current defaults.
8
9 ## Rate limits by plan
10
11 | Plan | Rate Limit | Window |
12 |------|------------|--------|
13 -| Starter | 20,000 requests | 10 minutes |
14 -| Hobby | 20,000 requests | 10 minutes |
15 -| Growth | 100,000 requests | 10 minutes |
16 -| Enterprise | Unlimited | - |
13 +| Starter | 2,000 requests | 1 minute |
14 +| Hobby | 2,000 requests | 1 minute |
15 +| Growth | 10,000 requests | 1 minute |
16 +| Enterprise | Custom | - |
17
18 <Callout>
19 All authenticated API endpoints share your organization's rate limit. This includes tool execution, connected accounts, triggers, and all other API operations.
@@ -27,7 +27,7 @@ API responses include headers to help you track your usage:
27 |--------|-------------|
28 | `X-RateLimit` | Total requests allowed in the current window |
29 | `X-RateLimit-Remaining` | Requests remaining in the current window |
30 -| `X-RateLimit-Window-Size` | Window size (e.g., `600s` for 600 seconds) |
30 +| `X-RateLimit-Window-Size` | Window size (e.g., `60s` for 60 seconds) |
31 | `Retry-After` | Seconds until the window resets (only on 429 responses) |
32
33 ## Rate limit response
@@ -36,7 +36,7 @@ When you exceed the rate limit, you'll receive a `429 Too Many Requests` respons
36
37 ```json
38 {
39 - "message": "Rate limit exceeded. Limit: 100000 requests per 10 minutes"
39 + "message": "Rate limit exceeded. Limit: 10000 requests per 1 minutes"
40 }
41 ```
42
docs/content/reference/v3/index.mdx
+1 -1
@@ -10,7 +10,7 @@ Composio powers tool discovery, execution, authentication, and context managemen
10
11 - **Base URL**: <ApiBaseUrl />
12 - **[Authentication](/reference/v3/authentication)**: `x-api-key` (project) or `x-org-api-key` (organization) header
13 -- **[Rate Limits](/reference/v3/rate-limits)**: 20K-100K requests per 10 minutes (plan-dependent)
13 +- **[Rate Limits](/reference/v3/rate-limits)**: 2K-10K requests per minute per org; custom on Enterprise
14
15 ## REST API
16
docs/content/reference/v3/rate-limits.mdx
+7 -7
@@ -4,16 +4,16 @@ description: Composio API rate limits by plan, rate limit headers, and best prac
4 keywords: [API rate limits, rate limiting, throttling, 429 too many requests, API quotas, request limits]
5 ---
6
7 -Rate limits are enforced **per organization** and reset on a rolling 10-minute window.
7 +Rate limits are enforced **per organization** on a fixed one-minute window (aligned to the start of each minute). Your live limit is always returned in the `X-RateLimit` header; the table below lists the current defaults.
8
9 ## Rate limits by plan
10
11 | Plan | Rate Limit | Window |
12 |------|------------|--------|
13 -| Starter | 20,000 requests | 10 minutes |
14 -| Hobby | 20,000 requests | 10 minutes |
15 -| Growth | 100,000 requests | 10 minutes |
16 -| Enterprise | Unlimited | - |
13 +| Starter | 2,000 requests | 1 minute |
14 +| Hobby | 2,000 requests | 1 minute |
15 +| Growth | 10,000 requests | 1 minute |
16 +| Enterprise | Custom | - |
17
18 <Callout>
19 All authenticated API endpoints share your organization's rate limit. This includes tool execution, connected accounts, triggers, and all other API operations.
@@ -27,7 +27,7 @@ API responses include headers to help you track your usage:
27 |--------|-------------|
28 | `X-RateLimit` | Total requests allowed in the current window |
29 | `X-RateLimit-Remaining` | Requests remaining in the current window |
30 -| `X-RateLimit-Window-Size` | Window size (e.g., `600s` for 600 seconds) |
30 +| `X-RateLimit-Window-Size` | Window size (e.g., `60s` for 60 seconds) |
31 | `Retry-After` | Seconds until the window resets (only on 429 responses) |
32
33 ## Rate limit response
@@ -36,7 +36,7 @@ When you exceed the rate limit, you'll receive a `429 Too Many Requests` respons
36
37 ```json
38 {
39 - "message": "Rate limit exceeded. Limit: 100000 requests per 10 minutes"
39 + "message": "Rate limit exceeded. Limit: 10000 requests per 1 minutes"
40 }
41 ```
42