Update lobby seat | Softmax docs

PUT/v2/lobbies/{lobby_id}/seats/{position}

Changes a draft lobby seat to human, policy, random, or closed.

Authorization

BearerAuth

AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

lobby_id*Lobby Id

Lobby whose seat will be updated.

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

position*Position

Zero-based seat position to update.

Request Body

application/json

expected_revision*Expected Revision

Current lobby revision used to reject stale updates.

Range0 <= value

kind*CoworldLobbySeatKind

Seat type to assign.

Value in

"human_open"
"random"
"human"
"league_player"
"closed"

player_id?|

League player to use for a policy seat.

bash

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

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
  }
}