Save BOM as New Version

POST 
/api/manufacturing/boms/:bom/save-as-new-version

Create a new version of the BOM from the submitted fields, leaving the source version untouched. Accepts the same fields as Update BOM. The new version is created as Active with version_number set to the next number for the same product/variant. Auth: requires Bearer token. Path param: bom = source BOM id.

Required scope: manufacturing:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

update_draft_mos (boolean, optional, default false): when true, every still-in-Draft manufacturing order that references the old version is moved onto the new version. Started/completed orders keep their pinned version.

Contractor-supplied components: set component_lines[].is_contractor_supplied to true when the contract manufacturer provides that component from their own stock. It stays in the recipe and in lot genealogy, but is never allocated from your inventory, never reported as short, and never costed into the finished good — its cost is already inside the contractor's price on the purchase order. Defaults to false; omit the key on an update and the stored value is left unchanged.

Request

Responses

201

Created

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.