rate_limited

Rate limit exceeded

Code: rate_limited · HTTP status: usually 429

This API key used all of its points for the current window.

How to fix

Wait retry_after seconds (the Retry-After header) and retry. Reads cost fewer points than writes.

Example response

{
  "code": "rate_limited",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/rate-limited/",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit exceeded. This API key spent its points for the window. Wait `retry_after` seconds (the Retry-After header), then retry; reads cost fewer points than writes.",
  "errors": [
    "Rate limit exceeded"
  ],
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ],
  "retry_after": 12
}

Every API v2 and MCP failure carries code and a type link to its page here. See Errors & Responses for the full envelope.