Skip to main content

Update Supplier Inventory

PUT 
/api/supplier-inventories/:id

Updates a supplier inventory record. Sets source to 'user'. Provide either quantity OR in_stock (not both). On update every field is optional, so you can send a partial update — for example only discontinued or eta — without re-sending quantity/in_stock; the existing stock value is preserved.

Required scope: suppliers:write

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

Authentication: Requires Bearer token.

Fields:

  • supplier_id (required on create, optional on update): ID of the supplier
  • product_id (required on create, optional on update): ID of the product
  • warehouse_id (required on create, optional on update): ID of the warehouse
  • quantity (required on create if in_stock not provided; optional on update): Stock quantity (must be non-negative number). Sending quantity clears in_stock.
  • in_stock (required on create if quantity not provided; optional on update): Boolean stock flag — true means in stock with unspecified quantity. Sending in_stock clears quantity.
  • discontinued (optional): Boolean, marks item as discontinued
  • eta (optional): Expected availability date (ISO date)
  • source (required on create, optional on update): One of: user, api

Request​

Responses​

Created

Response Headers
    Content-Type