Skip to main content
POST
Modify Item Uses

Authorizations

X-SecretKey
string
header
required

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Body

application/json

This function can both add and remove uses of an inventory item. If the number of uses drops below zero, the item will be removed from active inventory.

This function can both add and remove uses of an inventory item. If the number of uses drops below zero, the item will be removed from active inventory.

ItemInstanceId
string
required

Unique instance identifier of the item to be modified.

PlayFabId
string
required

PlayFab unique identifier of the user whose item is being modified.

UsesToAdd
number
required

Number of uses to add to the item. Can be negative to remove uses.

CustomTags
object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

Response

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object
Example:
Last modified on October 1, 2026