Create lobby | Softmax docs

POST/v2/leagues/{league_id}/lobbies

Creates a draft lobby for the league's current Coworld.

Authorization

BearerAuth

AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

league_id*League Id

League in which to create the lobby.

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

Request Body

application/json

idempotency_key*Idempotency Key

Unique key that makes repeated create requests return the same lobby.

Length5 <= length <= 200

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 POST "https://example.com/v2/leagues/string/lobbies" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "string"
  }'

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