Change a product of the current workspace: its name, SKU, description, supply type, status, availability, price and currency, the product it nests under, its vendor, or the dates and scope of a dated price row.
Use this tool when the user asks to rename a product, change its price, archive it, mark it out of stock, or move it under another product, in any language ("Passe Audit SEO à 1 400 €", "Change SEO audit to 1,400 €"). A new price for a product is always this tool: it never adds an invoice line or drafts an invoice, and it asks for no customer. When the user gives the product_id, call this tool with it directly: the call itself refuses a product that does not exist or that a connected tool synced in, so reading the product first changes nothing. Otherwise find the product_id with well_list_products.
REQUIRED: product_id.
OPTIONAL (only the fields the user wants changed): hidden, name, sku, description, supply_type, status, availability, stock_tracked, unit_price (a decimal string; it needs a currency), currency, parent_product_id, vendor_company_id, scope_company_id, scope_project_id, product_type_project_id, valid_from, valid_to (YYYY-MM-DD), category_ids (the ordered complete set of existing workspace tag UUIDs; [] clears all tags). Pass null to clear an optional field. Select tags by their UUID; do not infer or create tags from labels or product text.
availability here is a manual correction: Well keeps it with who set it and when, and shows it instead of the availability the stock decides. Pass availability: null to remove the correction so the stock decides again. stock_tracked: false makes the product ignore its stock (a service, a product made to order); its own availability then stands.
A product a connected tool synced in (synced: true) cannot be changed in Well: the next sync would overwrite the change. The call then fails; tell the user to change it in that tool.
hidden: true hides the product from Well's lists and figures and keeps it; hidden: false shows it again. It works on a synced product too, since no sync writes it. When the person asks to delete a synced product, well_delete_product refuses and offers this hide: ask the person, then call this tool with only product_id and hidden: true.
For a price request whose unit_price is missing, call this tool with requested_field: "unit_price" and omit unit_price. This request marker opens a follow-up for that field only. It is not sent to the API or stored on the product. Omit requested_field for every other update.
Returns { success: true, product } on success, or { success: false, error } on failure.