Link a BoM component (sub-product)

POST 
/api/v1/products/:id/components

Links a child product to a product as a bill of materials component, with a maximum of 50 components per product.

Required scope: dpp:draft:write. A WRITE (HMAC + Idempotency-Key). A childProductId MUST be a product your company owns OR a publicly Approved DPP — a cross-tenant child returns 404 CHILD_PRODUCT_NOT_AVAILABLE (never 403). Max 50 components per product; self-reference and circular linkages (depth 5) are rejected.

Request

Responses

201

Created

400

400 — INVALID_JSON, VALIDATION_ERROR, VALIDATION (the {id} path segment is not a UUID), or IDEMPOTENCY_KEY_REQUIRED.

401

401 — INVALID_SIGNATURE or SIGNING_NOT_CONFIGURED (or bearer auth failure).

403

403 — missing scope (FORBIDDEN_SCOPE) or module (FORBIDDEN_MODULE).

404

Product not found, or childProductId not accessible (no existence oracle).

409

Product is frozen (PRODUCT_FROZEN).

422

Cap reached (MAX_COMPONENTS), self-reference (SELF_REFERENCE), or cycle (CIRCULAR_REFERENCE).

429

429 — RATE_LIMITED (per-key limit, reads and writes alike; fails closed, so a limiter outage also returns 429). A limiter-down 429 is deliberately indistinguishable from a quota 429. Carries Retry-After (seconds).

Response Headers

Retry-After

Seconds to wait before retrying (429 only).

RateLimit-Limit

Per-minute request ceiling for this key's tier.

RateLimit-Remaining

Requests left in the current window (floored at 0).

RateLimit-Reset

Seconds until the window resets.

503

503 — the API is not enabled on this environment (FEATURE_DISABLED).