Xsolla-logo

Set promotion limit for specified userServer-sideAdmin

put/v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}

Sets the number of times the specified user can use a promotion within the limit applied after it was increased or decreased.

User limit API allows you to limit the number of times users can use a promotion. For configuring the user limit itself, go to the Admin section of the desired promotion type:

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
promotion_id
required
integer

Promotion ID. Unique promotion identifier within the project.

Example: 111425
Request Body schema: application/json
required
object
user_external_id
required
string non-empty ^\S+$

User external ID.

available
required
integer

Remaining number of items or promotion uses available to the user within the limit applied.

Responses
200

Promotion limits for a user were successfully received.

401

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

404
422
Request samples
application/json
{
  • "user": {
    },
  • "available": 0
}
Response samples
application/json
{
  • "per_user": {
    }
}