Inventory API

Manages game assets and player inventories.

The Game Provider interacts with the Inventory API to manage items that players can acquire, use, or trade during the game. This includes handling rewards, power-ups, and customization options.

Retrieves the initial items for the specified game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game for which initial items are to be retrieved.

Responses
200

If the initial items are successfully retrieved for the game.

No content

get
/api/inventory/{gameId}/initial-item

No content

Creates an initial item for the specified game.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game for which the initial item is to be created.

Body
itemIdstring · uuidOptional
quantitynumber · doubleOptional
Responses
200

If the initial item is successfully created.

No content

post
/api/inventory/{gameId}/initial-item

No content

Retrieves the item metadata for the specified item in the given game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
itemIdstring · uuidRequired

The unique identifier of the item.

gameIdstring · uuidRequired

The unique identifier of the game.

Responses
200

If the item metadata is successfully retrieved.

No content

get
/api/inventory/{gameId}/item/{itemId}

No content

Retrieves items based on the specified game ID, attribute name, and attribute value.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The ID of the game for which the items should be retrieved.

attributeNamestringRequired

The name of the attribute used for searching items.

attributeValuestringRequired

The value of the attribute used for searching items.

Responses
200

If the items are successfully retrieved based on the specified parameters.

No content

get
/api/inventory/{gameId}/itemAttribute/{attributeName}/{attributeValue}

No content

Retrieves metadata for a specific game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

Responses
200

Returns the game metadata.

get
/api/inventory/{gameId}/meta

Creates a new item for the specified game.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

Body
namestring | nullableOptional
descriptionstring | nullableOptional
localizationKeystring | nullableOptional
allowMultiplebooleanOptional
maxStackinteger · int64 | nullableOptional
typeIdstring · uuidOptional
Responses
200

Returns the newly created item.

post
/api/inventory/{gameId}/meta

Deletes a specific item from the inventory for the specified game.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

itemIdstring · uuidRequired

The unique identifier of the item to be deleted.

Responses
200

If the item is successfully deleted.

No content

delete
/api/inventory/{gameId}/meta/{itemId}

No content

Updates an existing item in the inventory for the specified game.

put
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

itemIdstring · uuidRequired

The unique identifier of the item to update.

Body
descriptionstring | nullableOptional
localizationKeystring | nullableOptional
prefabstring | nullableOptional
allowMultipleboolean | nullableOptional
maxStackinteger · int64 | nullableOptional
Responses
200

If the item is successfully updated.

No content

put
/api/inventory/{gameId}/meta/{itemId}

No content

Adds a new attribute to an existing item in the inventory for the specified game.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

itemIdstring · uuidRequired

The unique identifier of the item to update.

Body
namestring | nullableOptional
localizationKeystring | nullableOptional
valuestring | nullableOptional
Responses
200

If the attribute is successfully added to the item.

No content

post
/api/inventory/{gameId}/meta/{itemId}/attributes

No content

Deletes an attribute from an existing item in the inventory for the specified game.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

itemIdstring · uuidRequired

The unique identifier of the item from which the attribute will be deleted.

attributeIdstring · uuidRequired

The unique identifier of the attribute to delete.

Responses
200

If the attribute is successfully deleted from the item.

No content

delete
/api/inventory/{gameId}/meta/{itemId}/attributes/{attributeId}

No content

Sets the icon for a specific item in the inventory for the specified game.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

itemIdstring · uuidRequired

The unique identifier of the item to update the icon for.

Body
filestring · binaryOptional

The image file to be used as the icon for the item.

Responses
200

If the item icon is successfully updated.

No content

post
/api/inventory/{gameId}/meta/{itemId}/icon

No content

Retrieves the item entries for a specific game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game.

Query parameters
keywordstringOptional

An optional search keyword for filtering the entries.

Responses
200

OK

get
/api/inventory/{gameId}/meta/entries

Retrieves all items in the inventory for the specified game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired

The unique identifier of the game for which items are to be retrieved.

Responses
200

If the items are successfully retrieved for the game.

No content

get
/api/inventory/{gameId}/meta/items

No content

Retrieves the inventory for the specified player and game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player.

gameIdstring · uuidRequired

The unique identifier of the game.

Query parameters
detailedbooleanOptional

A flag indicating whether to retrieve detailed item information.

Responses
200

If the inventory is successfully retrieved.

No content

get
/api/inventory/{playerId}/{gameId}

No content

Adds a specified quantity of an item to the player's inventory in a given game.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player whose inventory will be updated.

gameIdstring · uuidRequired

The unique identifier of the game in which the inventory exists.

itemIdstring · uuidRequired

The unique identifier of the item to be added to the player's inventory.

Query parameters
quantitynumber · doubleOptional

The quantity of the item to be added (default is 1).

Default: 1
Responses
200

If the item is successfully added to the player's inventory.

No content

post
/api/inventory/{playerId}/{gameId}/{itemId}/add

No content

Removes a specified quantity of an item from the player's inventory in a given game.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player whose inventory will be updated.

gameIdstring · uuidRequired

The unique identifier of the game in which the inventory exists.

itemIdstring · uuidRequired

The unique identifier of the item to be removed from the player's inventory.

Query parameters
quantitynumber · doubleOptional

The quantity of the item to be removed (default is 1).

Default: 1
Responses
200

If the item is successfully removed from the player's inventory.

No content

delete
/api/inventory/{playerId}/{gameId}/{itemId}/remove

No content

Retrieves the item from the player's inventory for the specified game.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player.

gameIdstring · uuidRequired

The unique identifier of the game.

Query parameters
Idsstring · uuid[]Optional
Responses
200

If the item is successfully retrieved from the player's inventory.

No content

get
/api/inventory/{playerId}/{gameId}/essentialitems

No content

Retrieves a list of inventory items for a specific player from the event store.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player.

Responses
200

Successfully retrieved inventory items.

get
/api/inventory/{playerId}/listInventoryItems

Transfers a specified quantity of an item from one player's inventory to another player's inventory across different games.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
sourcePlayerIdstring · uuidRequired

The unique identifier of the player from whom the item will be transferred.

destinationPlayerIdstring · uuidRequired

The unique identifier of the player to whom the item will be transferred.

Body
sourceGameIdstring · uuidOptional
itemIdstring · uuidOptional
destinationGameIdstring · uuidOptional
quantitynumber · doubleOptional
Responses
200

If the item transfer is successful.

No content

post
/api/inventory/{sourcePlayerId}/{destinationPlayerId}/transferItem

No content

Performs an item trade between two players in different games.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
traderPlayerIdstring · uuidRequired

ID of the player offering the item.

tradeePlayerIdstring · uuidRequired

ID of the player receiving the item.

Body
traderPlayerIdstring · uuidOptional
tradeePlayerIdstring · uuidOptional
sourceGameIdstring · uuidOptional
sourceItemIdstring · uuidOptional
destinationGameIdstring · uuidOptional
destinationItemIdstring · uuidOptional
quantitynumber · doubleOptional
Responses
200

OK

No content

post
/api/inventory/{traderPlayerId}/{tradeePlayerId}/trade

No content

Reverts the transfer of an item between players' inventories, undoing the previous transfer operation.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
transactionIdstring · uuidRequired

The unique identifier of the transaction to be reverted.

sourcePlayerIdstring · uuidRequired

The unique identifier of the source player involved in the original transfer.

sourceGameIdstring · uuidRequired

The unique identifier of the source game involved in the original transfer.

itemIdstring · uuidRequired

The unique identifier of the item being reverted.

destinationPlayerIdstring · uuidRequired

The unique identifier of the destination player involved in the original transfer.

destinationGameIdstring · uuidRequired

The unique identifier of the destination game involved in the original transfer.

Query parameters
quantitynumber · doubleOptional

The quantity of the item to be reverted. Default is 1.

Default: 1
Responses
200

If the item revert is successful.

No content

get
/api/inventory/{transactionId}/{sourcePlayerId}/{sourceGameId}/{itemId}/{destinationPlayerId}/{destinationGameId}

No content

Deletes an initial item for the specified game by its unique identifier.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
initialItemIdstring · uuidRequired

The unique identifier of the initial item to be deleted.

Responses
200

If the initial item is successfully deleted.

No content

delete
/api/inventory/initial-item/{initialItemId}

No content

Retrieves items based on a specified attribute and its value.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
attributeNamestringRequired

The name of the attribute used for searching items.

attributeValuestringRequired

The value of the attribute used for searching items.

Responses
200

If the items are successfully retrieved based on the specified attribute and value.

No content

get
/api/inventory/item/{attributeName}/{attributeValue}

No content

Retrieves the list of item types, optionally filtered by a search keyword.

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Query parameters
keywordstringOptional

The keyword to filter item types by name, description, or attributes.

Responses
200

OK

No content

get
/api/inventory/types

No content

Creates a new item type with the provided details.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Body
namestring | nullableOptional
descriptionstring | nullableOptional
Responses
200

OK

No content

post
/api/inventory/types

No content

Deletes a specific item type. If the item type is in use, it cannot be deleted.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
typeIdstring · uuidRequired

The ID of the item type to be deleted.

Responses
200

OK

No content

delete
/api/inventory/types/{typeId}

No content

Creates a new attribute for the specified item type.

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
typeIdstring · uuidRequired

The ID of the item type to which the attribute will be added.

Body
namestring | nullableOptional
localizationKeystring | nullableOptional
descriptionstring | nullableOptional
Responses
200

OK

No content

post
/api/inventory/types/{typeId}/attributes

No content

Deletes an attribute of a specific item type.

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
typeIdstring · uuidRequired

The ID of the item type whose attribute will be deleted.

attributeIdstring · uuidRequired

The ID of the attribute to be deleted.

Responses
200

OK

No content

delete
/api/inventory/types/{typeId}/attributes/{attributeId}

No content

get
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired
playerIdstring · uuidRequired
currencystringRequiredDefault: USD
Responses
200

OK

get
/api/inventory/wallet/{gameId}/{playerId}/{currency}
200

OK

delete
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired
playerIdstring · uuidRequired
quantitynumber · doubleRequired
currencystringRequiredDefault: USD
Responses
200

OK

No content

delete
/api/inventory/wallet/{gameId}/{playerId}/{quantity}/{currency}
200

OK

No content

post
Authorizations
AuthorizationstringRequired

Please insert JWT with Bearer into field

Path parameters
gameIdstring · uuidRequired
playerIdstring · uuidRequired
quantitynumber · doubleRequired
currencystringRequiredDefault: USD
Responses
200

OK

No content

post
/api/inventory/wallet/{gameId}/{playerId}/{quantity}/{currency}
200

OK

No content

Last updated