Swap Players In Session

POST 
/session/v1/session/:session_id/player:swap

Swap two players on different teams. Leaders cannot be swapped

For all sessions:

• Required auth permissions are any of: session:*, session:update:any

• Required session permissions are None

For sessions you are actively in:

• Required auth permissions are any of: session:*, session:update:any, session:update:self

• Required session permissions are SessionPermissions.session_admin

Request

Path Parameters

session_id Session Idrequired

Possible values: non-empty and <= 128 characters

Query Parameters

refresh_ttl Refresh Ttl

Default value: true

application/json

Body

required

players uuid[]required

Possible values: >= 2, <= 2

Two player UUIDs for players who will swap teams

Responses

200

Successful Response

Response Headers

• ETag

  string

  Used to identify this version of the content. Provide with a get request to avoid downloading the same data multiple times.

application/json

Schema

Schema

players

object[]

required

List of updated players

Array [

player_uuid uuid

Player UUID of the player updated

status SessionPlayerStatus (string)required

Possible values: [leader, member, invited, reserved]

What membership state players have in a session

team_id Team Id (integer)required

Which team the player joined

custom_data

object

Resulting custom data about the player

property name* string

]

Example (from schema)

{
  "players": [
    {
      "player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "leader",
      "team_id": 0,
      "custom_data": {}
    }
  ]
}

403

Forbidden

application/json

Schema

Schema

auth_success Auth Success (boolean)

Default value: true

error_code Error Code (string)required
desc Desc (string)required

Example (from schema)

{
  "auth_success": true,
  "error_code": "string",
  "desc": "string"
}

422

Validation Error

application/json

Schema

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...