too_many_streams

HTTP 503 · code too_many_streams · limit MaxStreams

The server has as many open streams as its memory budget allows.

When Photon sends it

Sent when a new stream would exceed MaxStreams, which by default is derived from the container’s memory limit so that open streams cannot exhaust memory. Retry-After: 1 is set.

What the client should do

Retry after the Retry-After interval, with back-off.

What the server owner can do

Scale out, give the container more memory, or set WithMemoryBudget / MaxStreams explicitly.

Example response

{
  "type": "https://photon.agenticmarket.dev/errors/too_many_streams",
  "title": "the server is at its concurrent stream limit, retry shortly",
  "status": 503,
  "code": "too_many_streams",
  "limit": "MaxStreams"
}

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