Machine-readable companion: /docs-for-robots

Arc/docs

Traffic Controls

Rate Limiting

Route-level rate limiting lets Arc either reject excess traffic or pass it through with an explicit warning signal.

Actions

Reject

Arc returns 429 immediately and includes reset metadata in response headers.

Warn

Arc forwards the request normally and adds a warning header so the caller can observe pressure without a hard block.

Headers

http
HTTP/1.1 429 Too Many Requests
Retry-After: <unix-timestamp>
X-Arc-Rate-Limit-Remaining: 0
X-Arc-Rate-Limit-Reset: <unix-timestamp>

{ "detail": "Rate limit exceeded" }
http
X-Arc-Rate-Limit-Warning: true