Too many connections
type | https://docs.frem.sh/reference/api/errors/too-many-connections |
| HTTP status | 429 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.