Skip to content
deedglassdocs

upstream_rate_limited

The service answered 429.

HTTP 429 · rate_limit_error · retry after the time in Retry-After

What happened

Section titled “What happened”

The service answered 429. Reads and calls with an idempotency header are retried up to twice, honouring a Retry-After of at most 5 s; a write without one is never retried. The action is failed.

What to do

Section titled “What to do”

Wait, then send the action again. If it happens often, give the agent a budget in its policy so it slows down before the service does.

Example

Section titled “Example”
HTTP 429 · upstream_rate_limited
{
  "error": {
    "type": "rate_limit_error",
    "code": "upstream_rate_limited",
    "message": "The service is limiting requests. Wait, then send the call again.",
    "param": null,
    "request_id": "req_01j9zr3m5k8q2w7x4t6v0b1c9d",
    "doc_url": "https://docs.deedglass.com/errors/upstream_rate_limited"
  }
}

The message is for a person and can get more exact over time: branch on type and code, never on the message.

In the SDKs

Section titled “In the SDKs”
SDK Raised as
TypeScript (@deedglass/sdk) RateLimitError with code === "upstream_rate_limited"
Python (deedglass) deedglass.RateLimitError with .code == "upstream_rate_limited"
Section titled “Related”