Skip to content
RallyHere Docs

Patch Match Player

PATCH
/match/v1/player/{player_uuid}/match/{match_id}

Update player match record for the provided player_uuid ” “and match_id only with provided fields.

Match must still be in a pending state.

Required Permissions:

  • For any match any of: match:*, match:match:edit:any

  • For match if the player is the host any of: match:*, match:match:edit:any, match:match:edit:authority

Authorizations

Parameters

Path Parameters

player_uuid
required
string format: uuid
match_id
required
string

Request Body required

object
player_uuid
string format: uuid
team_id
Any of:
string
party_session_id
Any of:
string
placement
Any of:
integer
joined_match_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
left_match_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
duration_seconds
Any of:
integer
starting_rank
Any of:
string
finishing_rank
Any of:
string
custom_data
Any of:
object
key
additional properties
string

Responses

200

Successful Response

object
last_modified_timestamp

Timestamp of when the resource was last modified

string format: date-time 
2023-01-23T21:07:02.000000+00:00
created_timestamp

Timestamp of when the resource was created

string format: date-time 
2023-01-23T21:07:02.000000+00:00
player_uuid
string format: uuid
team_id
Any of:
string
party_session_id
Any of:
string
placement
Any of:
integer
joined_match_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
left_match_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
duration_seconds
Any of:
integer
starting_rank
Any of:
string
finishing_rank
Any of:
string
custom_data
Any of:
object
key
additional properties
string
match
required

Match the player was in

object
last_modified_timestamp

Timestamp of when the resource was last modified

string format: date-time 
2023-01-23T21:07:02.000000+00:00
created_timestamp

Timestamp of when the resource was created

string format: date-time 
2023-01-23T21:07:02.000000+00:00
type
Any of:
string
state
Any of:

Match States.

string
Allowed values: pending closed
start_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
end_timestamp
Any of:

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

string format: date-time 
2023-01-23T21:07:02.000000+00:00
duration_seconds
Any of:
integer
custom_data
Any of:
object
key
additional properties
string
correlation_id
Any of:
string
sessions

List of session IDs for the match

Array<object>
default:
object
session_id
required

Session ID

string
matchmaking_profile_id
Any of:
string
instances

List of MatchInstances for the match

Array<object>
default:
object
instance_id
Any of:
string
host_player_uuid
Any of:
string format: uuid
region_id
Any of:
string
instance_request_template_id
Any of:
string
map
Any of:
string
game_mode
Any of:
string
host_type
Any of:

Whether the host is another player, or a dedicated instance

string
Allowed values: dedicated player
allocations

List of allocation IDs for the match

Array<object>
default:
object
allocation_id
required

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
object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

404

Not Found

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