about_boxitem
ChatGPTWhat BoxItem is, that it is free (no plans, payments or hidden costs, sustained by voluntary donations) and this account's current limits. Call it when the user asks about cost, payments or limits.
add_item_photo
ChatGPTPuts 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.
apply_floor_plan
ChatGPTApplies what propose_floor_plan returned, ONLY after the user agreed to it: creates the new warehouse with its room shape and furniture, or replaces the room shape of the existing warehouse the proposal was for. The user can undo it in BoxItem or with undo_last.
create_items
ChatGPTAdds up to 100 items to one warehouse in a single call, each inside a container or loose. Prefer one call with many items over many calls. Ask the user where to put them if it is not clear.
create_object
ChatGPTAdds a piece of furniture or a container (box, shelf, drawer…) to a warehouse: on the floor, on top of another object, or hanging on a wall. Without a position it goes to the first free spot by the front wall. Wall-mounted models (placement "wall", like a flat TV) always hang; any other model hangs with hang: true or a wall number. Containers get a number automatically ("Caja 3").
create_warehouse
ChatGPTCreates a new warehouse for the user: empty (with a shelf, a box and a chest) or from a ready-made template (get_warehouse_building_options). It counts against the user's warehouse limit. The user chooses the name: ask if it is not clear. For a room with a specific shape and furniture use propose_floor_plan instead.
get_account_context
ChatGPTWho you are talking to and what this connection can do: language, time zone, currency, units, today's date, how many warehouses and items they have against their limits, and whether this connection can change things or only read. Call it once at the start of a conversation.
get_item
ChatGPTEverything 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_photo
ChatGPTShows 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_upload_link
ChatGPTGives 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_warehouse
ChatGPTOne 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_building_options
ChatGPTThe 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.
inventory_attention
ChatGPTWhat 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_stats
ChatGPTTotals 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.
list_changes
ChatGPTWhat 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_container
ChatGPTThe items inside one container, or the loose items of a warehouse when containerId is omitted. 50 per page.
list_object_models
ChatGPTSearches 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_objects
ChatGPTAll 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_retired
ChatGPTThe history of items retired from the inventory (Business plan feature; the history stays readable after leaving Business), newest first, 50 per page, with reason, date, amount and totals per currency. Filters: warehouse, reason, date range and text (item name, recipient, document or note).
list_tags
ChatGPTThe tags in use with how many items carry each one, most used first. Use these exact tags instead of inventing new ones.
list_trash
ChatGPTItems in the trash that this connection can restore, most recently trashed first, with the place they came from. 50 per page.
list_warehouses
ChatGPTLists the user's BoxItem warehouses (own and shared with them) with their access level and item counts. Start here to get warehouse ids.
move_items
ChatGPTMoves 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_object_to_warehouse
ChatGPTMoves 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.
propose_floor_plan
ChatGPTTurns 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.
remove_item_photo
ChatGPTRemoves 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_object
ChatGPTRemoves 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.
restore_items
ChatGPTTakes 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.
retire_items
ChatGPTRetires up to 100 items from the active inventory into a permanent history, for things the user no longer has (gifted, sold, used up, broken, lost, returned…) but wants a record of. Everything besides the items is optional: reason, date, amount, document number (invoice, receipt), recipient and note. A retired item can no longer be edited, only deleted by the user in BoxItem; undo_last can revert a retirement made by mistake. Only on the Business plan (of the warehouse owner): otherwise it answers plan_required. Not for throwing things away by mistake: for that, use trash_items.
revise_floor_plan
ChatGPTChanges a proposal from propose_floor_plan before applying it: the room's look (walls, floor, paint color, what is seen outside the windows, the light, the ground around the outside and how wide it is), the name or the ceiling height. Use it when the user asks by text or voice ("make the walls white", "put grass around it"). For a different shape, call propose_floor_plan again. Nothing is saved; the same preview links show the change.
search_items
ChatGPTFinds 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.
set_quantity
ChatGPTSets or adjusts the quantity of up to 100 items, e.g. "I used 3 screws" is delta -3. Give quantity or delta for each.
set_room_look
ChatGPTChanges the look of an existing warehouse the user owns: walls, floor, paint color, what is seen outside the windows, the light and the ground around the outside. Only what you send changes. Piece ids come from get_warehouse_building_options. It can be undone (undo_last or in BoxItem).
trash_items
ChatGPTSends 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.
undo_last
ChatGPTUndoes 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.
update_items
ChatGPTEdits up to 100 items in one call. Only the fields you send change; use clear to empty a field. All changes are saved together or none is.
update_object
ChatGPTRenames 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.
upload_item_photo
ChatGPTUsed only by BoxItem's box in the chat (add_item_photo) to send the image the user pasted, dropped or picked.