Not available yet. Replyz is built and tested, but not deployed: https://api.replyz.io is the planned address and does not answer yet. These pages describe the API as it is built today and may change before launch.

too_many_waits

HTTP 429 · The account already holds 5 long-polls.

Endpoints: GET /v1/inboxes/{id}/wait, GET /v1/events

When it happens

When	Message (as returned)	Fix (as returned)
The account already has 5 long-polls holding (`wait` and `events?wait=` together). A long hold can also end with this code after 20 or 40 seconds if all slots were taken in between.	`This account already has 5 long-polls open (wait and events share the limit).`	`Wait for one of them to return before starting another, or poll without holding (wait: timeout=0; events: wait=0).`

Headers

Retry-After: 1.
Cache-Control: no-store and Content-Type: application/problem+json, as on every problem response.

What to do

Let an open long-poll return first, or call without holding (timeout=0 on wait, wait=0 on events).

Example

{
  "type": "https://docs.replyz.io/errors/too_many_waits",
  "code": "too_many_waits",
  "status": 429,
  "message": "This account already has 5 long-polls open (wait and events share the limit).",
  "fix": "Wait for one of them to return before starting another, or poll without holding (wait: timeout=0; events: wait=0).",
  "docs": "https://docs.replyz.io/errors/too_many_waits.md"
}

See also

Waiting for mail

All codes: Errors.