Skip to main content

Update Product

PUT 
//:domain/api/products/:id

Update an existing product by ID. All fields are optional on update.

Authentication: Requires Bearer token.

Product type cannot be changed if inventory movements exist (exception: standard -> kit is allowed).

For update (PUT), additional field available:

  • initial_inventory.warehouses[].id (required with initial_inventory)
  • initial_inventory.warehouses[].quantity (required)
  • initial_inventory.warehouses[0].unit_cost (required)
  • images[].id — required only when images[].operation is delete
  • images[].operation — nullable|in:update_create,delete

Returns 422 if product type change is invalid.

Bundle / Kit components: When the resulting product type is bundle or kit, components[] must be present and non-empty. This applies whether you are (a) changing the type from standard → bundle|kit, (b) updating an existing bundle/kit that currently has no components, or (c) sending an empty components: [] payload (which would otherwise wipe components). Returns a 422 validation error on the components field in these cases. Updates that don't touch components on a bundle/kit which already has components are unaffected.

Note (pricing tiers): When sending suppliers[].pricing[] entries with operation: updateOrCreate (or omitted), price is required and must be a numeric value >= 0 and < 100000. To remove a tier, send operation: "delete". Sending price: null will return a 422 validation error on suppliers.{i}.pricing.{j}.price.

Lot tracking fields (optional):

  • is_lot_tracked (boolean, nullable) — enable batch/lot tracking for this product.
  • lot_tracking_method (string, nullable) — required when is_lot_tracked is true. Allowed values: fifo (First-In, First-Out), fefo (First-Expiry, First-Out).

Stock unit of measure (optional):

  • stock_uom_id (integer, nullable) — id of a row in units_of_measure. When omitted, the product is auto-assigned EACH as its stock UoM on create. Pick KG, L, etc. for bulk weight or volume products so quantities, purchase orders, sales orders, and stock takes use the correct unit from day one.

Request​

Responses​

OK

Response Headers
    Content-Type