Overview

Modifiers — Base: /v1/product-modifiers

A modifier is a variation or extra that a product can carry: size, ingredients, add-ons, packaging… Each modifier owns a list of options ({ name, price }, plus optional imageUrl and enabled) that the buyer picks from at the terminal.

Modifiers live at store level, not inside a product: you create the modifier once and then link it to as many products as you need.

• Create / list / read / replace / delete the modifier and its options.

• POST /product-modifiers/products/link — set the complete list of products a modifier applies to (replacement semantics: what you send becomes the whole set).

• GET /product-modifiers/:modifierId/products — read that list back.

The inverse view — the modifiers of a given product — lives in the Products folder as GET /products/:productId/modifiers.

Scopes: Merchant.product.{read,create,update,delete}.