PATCH
/products/{productId}
Update a product
PATCH /products/{productId}
Partially updates a product — only the fields present in the body change. Typical uses: price corrections and stock adjustments.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
productId |
path | string (uuid) | yes | Public ID of the product. |
Request body
Required.
Content type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
name |
string | no | New display name. |
description |
string | no | New marketing copy. |
category |
string | no | New category slug. |
price |
number (double) | no | New unit price in EUR. |
stock |
integer | no | New stock level. |
imageUrl |
string (uri) | no | New primary image URL. |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
id |
string (uuid) | yes | Public ID of the product. |
sku |
string | yes | Merchant SKU — unique across the shop. |
name |
string | yes | Display name shown in the shop. |
description |
string | no | Short marketing copy for product pages. |
category |
string | yes | Category slug, e.g. garden-tools. |
price |
number (double) | yes | Unit price in EUR, the shop's base currency. |
stock |
integer | yes | Units currently in stock. |
imageUrl |
string (uri) | no | CDN URL of the primary product image. |
createdAt |
string (date-time) | no | When the product was added to the catalog. |
404 — Not found
| Property | Type | Required | Description |
|---|---|---|---|
code |
string | yes | Stable, machine-readable error code — branch on this, not on the message. |
message |
string | yes | Human-readable explanation, intended for logs and debugging. |