Platform

Rate Limits

Relay enforces per-organisation rate limits to protect the platform. Limits are applied using a sliding window and are generous enough for any production workload.

Default limits

All /v1/* endpointsPer API key

100 requests / 60 seconds

POST /v1/hallsPer organisation

10 requests / 60 seconds

POST /v1/halls/:id/joinPer hall

60 requests / 60 seconds

Rate limit headers

Every response includes headers to help you track your current usage:

Response headers
1
2
3
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 94
X-RateLimit-Reset: 1743843660

429 Too Many Requests

When you exceed a rate limit, the API returns:

json
1
2
3
{
  "detail": "Rate limit exceeded. Try again in 23 seconds."
}
Implement exponential backoff with jitter when you receive a 429. Check the X-RateLimit-Reset header for the exact reset timestamp.

Enterprise limits

Enterprise plans can negotiate custom rate limits. Contact us at hello@relay.dev with your expected request volume.