update_product

update_product corrects one product of an e-commerce project: its name, the brand that makes it, its product category, or the merge suggestion the AI attached to it.

The product keeps its raw names (aliases), so its whole history stays attached whatever you change.

When to use

Use it when a row of list_products is right but badly labeled: a range name to tidy ("GUM Trav-Ler Brossettes" into "Trav-Ler"), a product attributed to the wrong brand, a product sorted in the wrong category, or a mergeIntoId pointing at a product that is not a duplicate.

Changing the brand is a human decision the AI respects: the product's raw names are locked, and the automatic grouping of duplicates no longer moves them. The same goes for the category: the AI sorts products after each scan, but never overwrites a category set here.

Input

Set at least one of name, competitorId, category or dismissMergeSuggestion.

Response

{ "success": true, "productId": "clpr1..." }

Errors:

{ "success": false, "error": "product_exists" }

• product_not_found: unknown id or another project.
• brand_not_found: the competitorId is not a competitor of the project, or it was rejected.
• invalid_name: the name holds nothing but the brand and variant attributes (sizes, colors, packs).
• product_exists: the brand already has a product with the same name once variants are set aside. Merge the two with merge_products instead.

Tips and patterns

• Name products after the range, not a variant: "Trav-Ler", not "Trav-Ler 0,9 mm Orange". Variants are folded into the range anyway.
• A mergeIntoId that is right? Use merge_products. Wrong? dismissMergeSuggestion: true.
• To move a product to your own brand, pass competitorId: null.
• Reuse a category exactly as list_products returns it in category. A new spelling creates a separate category in the share of voice.

Related tools

• list_products: every product of the project
• merge_products: merge duplicates
• split_product: move raw names to a new product
• bulk_update_product_status: confirm or reject products