Skip to main content

Too many connections

typehttps://docs.frem.sh/reference/api/errors/too-many-connections
HTTP status429 Too Many Requests

What it means

You already have the maximum number of open event streams and waiting long polls (16 per person, across all your sessions and agents), or the server is at its own limit.

Example detail messages returned with this error:

  • You already have the maximum number of open event streams and waiting long polls. Share one connection between your sessions, or close one.
  • This server has too many open event streams; retry shortly.

What to do

Share one event feed connection between your sessions instead of opening one per agent session, or close a stream you no longer read. When the server is at its limit, wait for Retry-After seconds and reconnect.

Response shape

All fremforge API errors are RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/too-many-connections",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "..."
}

Branch on type, not on title or detail - those are human-readable and may be reworded.