Update a SKU

PATCH 
/skus/:skuId

Partially updates a SKU. Only the fields included in the request body are changed; all other fields retain their current values.

Updating inventory: Include locations in the request body with each entry specifying id (the location identifier) and inventory (absolute on-hand quantity — not a delta). The id field is mandatory when locations is present. The location must already be registered to the SKU — referencing an unknown id returns a LOCATION_NOT_FOUND error.

Immutable fields: productId and skuId cannot be changed after creation.

Status changes: Sellers may include status (ACTIVE or INACTIVE) in the request body. BLOCKED and PENDING_APPROVAL cannot be set via this endpoint.

Blocked SKUs cannot be updated until the block is lifted by the platform.

Request

Responses

200

SKU updated successfully

400

Malformed request or invalid parameter values

401

Missing or invalid credentials

403

Caller does not have permission for this operation

404

The requested SKU does not exist

409

SKU cannot be updated in its current state (e.g., BLOCKED or PENDING_APPROVAL)

422

Request is well-formed but fails semantic validation

500

Unexpected server error. Retry with exponential backoff.