Add a component to a kit/box product
Adds a component product to a kit product, specifying the quantity of the component required
to build one kit unit. The parent product must have product_type: kit; supplying a
non-kit parent returns code: not_a_kit. Duplicate component additions are rejected with
code: component_already_exists.
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
x >= 0Display order of the component within the kit.
Source-system tag for historical migration (e.g. 'bubble_io', 'versa_cloud').
Source-system row id, persisted for batch traceability.
Optional migration-wave identifier, persisted on the row.
Source record timestamp; preserve the origin system's created_at for audit fidelity.
Response
Component added
The response is of type object.

