Link products to modifier

Link products to a modifier

Sets the complete list of products a modifier applies to. The supplied productIds array is the desired final state: every existing link for the modifier is deleted and then recreated from the array.

Authentication

• Merchant API key in x-api-key (alias x-account-api-key).
• Requires Merchant.product.update.

Body (application/json)

• modifierId (required) — UUID of the modifier. Must belong to your store, otherwise 400 Bad Request (Modifier not found in yours).
• productIds (required) — non-empty array of unique product UUIDs. Every id must belong to your store, otherwise 403 Forbidden (Some products do not belong to your store).

Behavior & side-effects

• Runs in a single transaction: deleteMany({ modifierId }) followed by createMany with skipDuplicates.
• Because it replaces the set, sending a product list that omits a currently linked product unlinks it.
• Returns { message: "Products linked to modifier successfully" }.

Notas: Handler: productModifiersService.linkProductsForModifier. Replacement semantics, not incremental. Duplicated ids in the payload are de-duplicated before the ownership check (@ArrayUnique also rejects duplicates at validation time).