Skip to content

Create Match Player

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

Create player match record for the provided player_uuid and match_id

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

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

Forbidden

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