Error codes

RATE_LIMITED

Too many requests arrived in a short time.

Exit code: 6 · Who acts: You or another person, after you read the current state, or by waiting · From: the CLI, the SDK and the backend

What it means

Too many requests arrived in a short time.

Common causes

  • You, or your app, sent requests faster than the limit.

Fix it

  1. Wait, then try again. details.retryAfterMs says how long, when it is known.

In JSON and the SDK

With --json, the CLI prints:

{
  "outcome": "refused",
  "error": {
    "code": "RATE_LIMITED",
    "message": "…"
  }
}

In the SDK, a failed result has result.error.code === "RATE_LIMITED". Branch on the code, not on the message: the message is written for people and can change.

Commands that can answer with it

On this page