Update an item
update_itemIdempotent
Update selected fields of an inventory item, such as name, brand, location, notes, or value, while leaving omitted fields unchanged.
Instructions
Changes some of an item's fields — name, brand, value, category, notes, the box it's in… — after the person has said what to change (or confirmed suggestions from get_item). Fields left out stay as they are; send null to clear one. tags and links replace the whole list (send the old ones you want to keep). For just moving it use move_item; for using some up or restocking use adjust_stock, which logs the change; for a counter reading use record_reading. Returns the updated item.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The item's id, from search_inventory or list_items | |
| heir | No | Who should have it one day | |
| name | No | What it is, the way people would look for it: "Cordless drill" | |
| tags | No | Tag names; new ones are created. When updating, the full new list | |
| brand | No | Who made it | |
| links | No | Web links: the maker's page, the manual online… When updating, the full new list | |
| model | No | Model name or number, as on its label | |
| notes | No | Anything else worth keeping: where the spare key is, quirks, settings | |
| wanted | No | On the want list: not owned yet — left out of totals, the report, stock and search unless asked for | |
| barcode | No | Its UPC/EAN barcode (also learned into the household's barcode book) | |
| favorite | No | Starred, to find quickly in the app | |
| quantity | No | How many there are; to count stock up or down, adjust_stock logs the change | |
| condition | No | What shape it's in | |
| usageUnit | No | What its counter measures, for maintenance by use (a car's miles, a mower's hours) | |
| categoryId | No | A category id from list_categories | |
| disposedOn | No | When it went, yyyy-mm-dd | |
| locationId | No | Where it's kept: a location id from list_locations (null: nowhere in particular) | |
| templateId | No | The item template it's made from (list_categories), whose fields it then has | |
| valueCents | No | What one is worth now, in cents — used for the insurance report | |
| description | No | A longer description: colour, size, what it's for | |
| disposition | No | No longer had: sold, given, discarded, lost or stolen (null: still have it). Gone items leave lists and totals | |
| isContainer | No | A box, bin or case that holds other items (they set containerItemId to it) | |
| minQuantity | No | Keep at least this many: at or below it, it goes on the shopping list | |
| collectionId | No | The collection it's part of (list_collections) | |
| customFields | No | Values for its category's or template's extra fields, by their keys (list_categories shows them) | |
| disposalNote | No | Who it went to, or what happened (for a lost or stolen claim) | |
| purchaseDate | No | When it was bought, yyyy-mm-dd | |
| serialNumber | No | Its serial number, for warranty claims and insurance | |
| disposalCents | No | What it sold for, in cents | |
| containerItemId | No | The box it's in: an item id with isContainer; it's then wherever the box is | |
| purchasePriceCents | No | What was paid for one, in cents (12999 = $129.99) |