# `realtime_capacity_limited`

A Multiplayer API error, sent with HTTP 503. Status: the Multiplayer API is in private alpha; this code is part of its published contract.

## When

The server's pool of live rooms is full, or the Free and sandbox share of it is used up. The answer carries `retryAfterSec`.

## What to do

Try again in a minute, use a turn-based room type, or move to a paid plan.

## The answer

Every error is a JSON body with a stable `error` code. Clients act on the codes they know and treat any other code as a failure of its HTTP status, and keep fields they do not know.

```json
{
  "error": "realtime_capacity_limited",
  "detail": "A sentence that is safe to show.",
  "next": "Try again in a minute, use a turn-based room type, or move to a paid plan.",
  "docsUrl": "https://lobbylab.gg/docs/errors/realtime_capacity_limited",
  "retryAfterSec": 60
}
```

This code always carries `retryAfterSec`.

See also: [every error code](/docs/errors), [the API reference](/docs/api) and [the docs](/docs).