EndpointsLobbies

Create lobby

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.

seats?array<>

Optional roster overlay. Unspecified seats keep the default host / champion / random layout.

ranked?Ranked

Count the game toward the league's ladder. Humans claim seats as one of their league players, Random seats are matched by rating, and the finished game is rated like a ladder round.

Defaultfalse
curl -X POST "https://softmax.com/api/observatory/v2/leagues/string/lobbies" \  -H "Content-Type: application/json" \  -d '{    "idempotency_key": "string"  }'
{  "game_address": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "slug": "string",    "catalog_status": "listed"  },  "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  },  "ranked": true,  "rating": {    "status": "pending",    "outcome": "win",    "round_id": "string",    "reason": "string",    "changes": [      {        "position": 0,        "player_id": "string",        "player_name": "string",        "human": true,        "score": 0,        "before": 0,        "after": 0      }    ]  }}