Xsolla-logo

Set value points for items

put/v2/project/{project_id}/admin/items/{item_sku}/value_points/rewards

Assigns value points to one or several items by an SKU. Users receive value points after they purchase these items.

Note that this PUT request overwrites all previously set value points for items in the project.

To avoid unintentional deletion of value points, include all items and their respective value points in each PUT request.

If you only want to update the value points for a specific item while preserving the value points of other items, you should retrieve the current set of value points using a GET request, modify the desired item's value points, and then send the modified set of value points back with the updated value points for the specific item.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Project ID. You can find this parameter in your Publisher Account next to the name of the project.

Example: 44056
item_sku
required
string

Item SKU.

Example: booster_mega_1
Request Body schema: application/json
Array
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

Unique item ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.

amount
required
integer

Amount of value points.

Responses
204

Value point rewards for items were successfully updated.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

404

Item not found. Make sure the project_id and the sku are correct.

Request samples
application/json
[
  • {
    },
  • {
    }
]
Response samples
application/json
{
  • "statusCode": 401,
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred"
}