Update Match Player

PUT 
/match/v1/player/:player_uuid/match/:match_id

Update player match record for the provided player_uuid and match_id

Match must be in pending state to be updated.

any of: match:*, match:match:edit:any - update any match.

any of: match:*, match:match:edit:any, match:match:edit:authority - update match if the player is the host of the match.

Request

Path Parameters

player_uuid uuidrequired
match_id Match Idrequired

application/json

Body

required

player_uuid uuid

team_id

object

Team ID the player was on

anyOf

MOD1

string

party_session_id

object

Party session ID the player was in

anyOf

MOD1

string

placement

object

Placement of the player in the match

anyOf

MOD1

integer

joined_match_timestamp

object

Time the player joined the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

left_match_timestamp

object

Time the player left the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

duration_seconds

object

Duration in seconds the player was in the match

anyOf

MOD1

integer

starting_rank

object

Starting rank of the player in the match

anyOf

MOD1

string

finishing_rank

object

Finishing rank of the player in the match

anyOf

MOD1

string

custom_data

object

Custom data for the player

anyOf

MOD1

property name* string

Responses

200

Successful Response

application/json

Schema

Schema

last_modified_timestamp date-time

Timestamp of when the resource was last modified

created_timestamp date-time

Timestamp of when the resource was created

player_uuid uuid

team_id

object

Team ID the player was on

anyOf

MOD1

string

party_session_id

object

Party session ID the player was in

anyOf

MOD1

string

placement

object

Placement of the player in the match

anyOf

MOD1

integer

joined_match_timestamp

object

Time the player joined the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

left_match_timestamp

object

Time the player left the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

duration_seconds

object

Duration in seconds the player was in the match

anyOf

MOD1

integer

starting_rank

object

Starting rank of the player in the match

anyOf

MOD1

string

finishing_rank

object

Finishing rank of the player in the match

anyOf

MOD1

string

custom_data

object

Custom data for the player

anyOf

MOD1

property name* string

match

object

required

Match the player was in

last_modified_timestamp date-time

Timestamp of when the resource was last modified

created_timestamp date-time

Timestamp of when the resource was created

type

object

Type of match

anyOf

MOD1

string

state

object

State of the match

anyOf

MatchState

Match States.

string

Possible values: [pending, closed]

start_timestamp

object

Start time of the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

end_timestamp

object

End time of the match

anyOf

Time Zone Aware Datetime

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string

duration_seconds

object

Duration in seconds of the match

anyOf

MOD1

integer

custom_data

object

Custom data for the match

anyOf

MOD1

property name* string

correlation_id

object

Correlation ID for the match

anyOf

MOD1

string

sessions

object[]

List of session IDs for the match

Array [

session_id Session Id (string)required

Possible values: non-empty and <= 128 characters

Session ID

matchmaking_profile_id

object

Profile ID

anyOf

MOD1

string

]

instances

object[]

List of MatchInstances for the match

Array [

instance_id Instance Id (string)required

Possible values: non-empty and <= 128 characters

Instance ID

host_player_uuid

object

Player UUID of the host

anyOf

MOD1

string

region_id

object

Region ID the instance is in

anyOf

MOD1

string

instance_request_template_id

object

Launch request template ID

anyOf

MOD1

string

map

object

Map the instance is on

anyOf

MOD1

string

game_mode

object

Game mode the instance is in

anyOf

MOD1

string

host_type

object

Type of host

anyOf

HostType

Whether the host is another player, or a dedicated instance

string

Possible values: [dedicated, player]

]

allocations

object[]

List of allocation IDs for the match

Array [

allocation_id Allocation Id (string)required

Possible values: non-empty and <= 128 characters

Allocation ID

]

match_id Match Id (string)

Possible values: non-empty and <= 128 characters

Example (from schema)

{
  "last_modified_timestamp": "2023-01-23T21:07:02.000000+00:00",
  "created_timestamp": "2023-01-23T21:07:02.000000+00:00",
  "player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "team_id": "string",
  "party_session_id": "string",
  "placement": 0,
  "joined_match_timestamp": "2023-01-23T21:07:02.000000+00:00",
  "left_match_timestamp": "2023-01-23T21:07:02.000000+00:00",
  "duration_seconds": 0,
  "starting_rank": "string",
  "finishing_rank": "string",
  "custom_data": {},
  "match": {
    "last_modified_timestamp": "2023-01-23T21:07:02.000000+00:00",
    "created_timestamp": "2023-01-23T21:07:02.000000+00:00",
    "type": "string",
    "state": "pending",
    "start_timestamp": "2023-01-23T21:07:02.000000+00:00",
    "end_timestamp": "2023-01-23T21:07:02.000000+00:00",
    "duration_seconds": 0,
    "custom_data": {},
    "correlation_id": "string",
    "sessions": [
      {
        "session_id": "string",
        "matchmaking_profile_id": "string"
      }
    ],
    "instances": [
      {
        "instance_id": "string",
        "host_player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "region_id": "string",
        "instance_request_template_id": "string",
        "map": "string",
        "game_mode": "string",
        "host_type": "dedicated"
      }
    ],
    "allocations": [
      {
        "allocation_id": "string"
      }
    ],
    "match_id": "string"
  }
}

403

Error Codes:

• auth_invalid_key_id - Invalid Authorization - Invalid Key ID in Access Token

• auth_invalid_version - Invalid Authorization - version

• auth_malformed_access - Invalid Authorization - malformed access token

• auth_not_jwt - Invalid Authorization

• auth_token_expired - Token is expired

• auth_token_format - Invalid Authorization - {}

• auth_token_invalid_claim - Token contained invalid claim value: {}

• auth_token_invalid_type - Invalid Authorization - Invalid Token Type

• auth_token_sig_invalid - Token Signature is invalid

• auth_token_unknown - Failed to parse token

• insufficient_permissions - Insufficient Permissions

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

404

Not Found

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