POST (/users/xuid()/achievements//update)
Updates the progress of an Achievement. The domain for these URIs isachievements.xboxlive.com.
- URI parameters
- Authorization
- Required Request Headers
- Optional Request Headers
- Request body
- HTTP status codes
- Response body
Remarks
- A successful call will return an HTTP status code of 200 with an empty response body.
- If the call results in no change to achievement progress (i.e. it is already unlocked or at the same percent complete), the call will return an HTTP status code of 304 with an empty response body.
URI parameters
Authorization
Required Request Headers
| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Authentication credentials for HTTP authentication. Example value: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| 2| API contract version.|Optional Request Headers
| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Accept-Language| string| List of desired locales and fallbacks (e.g., fr-FR, fr, en-GB, en-WW, en-US). The Achievements service will work through the list until it finds matching localized strings. If none are found, it attempts to match the location defined in the user token, which comes from the user’s IP address. If still no matching localized strings are found, it uses the default strings provided by the title developer/publisher. |Request body
An AchievementUpdateRequest (JSON) object.Sample request
POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update
