TXT CLAW Rate Limits (Preview)
If you receive HTTP
429
Note: API keys require an active Dev API plan (subscription or promo). Free accounts cannot create keys.
Defaults (preview)
These defaults may change, but are the current intended starting point:
- per API key
60 req/min
- per IP (backstop)
120 req/min
- per API key
1,000 req/day
- Agent creates: per API key,
50/day
per IP10/min
- BYOK set/update: per API key (for
5/hour
and/v1/byok
on agent creation)llm.api_key
- Warmup: per API key (for
3/hour
)POST /v1/warmup
Plan caps (defaults)
These are the default plan-based overrides (if enabled in the Worker):
| Plan | req/min per key | req/min per IP | req/day per key |
|---|---|---|---|
| Free (inactive) | 60 | 120 | 1,000 |
| Pro | 300 | 500 | 10,000 |
| BYOK | 600 | 1,000 | 50,000 |
What to do
- Respect the response header (seconds).
Retry-After
- Retry after the delay (with jitter/backoff).
Error shape
Rate limited responses include:
error: "rate_limited"
trace_id
- (which limiter triggered)
limit_key