BoxItem

Searches BoxItem's gallery of 3D models (boxes, shelves, cabinets, tables, drawers…) to get the model id that create_object needs. Search in Spanish or English, e.g. "caja", "estante", "box".

list_object_models

One warehouse: its size, its containers (boxes, shelves, drawers… that hold items) with their full location ("Table > Box": the box sits on top of the table) and item count, and how many items are loose (not in any container). Use list_container to see what is inside one.

get_warehouse

Everything about one item: quantity, condition, price, weight, size, dates, notes, its web page (url) and links to its photos (valid for about one hour).

get_item

Totals for all visible warehouses, one warehouse or one container: items, units, value, weight, how documented they are, and how many are expired or expire in the next 30 days.

inventory_stats

Gives the user a link to open on their phone and take photos, without signing in. With itemId the photos are added to that item. With warehouseId (and containerId) every photo becomes a new item called "Foto sin nombre N" in that place: after the user says they finished, call list_container or search_items (sort created, desc) to find them, look at each with get_item_photo, and name them with update_items (name, category, tags, quantity). Photos are blurred for faces and stripped of metadata. The link expires in 2 hours by default; creating the items is one operation you can undo with undo_last.

get_upload_link

The items inside one container, or the loose items of a warehouse when containerId is omitted. 50 per page.

list_container

All furniture and containers of one warehouse with their position, size, what they stand on and how many items each container holds, plus its walls (number, length, doors and windows) for hanging things. Use it before creating, moving, stacking or hanging objects.

list_objects

The tags in use with how many items carry each one, most used first. Use these exact tags instead of inventing new ones.

list_tags

Items in the trash that this connection can restore, most recently trashed first, with the place they came from. 50 per page.

list_trash

Lists the user's BoxItem warehouses (own and shared with them) with their access level and item counts. Start here to get warehouse ids.

list_warehouses

Moves a piece of furniture or a container, with all the items inside, to another warehouse the user can edit. It goes by the front wall there; what was on top of it stays and comes down.

move_object_to_warehouse

Moves up to 100 items into a container, or loose, in the same warehouse or another one the user can edit. Give itemIds, or from to pick them without copying ids: "move everything in the toolbox to the table" is one call with from.containerId. If from matches more than 100, the first 100 move and remaining says how many are left: call again with the same from.

move_items

Sends up to 100 items to BoxItem's trash, by itemIds or with from (e.g. everything loose in a warehouse). Nothing is deleted forever from here: they can be restored for 30 days (restore_items or undo_last), and BoxItem leaves the user a notice with a one-tap Recover button. Make sure these are the items the user meant.

trash_items

Turns a floor plan, a photo of a hand drawing, a sketch with at least one measurement or a description ("4 x 6 m, door in the middle of the south wall, shelves along the north wall") into a proposed warehouse: BoxItem fits it to its 50 cm grid (and says what it adjusted), places doors, windows, inner walls and furniture without overlaps, and returns warnings, a preview link and a 3D preview link. NOTHING is saved. For any shape, send polygon: the corners in order, in meters, or in image pixels with polygonUnit image plus knownEdge (one wall whose real length is known; everything is scaled from it). Show the user the warnings and the preview links; adjust the look (colors, textures, the ground around the outside) with revise_floor_plan; only if they agree call apply_floor_plan with the returned previewId. Coordinates: meters from the back-left corner of the room, x grows to the right, z grows toward the front (entrance) wall; in an image, x to the right and y down, with the top of the image as the back wall.

propose_floor_plan

Puts an image (a photo, a picture without background…) on an item in BoxItem, up to 6 per item. If you can pass the image as a file from this chat (image) or it is on the web (imageUrl), BoxItem takes it directly. If not (for example an image the user pasted in the chat or one you made), call it with just itemId: the chat shows a small BoxItem box where the user pastes the image (Ctrl+V), drops it or picks the file, and it goes straight into the item; tell them that. You can't send the image's bytes yourself. An image that already has a transparent background stays as the item's cut-out (no background removal again). Faces are blurred and metadata removed.

add_item_photo

What changed in the user's warehouses: items created, edited, moved, trashed, containers added or moved, shapes changed. Says who did it (a person or an assistant, with the operationId to undo). Use it for "what happened this week?", "who moved the drill?" or "what did you change yesterday?". 50 per page, newest first.

list_changes

Removes one photo from an item: a wrong picture, a duplicate, a blurry one. The number is the same as in get_item_photo; look at it first to be sure it is the right one. undo_last puts it back (BoxItem keeps it for 30 days).

remove_item_photo

Removes a piece of furniture or a container from the warehouse. Nothing is lost: the items inside stay loose in the warehouse and what was on top comes down to its place. Tell the user before doing it.

remove_object

Renames a piece of furniture or a container, turns it into a container (or not), or moves it: to another spot on the floor, on top of another object, or back to the floor. It also hangs it on a wall (mount "wall", with wall, alongM and heightM), moves it along its wall, or takes it down to the floor below (mount "floor"): a TV, a shelf or an image can go either way. Whatever is on top of it moves with it. Only what you send changes.

update_object

Takes up to 100 items out of the trash, back to where they were (loose if that container no longer exists). Ids come from list_trash.

restore_items

Finds items across all the warehouses this connection can see (or one of them) and tells where each one is. The text matches name, description, category, serial number and tags; try singular forms and synonyms in the user's language if nothing comes back. 50 per page.

search_items

Shows you one photo of an item (or its cut-out) as an image, so you can describe what is in it, read a label or a serial number, or suggest a name and tags. get_item says how many photos it has. Photos are already blurred for faces and stripped of metadata.

get_item_photo

Undoes the last change this connection made in BoxItem (a whole call: all the items it moved, created, edited or trashed). Anything someone changed afterwards is left as it is and listed in notes. Use it when the user asks to undo or when you made a mistake; tell the user what was undone.

undo_last

Used only by BoxItem's box in the chat (add_item_photo) to send the image the user pasted, dropped or picked.

upload_item_photo

The ready-made warehouse templates, the room styles (ready combos), the separate room pieces (walls, floors, what is seen outside the windows, light colors, the ground around the outside) and the furniture types propose_floor_plan understands. Use it before create_warehouse, propose_floor_plan or set_room_look.

get_warehouse_building_options

What the user would forget: items already expired or expiring soon (by the days they chose in BoxItem), items with low stock, loose items not in any container, and how many items lack a photo or a price. Returns counts plus the first few of each. Ideal for a weekly review or a morning summary.

inventory_attention