Update lobby | Softmax docs

PATCH/v2/lobbies/{lobby_id}

Changes the draft lobby's variant, game configuration, or player count.

Authorization

BearerAuth

AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

lobby_id*Lobby Id

Lobby to update.

Match^lby_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Request Body

application/json

expected_revision*Expected Revision

Current lobby revision used to reject stale updates.

Range0 <= value

variant_id?|

Coworld variant to use.

game_config_overrides?|

Public game configuration values to override.

num_players?|

Number of visible player seats.

bash

curl -X PATCH "https://example.com/v2/lobbies/string" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_revision": 0
  }'

json

{
  "id": "string",
  "league_id": "string",
  "coworld_id": "string",
  "coworld_name": "string",
  "coworld_version": "string",
  "coworld_manifest_hash": "string",
  "host_user_id": "string",
  "variant_id": "string",
  "variants": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "num_players": 0
    }
  ],
  "authored_game_config": {},
  "game_config_schema": {},
  "min_players": 0,
  "max_players": 0,
  "min_player_limit": 0,
  "max_player_limit": 0,
  "status": "draft",
  "revision": 0,
  "episode_request_id": "string",
  "episode_id": "a7b62598-1927-4181-99d5-5d746c0bbcfe",
  "replay_url": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "ended_at": "2019-08-24T14:15:22Z",
  "termination_reason": "string",
  "expires_at": "2019-08-24T14:15:22Z",
  "seats": [
    {
      "position": 0,
      "kind": "human_open",
      "player_id": "string",
      "player_name": "string",
      "is_me": true,
      "claimant_label": "string",
      "can_claim": true,
      "can_remove": true
    }
  ],
  "can_manage": true,
  "permissions": {
    "can_start": true,
    "can_edit": true,
    "can_remove_player": true,
    "can_end_game": true
  }
}