Open a battle
POST/battles
Opens a lobby with seats_total seats and seats the creator at index 0.
Whether seat 0 lands FILLED or READY depends on creator_game_url:
supplying it makes the seat READY, omitting it leaves it FILLED and the
creator must supply a URL later. A two-seat battle created without
creator_game_url does not auto-start when the other player joins.
The response carries a viewer token for the live feed when the instance has a
signing key. If it does not, the battle is still created and ws_token is
simply absent — see the ws_token field note.
Scope: battles:write
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 413
- 503
Battle opened
Invalid body. Also returned for an unknown field — including a tenant_id, which is rejected rather than ignored
Missing, malformed, revoked or expired API key
The key lacks battles:write, the casino is suspended, or the game is not allowed
The creator is already seated in another non-terminal battle
Body over 1 MiB
The lobby is still initialising, or the instance is at capacity