Xsolla-logo

Increase promotion limit for specified userServer-sideAdmin

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

Increases the remaining number of times the specified user can use the promotion within the limit applied.

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": 1
}
Response samples
application/json
{
  • "per_user": {
    }
}