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