Use up stock
inventory_consumeRecord everyday item use by decreasing stock without going below zero; crossing the low-stock threshold adds the item to the shopping list and notifies flat members.
Instructions
Records that stock of one item was used up by lowering its quantity; use it for everyday use (someone took a roll) instead of inventory_update. Stock never goes below 0. When this use takes the item from above threshold to at or below it, the item is added to the shopping list and the other flat members get a low-stock notification (not the caller). Returns the item, clamped (true when the change was limited at 0), autoPushedShoppingItemId (shopping item created, or null) and a notification warning. Concurrent uses are applied one after another; a rare race gives 409 version_conflict, then retry. Unknown ids give 404 item_not_found. To restock or correct stock use inventory_update.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"delta": "<delta>"
},
"name": "inventory_consume"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Id of the supply item that was used, from inventory_list. | |
| delta | Yes | Whole units used, as a negative number in the item unit (for example -1 when one piece or roll was taken). | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. |