Update a product (only the fields sent; optimistic version); 200 unchanged when nothing differs

patch

https://apis.kentro.live/channel/v1/products/{id}

Scope: products:write, channel:write or admin.

Idempotency: send Idempotency-Key; a retry with the same key replays the first answer.

Rate limit: write class, 1,200 requests per minute per tenant by default (read class 6,000). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a refusal is 429 rate_limited with Retry-After.

Path Params

string

required

length between 1 and 300

The uuid, a legacy 24-hex id, or ext:: (URL-encoded).

Body Params

version

string

length between 1 and 128

sku

length between 1 and 100

barcode

length between 1 and 100

barcodeFormat

enum

name

string

length between 1 and 255

description

length ≤ 100000

shortDescription

length ≤ 10000

unitCost

length ≤ 24

^[0-9]{1,14}(\.[0-9]{1,8})?$

A non-negative decimal amount in currency units ("12.50"); numbers are accepted.

weight

Schema_c2c1933ffe | null

dimensions

Schema_451c17529b | null

requiresShipping

boolean

skipInventoryTracking

boolean

notTaxable

boolean

taxCode

length ≤ 50

lotNumberPolicy

enum

hsCode

length ≤ 20

countryOfOrigin

length between 2 and 2

externalIdentifiers

array of objects

length ≤ 50

Replaces the set.

externalIdentifiers

images

array of objects

length ≤ 50

Replaces the set.

images

metadata

object

Merged by key; a null value removes the key.

components

array of objects

length ≤ 100

components

vendors

array of objects

length ≤ 50

The tenant's vendors this product is sourced from (by id or externalId). Replaces the set; [] clears it; absent keeps it.

vendors

skipEvents

array of objects

length ≤ 50

skipEvents

Headers

Idempotency-Key

string

length between 7 and 50

Any string of 7 to 50 characters that identifies this request (an order number, a webhook id). A retry with the same key and the same body answers the first result with Idempotent-Replayed: true; the same key with a different body is 422 idempotency_key_reused; a concurrent request with the same key is 409 in_progress with Retry-After. Recommended on every write.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Default Response

400Default Response

403Default Response

404Default Response

409Default Response

422Default Response