Add or change a location
Adds a location (a warehouse, a shop, a van), or renames, describes or archives one.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Add our new warehouse in Moorfleet as a stock location.
Your agent callsinventory_save_location$0.001 a call
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"name": "Warehouse Moorfleet",
"description": "Storage and pickup, Moorfleeter Deich 41"
}Use it when
Stock is kept somewhere new, or a place closes.
What it does
Add a location (a warehouse, a shop, a van) or rename, describe or archive one (only when empty).
What comes back
location: its name, description and archived; and created. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
nameRequired | string | 1 to 120 characters. |
new_name | string | Up to 120 characters. |
description | string | Up to 500 characters. |
archived | boolean |
The call
Over MCP, call inventory_save_location on https://api.conecto.chat/mcp/inventory. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/inventory_save_location \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Warehouse Moorfleet","description":"Storage and pickup, Moorfleeter Deich 41"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | The name is empty or too long. | Give a name of 1 to 120 characters. |
name_taken409 | A location has that name already. | Pick another name. |
has_stock409 | The location to archive still holds stock. | Move the stock elsewhere first. |
More Inventory tools
All 10 tools- Add or change items
inventory_save_itemsAdds stock items or changes them by SKU: name, unit, barcode, cost, price and reorder point.$0.005 per item saved - List items
inventory_list_itemsItems with their stock in total and per location, the moving-average cost and the value.Free* - Move stock
inventory_moveChanges stock, all moves or none: receive, ship, transfer between locations, or adjust.$0.005 per move - Count a location
inventory_stocktakeRecords a count of one location; each difference from the books becomes a count move.$0.002 per line counted - Stock history
inventory_historyStock moves, newest first, of one item, at one location, of one kind, or in a period.Free* - List locations
inventory_locationsEvery location with how many items it holds and their value.Free* - Run an inventory report
inventory_reportValuation (what was held on a day and its value), movement (per item in a period, with the cost of goods shipped) or low stock.Free* - Import items from CSV
inventory_importCreates or changes items from a CSV in the file store, with optional quantities per location; all rows or none.$0.001 per row imported
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md