Skip to main content

Bulk Edit Products (Apply to All)

POST 
/api/v2/products/bulk-edit

Apply the same set of changes to all selected products.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Fields:

  • product_ids (required, array, max 500): Product IDs to update
  • changes (required, array): List of changes, each with:
    • field (required, string): Field name to change. Supports scalar product fields (e.g. weight, weight_unit, unit_cost, brand_id), 'pricing' (customer pricing tiers), 'supplier_pricing' (per-supplier pricing tiers — applies to ALL suppliers of each product), 'attribute' (custom attributes), and 'supplier' (link suppliers).
    • operation (required, string): Operation type. Scalars use 'set' / 'clear'. Numeric/pricing/supplier_pricing also accept 'increase_by_amount', 'decrease_by_amount', 'increase_by_percent', 'decrease_by_percent'.
    • value (nullable): New value
    • tier_id (nullable, integer): Required for 'pricing' (references product_pricing_tiers) and 'supplier_pricing' (references supplier_pricing_tiers). Validation routes to the correct table based on the sibling 'field' value.
    • attribute_id (nullable, integer): Required for attribute field changes
    • supplier_id (nullable, integer): Required for supplier field changes

Requires permission: products.update

Request​

Responses​

OK

Response Headers
    Content-Type