Skip to main content
PATCH
/
api
/
v3
/
lobbies
/
{config}
/
me
/
settings
Update lobby settings
curl --request PATCH \
  --url https://api.computeflow.cloud/api/v3/lobbies/{config}/me/settings \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --header 'x-player-id: <x-player-id>' \
  --data '
{
  "name": "<string>",
  "maxPlayers": 50,
  "isPrivate": true,
  "allowLateJoin": true,
  "region": "<string>",
  "settings": {}
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "code": "<string>",
  "config": "<string>",
  "status": "waiting",
  "host": "<string>",
  "maxPlayers": 123,
  "currentPlayers": 123,
  "region": "<string>",
  "isPrivate": true,
  "allowLateJoin": true,
  "settings": {},
  "players": [
    {
      "id": "<string>",
      "state": {},
      "isHost": true
    }
  ],
  "server": {
    "instanceId": "<string>",
    "status": "<string>",
    "region": "<string>",
    "ports": [
      {
        "name": "<string>",
        "host": "<string>",
        "port": 123,
        "protocol": "udp"
      }
    ]
  },
  "matchmaking": {
    "mode": "<string>",
    "startedAt": "<string>",
    "queueStats": {
      "playersSearching": 123,
      "lobbiesInQueue": 123,
      "avgWaitSeconds": 123
    }
  },
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

api-key
string
header
required

Headers

x-player-id
string
required

Unique player identifier. Must be the lobby host.

Path Parameters

config
string
required

Lobby configuration name or ID.

Body

application/json

Update lobby settings. Only the host can do this.

name
string

New lobby name.

Required string length: 1 - 100
maxPlayers
integer

New max players.

Required range: 1 <= x <= 100
isPrivate
boolean

Toggle private mode.

allowLateJoin
boolean

Toggle late join.

region
string

Change preferred region.

settings
object

Merge into lobby settings.

Response

Settings updated. Returns the full lobby state.

Full lobby state including players, server, and matchmaking info.

id
string<uuid>
required

Lobby ID.

code
string | null
required

Invite code for joining (null if private mode is disabled).

config
string
required

Lobby config name.

status
enum<string>
required

Current lobby status.

Available options:
waiting,
in_queue,
starting,
matched,
match_found,
in_game
host
string
required

Player ID of the host.

maxPlayers
number
required

Maximum player capacity.

currentPlayers
number
required

Current number of players.

region
string | null
required

Preferred game server region.

isPrivate
boolean
required

Whether the lobby is hidden from browsing.

allowLateJoin
boolean
required

Whether players can join mid-game.

settings
object
required

Custom game settings.

players
object[]
required

Players in the lobby with their state.

server
object
required

Game server info (null when no game running).

matchmaking
object
required

Matchmaking info (null when not searching).

createdAt
string
required

ISO 8601 creation timestamp.

updatedAt
string
required

ISO 8601 last update timestamp.