Signals. Infra
Error types

Rate limit exceeded

HTTP 429 · `rate-limited` — what it means and what to do about it.

HTTP 429 · type: https://docs.signals.ai/errors/rate-limited

You exceeded your plan's per-second burst.

What to do

Honor the Retry-After header, add jitter, and cap your retries. If you hit this steadily rather than in spikes, lower your concurrency rather than retrying harder.

The response shape

Every error is RFC 9457 application/problem+json and carries a request_id, which is also returned as the X-Request-Id header on every response, success or failure. Quote it when contacting support.

{
  "type": "https://docs.signals.ai/errors/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "…",
  "request_id": "req_9f2c…",
  "instance": "/v1/…"
}

See all error types for the full catalog.

On this page