POST /titles/{titleId}/recentplayers

Appends to or updates a user’s list of recent players (unidirectional). This API allows a game client to append to a user’s list of recent players, and to update existing recent player entries. This call only affects the caller’s recent players list (unidirectional).

POST /titles/{titleId}/recentplayers

URI parameters

Parameter	In	Required	Type	Description
titleId	path	TRUE	integer	The titleId of the game that the request is being sent for.

Request header

Name	Required	Type	Description
Authorization	TRUE	integer	Caller must supply an XToken in the XBL 3.0 authorization format. For example, Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType must be set to application/json

Request body

Name	Required	Type	Description
recentPlayers	TRUE		The array of recent players for this user. There should be at least 1 recent players and at most 100 recent players.

Responses

Name	Type	Description
204 No Content		The recent players request was sent successfully.
400 Bad Request	ErrorResponse	An error occurred while processing the request. Possible error codes: “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
Other Status Codes	ThrottledEntity	Too many requests. Headers Retry-After: integer

ClientRecentPlayersRequest

Name	Type	Description
recentPlayers		The array of recent players for this user. There should be at least 1 recent players and at most 100 recent players.

EncounterType

The type of recent players encounter. This field is optional and defaults to Default. Default has no prescribed meaning - it is up to the caller to interpret this value appropriately.

Name	Type	Description
Default	string
Opponent	string
Teammate	string

ErrorResponse

Name	Type	Description
debugMessage	string	Human readable version of the error message that can be used for debugging.
errorCode	string	Error code enum.

Network

Name	Type	Description
XboxLive	string

ThrottledEntity

Name	Type	Description
currentRequests	string	Current number of requests - concurrency or rate.
debugMessage	string	Human readable version of the throttle message that can be used for debugging.
limitType	string	The limit type i.e. concurrency or rate.
maxRequests	string	Max request allowed - concurrency or rate.
periodInSeconds	string	The period in seconds that applies when rate or concurrency limits are exceeded.
version	string	Current throttle contract version.

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

URI parameters

Request header

Request body

Responses

Definitions

ClientRecentPlayersRequest

EncounterType

ErrorResponse

Network

ThrottledEntity

​URI parameters

​Request header

​Request body

​Responses

​Definitions

​ClientRecentPlayersRequest

​EncounterType

​ErrorResponse

​Network

​ThrottledEntity

URI parameters

Request header

Request body

Responses

Definitions

ClientRecentPlayersRequest

EncounterType

ErrorResponse

Network

ThrottledEntity