Consume item

POST

https://api.lootlocker.com/game/player/inventory/v1/{inventory_id}/consume

Consume an item owned by the authenticated player. For stackable items the optional count body field selects how many to consume (default 1); consuming the whole stack soft-deletes the row. Instanced items are always consumed entirely. Any on_consume behaviour grants are returned in granted.

Request

Authorization

API Key

Add parameter in header

x-session-token

Example:

x-session-token: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Item consumed, with optional behaviour grants

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.lootlocker.com/game/player/inventory/v1//consume' \
--header 'x-session-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "count": 1
}'

Response Example

200 - Example 1

{
    "consumed": true,
    "granted": [
        {
            "source_id": "string",
            "count": 0,
            "type": "string",
            "name": "string",
            "code": "string"
        }
    ]
}

Modified at 2026-09-29 12:58:54

Delete inventory item

Metadata Value