Skip to main content
PUT
Update lobby seat

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Path Parameters

lobby_id
string
required

Lobby whose seat will be updated.

Pattern: ^lby_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
position
integer
required

Zero-based seat position to update.

Body

application/json
expected_revision
integer
required

Current lobby revision used to reject stale updates.

Required range: x >= 0
kind
enum<string>
required

Seat type to assign.

Available options:
human_open,
random,
human,
league_player,
closed
player_id
string | null

League player to use for a policy seat.

Pattern: ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

Successful Response

id
string
required

Lobby ID.

league_id
string
required

League that owns the lobby.

coworld_id
string
required

Coworld version selected for the lobby.

coworld_name
string
required

Coworld name.

coworld_version
string
required

Coworld version.

coworld_manifest_hash
string
required

Hash of the selected Coworld manifest.

host_user_id
string | null
required

User ID of the lobby host.

variant_id
string | null
required

Selected Coworld variant.

variants
LobbyVariantPublic · object[]
required

Variants available for this Coworld.

authored_game_config
Authored Game Config · object
required

Public game configuration selected by the host.

game_config_schema
Game Config Schema · object
required

JSON Schema for configurable game values.

min_players
integer
required

Minimum occupied seats required to start.

max_players
integer
required

Number of visible player seats.

min_player_limit
integer
required

Smallest player count supported by the Coworld.

max_player_limit
integer
required

Largest player count supported by the Coworld.

status
enum<string>
required

Current lobby status.

Available options:
draft,
starting,
running,
completed,
failed,
cancelled,
expired
revision
integer
required

Revision used for optimistic concurrency checks.

episode_request_id
string | null
required

Started episode request.

episode_id
string<uuid> | null
required

Recorded episode.

replay_url
string | null
required

Replay artifact URL.

created_at
string<date-time>
required

Time the lobby was created.

started_at
string<date-time> | null
required

Time the lobby game started.

ended_at
string<date-time> | null
required

Time the lobby game ended.

termination_reason
string | null
required

Reason the lobby game ended early.

expires_at
string<date-time>
required

Time the draft lobby expires.

seats
LobbySeatPublic · object[]
required

Lobby seat assignments.

can_manage
boolean
required

Whether the caller may manage the lobby.

permissions
LobbyPermissions · object
required

Actions available to the caller.