Skip to content
RallyHere Docs
GitHub

Update Session Player By Uuid V2

POST
/session/v1/session/{session_id}/player/{player_uuid}

Add or invite a player to the session, or change the status of a player already in the session

Required Permissions: For any player (including themselves)any of: session:*, session:promote:any, session:promote:self

Required Session Permissions: None if session is publicly joinable or the player has been invited. SessionPermissions.session_admin for other operations

Authorizations

  • HTTPBearerHeadersOrCookie

Parameters

Path Parameters

session_id
required
string
>= 1 characters <= 128 characters
player_uuid
required
string format: uuid

Request Body required

A request body to update information about a player in a session

object
status

Status that the player would like after the request is complete. Note that some join operations may promote the player from member to leader

string
Allowed values: leader member invited reserved
team_id
required

Which team the player should be on

integer
custom_data

Player-defined custom data

object
key
additional properties
string
>= 1 characters <= 4096 characters

Responses

200

Successful Response

Response to a reques tto update a player in a session

object
status
required

Status of the player after the request is completed

string
Allowed values: leader member invited reserved
team_id
required

Which team the player joined

integer
custom_data

Resulting custom data about the player

object
key
additional properties
string
>= 1 characters <= 4096 characters

Headers

ETag
string

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

403

Forbidden

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

404

Session doesn’t exist or Player is not a member of the session. See error code for more info

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string