Products

Update product

Updates only the fields sent. A kit's costPrice and sellPrice are calculated from its components: values sent for a kit are ignored, setting isKit to true recalculates them, and the response carries the calculated prices.

patch/products/{id}

Request

  • Base URL: https://app.buildworkpro.com/api/v1
  • URL: https://app.buildworkpro.com/api/v1/products/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Headers

Idempotency-Keystring uuid

Idempotent retry key for mutating operations. The first request with a given key executes normally and BuildWorkPro caches the response. Replaying the same key with the same request body (method + path + JSON body, SHA-256 hashed) returns the cached response without re-executing the mutation. Replaying with a DIFFERENT body returns 409 idempotency_key_reused. The cache TTL is 24 hours; after expiry the key is treated as a new operation. Keys are tenant-scoped. Recommended: a fresh UUID v4 per logical operation.

Request body

skustring nullable
namestring
descriptionstring nullable
salesDescriptionstring nullable
typestring
categoryIdinteger nullable
costPricestring nullable
sellPricestring nullable
unitstring nullable
manufacturerIdinteger nullable
manufacturerCodestring nullable
isKitboolean
isActiveboolean
buyTaxPercentstring nullable
sellTaxPercentstring nullable

Response

Updated

Changes

No recorded changes to this operation across all 1 revision of this API.