Update a product (PATCH allowlist enforced)
Updates mutable top-level fields on a product: name, sku, description,
list_price, cost, weight, dimensions, tax_rate_id, category_id,
reorder_point, reorder_qty, metadata, and is_active. Child arrays (variants,
pricing, components) are managed via their own sub-resource endpoints. Returns 404
if the product does not belong to the entity. Requires products:write scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
Only allowlisted top-level fields are accepted. Sending id,
entity_id, cost, searchable_text, has_variants, or any
marketplace ID (shopify_product_id, amazon_asin, etc.)
returns 400 field_not_writable. Cost is read-only here; use
POST /v1/products/{id}/revalue to change it.
Amazon-FBA packaging classification. See Product schema for full enum semantics. Invalid values return 400 invalid_packaging_classification from the canonical validator with hint listing the four legal values.
over_box, sioc, sipp, prep_free "sioc"
Response
Updated product
Arcus ERP product (physical/kit/box/service/variant_parent).

