rate_limited

Response

Every failure uses this envelope. credits_charged is 0. The message below is the default text for this code. Live messages can change, so branch on error.code.

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests for this team's plan; wait for Retry-After.",
    "retryable": true
  },
  "credits_charged": 0,
  "request_id": "req_0123456789abcdef01234567"
}

HTTP 429 responses for this code include a retry-after header: seconds to wait.

What to do

• Wait the number of seconds in the retry-after response header, then send the request again. Limits are listed on rate limits.
• This code is retryable, and the failed attempt costs nothing.

The response header x-request-id matches request_id. The full list is on errors.