API Reference
Rate Limiting
Understand request quotas and rate limit behavior
How Rate Limiting Works
Router9 enforces two rolling time windows per agent plan:
- 4-hour window — Limits burst usage within short periods
- Weekly window — Limits total usage over 7 days
Both windows are checked on every request. If either limit is exceeded, the request is rejected with a 429 status.
Rate Limits by Plan
| Plan | 4-Hour Limit | Weekly Limit | Price |
|---|---|---|---|
| Free | 50 requests | 500 requests | $0/mo |
| Assistant | 500 requests | 5,000 requests | $29/mo |
| Engineer | 2,000 requests | 50,000 requests | $59/mo |
Rate Limit Headers
Every API response includes rate limit information:
X-RateLimit-Limit-4h: 500
X-RateLimit-Remaining-4h: 487
X-RateLimit-Reset-4h: 2025-04-06T16:00:00Z
X-RateLimit-Limit-Weekly: 5000
X-RateLimit-Remaining-Weekly: 4850
X-RateLimit-Reset-Weekly: 2025-04-13T00:00:00Z429 Response
When a rate limit is exceeded:
HTTP/1.1 429 Too Many Requests
Retry-After: 1800{
"error": "4-hour rate limit exceeded. Resets at 2025-04-06T16:00:00Z"
}The Retry-After header indicates the number of seconds to wait before retrying.
Monitoring Usage
Track your current usage in the dashboard under Agent → Usage. The usage page shows:
- Real-time quota bars for both 4-hour and weekly windows
- Color-coded warnings (green < 80%, yellow 80-95%, red ≥ 95%)
- Historical request charts (7-day and 30-day views)
Upgrading Limits
If you consistently hit rate limits, upgrade your agent's plan:
- Go to Profile → Plan
- Select a higher tier
- New limits take effect immediately