too_many_requests

HTTP 429 · code too_many_requests

The client is sending requests faster than it is allowed to.

When Photon sends it

Sent by your rate-limiting middleware through photonerr.TooManyRequests(msg). Set a Retry-After header alongside it.

What the client should do

Wait for the Retry-After interval, then retry with back-off.

Example response

{
  "type": "https://photon.agenticmarket.dev/errors/too_many_requests",
  "title": "too many requests",
  "status": 429,
  "code": "too_many_requests"
}

Match on the code field rather than on title, which is meant for people and may change. See all error codes.