Revoke inventory items

post/v2/project/{project_id}/inventory/revoke

Revokes access for items of multiple users.

Attention

Only 50 operations can be processed at once. Operations that exceed this limit will be ignored.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

Project ID.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" The unique user identifier on the platform.

required

Array of objects non-empty

Array (non-empty)

sku required	string non-empty Default: "booster_mega_1" Unique item ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.
quantity required	integer >= 1 Default: 1 Number of items of this class needed to be revoked.

comment

string [ 1 .. 255 ] characters

Default: "Item was transferred to another player"

Operation description. For example: "Item was transferred to another player".

platform

string

Default: "xsolla"

Publishing platform the user plays on.

Enum: "playstation_network" "xbox_live" "xsolla" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"

Responses

200

User items revocation successful.

404

Failed to remove this number of items.

Request samples

application/json

[{"user": {"id": "d342dad2-9d59-11e9-a384-42010aa8003f"
},
"comment": "Item was transferred to another player",
"platform": "xsolla",
"items": [{"sku": "booster_mega_1",
"quantity": 1
}
]
}
]

Response samples

application/json

{"count": 2,
"operations": [{"user_id": "0125760a-6810-11e9-84c0-42010aa80029",
"platform": "xsolla",
"comment": "Remove from inventory",
"items": [{"sku": "boots_1",
"quantity": 5,
"balance": 3
},
{"sku": "crystal_pack_1",
"quantity": 3,
"balance": 5
}
]
},
{"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14",
"platform": "xsolla",
"comment": "Cheater",
"items": [{"sku": "helmet_1",
"quantity": 2,
"balance": 0
},
{"sku": "minigun_1",
"quantity": 3,
"balance": 0
}
]
}
]
}