RATE_LIMITED

Too many requests. Over a rate limit.

Status429
Retry?Yes

What it means

A per-key, per-workspace, per-address or per-route limit for the current one-minute window is used up. The Retry-After header says how many seconds remain.

What to do

  • Wait Retry-After seconds, then retry. Retrying sooner spends quota without resetting the window.
  • Spread batch work across the minute instead of bursting it.

The response

Served as application/problem+json. Branch on code; detail describes this occurrence and can change wording at any time.

{
  "type": "https://docs.medos.one/errors/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "…",
  "instance": "/v1/…",
  "code": "RATE_LIMITED",
  "requestId": "01JCX6Q4W3J7N8Y2H5K9M1B0VD"
}

All error codes · Error index