RATE_LIMITED

HTTP status: 429

What it means

Too many API requests in the current window.

Why it happens

• Your API key exceeded its request rate (Trial 60/min, Starter 300/min, Pro 600/min, Studio 1200/min, sliding window).

How to fix it

• Back off until the X-RateLimit-Reset time (epoch seconds) and retry.
• Watch X-RateLimit-Remaining on every response to pace your client.

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Slow down and retry after the window in the X-RateLimit-Reset header.",
    "docsUrl": "https://automotion.dev/docs/errors/rate_limited"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.