---
title: "Create Cart"
method: POST
path: "/v1/carts"
tags: ["manufacturing-v1"]
---

# Create Cart

`POST /v1/carts`

Create a priced cart and a website link a person can pay from.

The cart is quoted immediately with the same rules as `POST /v1/quotes`.
Choose a `shipping_option_id` from `quote.fulfillment.shipping_options`
(now or with `PATCH`) to complete `totals`.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- V1CartCreateRequest — Create a cart: the quote basket plus checkout choices.
  - `items` V1QuoteItemRequest[], required
    - `generate_production_files` boolean — Prepare production files asynchronously from this same manufacturing evaluation.
    - `design_id` string, required
    - `quantity` integer — Completed units of this design.
    - `configuration` V1ManufacturingConfiguration, required — Canonical manufacturing intent used by both DFM and quotes. Precedence is part override, then defaults, then unset. Process is owned by the analyzer and is intentionally absent from this request model. Parts connected by located welds with the same powder-coat color are coated as a weldment and may share a hanging opening. Disconnected parts and groups with different colors must each have their own opening.
      - `defaults` V1DefaultSelection — Part-agnostic choices applied to every compatible part. `material_id` applies to sheet-metal parts only and `tube_profile_id` to tube-laser parts only; the other fields apply to every part. Hole-level operations are never defaults because hole IDs are scoped to one part.
        - `material_id` string, nullable
        - `tube_profile_id` string, nullable
        - `powder_coat_color_id` string, nullable
        - `finish_id` string, nullable
      - `parts` V1PartConfiguration[]
        - `material_id` string, nullable
        - `tube_profile_id` string, nullable
        - `powder_coat_color_id` string, nullable
        - `finish_id` string, nullable
        - `part_id` string, required
        - `taps` V1TapOperation[]
          - `hole_id` integer, required
          - `tap_id` string, required — `id` from GET /v1/hardware/taps.
        - `studs` V1StudOperation[]
          - `hole_id` integer, required
          - `stud_id` string, required — `id` from GET /v1/hardware/studs.
          - `side` 'top' | 'bottom' — Sheet face the stud is installed from.
        - `nuts` V1NutOperation[]
          - `hole_id` integer, required
          - `nut_id` string, required — `id` from GET /v1/hardware/nuts.
          - `side` 'top' | 'bottom' — Sheet face the nut is installed from.
        - `standoffs` V1StandoffOperation[]
          - `hole_id` integer, required
          - `standoff_id` string, required — `id` from GET /v1/hardware/standoffs.
          - `side` 'top' | 'bottom' — Sheet face the standoff is installed from.
        - `countersinks` V1CountersinkOperation[]
          - `hole_id` integer, required
          - `outer_diameter_mm` number, required
          - `angle` 82 | 90, required
          - `side` 'top' | 'bottom', required — Sheet face the countersink is cut into.
      - `assembly_operations` V1WeldingOperation[]
        - `type` 'weld'
        - `method` 'auto' | 'mig' | 'tig'
        - `weld_length_mm` number, nullable — Total deposited weld length, excluding stitch gaps. Calculated from the path and optional stitch pattern when omitted; if supplied it must match.
        - `stitch` V1StitchWeldPattern — Repeat beads along the guide's arc length; clip the last bead at its end. Pitch is start-to-start spacing, not the unwelded gap. Reversing the guide changes the starting end. A closed guide is traversed once, without wrapping.
          - `length_mm` number, required
          - `pitch_mm` number, required
          - `offset_mm` number
        - `path_points_mm` V1WeldPoint[], nullable — Ordered seam polyline in millimetres, in the analyzed assembly model's Z-up coordinate frame (before GLTF axis conversion or viewer scaling). GET the design's weld_candidates_url for located paths. Its length must match weld_length_mm within 0.01 mm or one part per million for a continuous weld. Required for a ready DFM report or quote. Omitting it returns a blocking weld_path_required finding; no location is invented. With stitch, this is the full guide; only the repeated beads are welded and priced.
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `part_instance_ids` string[], required
        - `weld_finish` 'none' | 'rough' | 'fine'
        - `joint_access` 'open' | 'tight' | 'blind'
      - `accepted_risks` string[] — Findings the customer accepts responsibility for. Holes or countersinks near a bend may distort when the part is formed; listing the code here turns that finding into a warning (`accepted: true`) so the part can be quoted and ordered.
    - `client_reference_id` string, nullable
    - `quantity_options` integer[] — Up to ten alternative quantities to price alongside `quantity`. Each is returned in `quantity_options[]` with its unit and total price for this exact configuration; the quote's own totals and fulfillment still use `quantity`.
  - `ship_to` V1ShipTo
    - `name` string, required
    - `company` string, nullable
    - `street1` string, required
    - `street2` string, nullable
    - `city` string, required
    - `state` string, required
    - `postal_code` string, required
    - `country` 'US'
    - `phone` string, nullable
    - `email` string, nullable
  - `shipping_option_id` string, nullable — `id` of a `fulfillment.shipping_options[]` entry from the cart's quote. Encodes both carrier service and production speed.
  - `client_reference_id` string, nullable

## Response `201`

Cart created.

- V1Cart — A server-side basket a human can open, review, and pay on the website. The cart re-quotes on every change; `quote` is the latest priced result. `cart_url` embeds an unguessable token, so anyone holding the link can check out.
  - `id` string, required
  - `revision` integer
  - `object` 'cart'
  - `status` 'open' | 'checked_out' | 'expired', required
  - `cart_url` string, required
  - `items` V1QuoteItemRequest[], required
    - `generate_production_files` boolean — Prepare production files asynchronously from this same manufacturing evaluation.
    - `design_id` string, required
    - `quantity` integer — Completed units of this design.
    - `configuration` V1ManufacturingConfiguration, required — Canonical manufacturing intent used by both DFM and quotes. Precedence is part override, then defaults, then unset. Process is owned by the analyzer and is intentionally absent from this request model. Parts connected by located welds with the same powder-coat color are coated as a weldment and may share a hanging opening. Disconnected parts and groups with different colors must each have their own opening.
      - `defaults` V1DefaultSelection — Part-agnostic choices applied to every compatible part. `material_id` applies to sheet-metal parts only and `tube_profile_id` to tube-laser parts only; the other fields apply to every part. Hole-level operations are never defaults because hole IDs are scoped to one part.
        - `material_id` string, nullable
        - `tube_profile_id` string, nullable
        - `powder_coat_color_id` string, nullable
        - `finish_id` string, nullable
      - `parts` V1PartConfiguration[]
        - `material_id` string, nullable
        - `tube_profile_id` string, nullable
        - `powder_coat_color_id` string, nullable
        - `finish_id` string, nullable
        - `part_id` string, required
        - `taps` V1TapOperation[]
          - `hole_id` integer, required
          - `tap_id` string, required — `id` from GET /v1/hardware/taps.
        - `studs` V1StudOperation[]
          - `hole_id` integer, required
          - `stud_id` string, required — `id` from GET /v1/hardware/studs.
          - `side` 'top' | 'bottom' — Sheet face the stud is installed from.
        - `nuts` V1NutOperation[]
          - `hole_id` integer, required
          - `nut_id` string, required — `id` from GET /v1/hardware/nuts.
          - `side` 'top' | 'bottom' — Sheet face the nut is installed from.
        - `standoffs` V1StandoffOperation[]
          - `hole_id` integer, required
          - `standoff_id` string, required — `id` from GET /v1/hardware/standoffs.
          - `side` 'top' | 'bottom' — Sheet face the standoff is installed from.
        - `countersinks` V1CountersinkOperation[]
          - `hole_id` integer, required
          - `outer_diameter_mm` number, required
          - `angle` 82 | 90, required
          - `side` 'top' | 'bottom', required — Sheet face the countersink is cut into.
      - `assembly_operations` V1WeldingOperation[]
        - `type` 'weld'
        - `method` 'auto' | 'mig' | 'tig'
        - `weld_length_mm` number, nullable — Total deposited weld length, excluding stitch gaps. Calculated from the path and optional stitch pattern when omitted; if supplied it must match.
        - `stitch` V1StitchWeldPattern — Repeat beads along the guide's arc length; clip the last bead at its end. Pitch is start-to-start spacing, not the unwelded gap. Reversing the guide changes the starting end. A closed guide is traversed once, without wrapping.
          - `length_mm` number, required
          - `pitch_mm` number, required
          - `offset_mm` number
        - `path_points_mm` V1WeldPoint[], nullable — Ordered seam polyline in millimetres, in the analyzed assembly model's Z-up coordinate frame (before GLTF axis conversion or viewer scaling). GET the design's weld_candidates_url for located paths. Its length must match weld_length_mm within 0.01 mm or one part per million for a continuous weld. Required for a ready DFM report or quote. Omitting it returns a blocking weld_path_required finding; no location is invented. With stitch, this is the full guide; only the repeated beads are welded and priced.
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `part_instance_ids` string[], required
        - `weld_finish` 'none' | 'rough' | 'fine'
        - `joint_access` 'open' | 'tight' | 'blind'
      - `accepted_risks` string[] — Findings the customer accepts responsibility for. Holes or countersinks near a bend may distort when the part is formed; listing the code here turns that finding into a warning (`accepted: true`) so the part can be quoted and ordered.
    - `client_reference_id` string, nullable
    - `quantity_options` integer[] — Up to ten alternative quantities to price alongside `quantity`. Each is returned in `quantity_options[]` with its unit and total price for this exact configuration; the quote's own totals and fulfillment still use `quantity`.
  - `ship_to` V1ShipTo
    - `name` string, required
    - `company` string, nullable
    - `street1` string, required
    - `street2` string, nullable
    - `city` string, required
    - `state` string, required
    - `postal_code` string, required
    - `country` 'US'
    - `phone` string, nullable
    - `email` string, nullable
  - `shipping_option_id` string, nullable
  - `selected_shipping_option` V1ShippingOption
    - `id` string, required
    - `production_speed` 'standard' | 'expedited', required
    - `carrier` string, required
    - `service` string, required
    - `amount_cents` integer, required
    - `production_surcharge_cents` integer
    - `planned_ship_date` string, date, required
    - `estimated_delivery_date` string, date, required
    - `delivery_days` integer, required
    - `delivery_date_guaranteed` boolean
    - `requires_freight` boolean
    - `rate_source` 'live' | 'estimated', required
  - `quote` V1Quote, required — An immutable priced evaluation of a basket of designs. Quotes never select a shipping option or compute tax; each `fulfillment.shipping_options[].amount_cents` is additive at order time. To change a quote, create a new one.
    - `id` string, required
    - `object` 'quote'
    - `api_version` '2026-09-01'
    - `dfm_ruleset_version` string
    - `status` 'processing' | 'requires_input' | 'ready' | 'blocked' | 'expired' | 'failed', required
    - `status_url` string, required
    - `design_id` string, nullable
    - `currency` 'usd'
    - `amount_subtotal_cents` integer, nullable — Sum of `items[].amount_cents`.
    - `amount_shipping_cents` integer, nullable — Null: no shipping option is selected on a quote.
    - `amount_tax_cents` integer, nullable — Null: tax is calculated at order time.
    - `amount_total_cents` integer, nullable — `amount_subtotal_cents` + `amount_shipping_cents` + `amount_tax_cents`, treating null as 0.
    - `items` V1QuotedDesign[]
      - `pricing_token` string, nullable — Owner-bound pricing snapshot, valid for five minutes. Use quotes.reprice for quantity-only edits; checkout still requires a full quote.
      - `design_id` string, required
      - `quantity` integer, required — Completed units of the design.
      - `status` 'requires_input' | 'ready' | 'blocked'
      - `client_reference_id` string, nullable
      - `quantity_options` V1QuantityOption[] — Prices at the alternative quantities requested in `quantity_options`, for the same configuration.
        - `quantity` integer, required
        - `unit_amount_cents` integer, required
        - `amount_cents` integer, required
        - `line_items` V1QuoteLineItem[]
          - `part_id` string, required
          - `process` 'sheet_metal' | 'tube_laser', required
          - `quantity` integer, required — Manufactured parts: design quantity × `instance_count`.
          - `unit_amount_cents` integer, required — Effective price per manufactured part after discounts, including operations.
          - `amount_cents` integer, required — `unit_amount_cents` × `quantity`.
          - `discounts` V1LineItemDiscount[]
            - `type` 'quantity', required
            - `percent` number, required
            - `unit_amount_cents` integer, required — Reduction per manufactured part.
            - `amount_cents` integer, required — `unit_amount_cents` × `quantity`.
          - `breakdown` V1LineItemBreakdown[]
            - `type` 'base' | 'bends' | 'taps' | 'studs' | 'nuts' | 'standoffs' | 'countersinks' | 'powder_coat' | 'finish', required
            - `unit_amount_cents` integer, required
            - `amount_cents` integer, required
          - `material_id` string, nullable
          - `tube_profile_id` string, nullable
          - `pricing_version` string, nullable
          - `pricing` V1PricingMetadata — Which pricing rules produced a number, for audit and reproducibility. Contains only rule identifiers; never costs, margins, or rates.
            - `version` string, required
            - `calculator` string, required
            - `components` object — Pricing component name to the rule version applied.
            - `config_hash` string, required — Fingerprint of the rule set; equal hashes priced identically.
        - `assembly_operations_amount_cents` integer
      - `unit_amount_cents` integer, nullable — `amount_cents` ÷ `quantity`, rounded.
      - `amount_cents` integer, nullable — Sum of `line_items[].amount_cents` plus `assembly_operations_amount_cents`.
      - `assembly_operations_amount_cents` integer
      - `dfm` V1DFMReport, required — An immutable evaluation of one configuration. To act on `requires_input` or `blocked`, submit a new request with the corrected configuration; reports are never updated in place.
        - `id` string, required
        - `object` 'dfm_report'
        - `api_version` '2026-09-01'
        - `dfm_ruleset_version` string
        - `design_id` string, required
        - `configuration_hash` string, required
        - `status` 'requires_input' | 'ready' | 'blocked'
        - `review_url` string, nullable — Website page showing this exact configuration in the 3D configurator, where a person can adjust it and save. Read the saved configuration back with `GET /v1/review-links/{id}`.
        - `review_link_id` string, nullable
        - `configuration` V1ManufacturingConfiguration, required — Canonical manufacturing intent used by both DFM and quotes. Precedence is part override, then defaults, then unset. Process is owned by the analyzer and is intentionally absent from this request model. Parts connected by located welds with the same powder-coat color are coated as a weldment and may share a hanging opening. Disconnected parts and groups with different colors must each have their own opening.
          - `defaults` V1DefaultSelection — Part-agnostic choices applied to every compatible part. `material_id` applies to sheet-metal parts only and `tube_profile_id` to tube-laser parts only; the other fields apply to every part. Hole-level operations are never defaults because hole IDs are scoped to one part.
            - `material_id` string, nullable
            - `tube_profile_id` string, nullable
            - `powder_coat_color_id` string, nullable
            - `finish_id` string, nullable
          - `parts` V1PartConfiguration[]
            - `material_id` string, nullable
            - `tube_profile_id` string, nullable
            - `powder_coat_color_id` string, nullable
            - `finish_id` string, nullable
            - `part_id` string, required
            - `taps` V1TapOperation[]
              - …
            - `studs` V1StudOperation[]
              - …
            - `nuts` V1NutOperation[]
              - …
            - `standoffs` V1StandoffOperation[]
              - …
            - `countersinks` V1CountersinkOperation[]
              - …
          - `assembly_operations` V1WeldingOperation[]
            - `type` 'weld'
            - `method` 'auto' | 'mig' | 'tig'
            - `weld_length_mm` number, nullable — Total deposited weld length, excluding stitch gaps. Calculated from the path and optional stitch pattern when omitted; if supplied it must match.
            - `stitch` V1StitchWeldPattern — Repeat beads along the guide's arc length; clip the last bead at its end. Pitch is start-to-start spacing, not the unwelded gap. Reversing the guide changes the starting end. A closed guide is traversed once, without wrapping.
              - …
            - `path_points_mm` V1WeldPoint[], nullable — Ordered seam polyline in millimetres, in the analyzed assembly model's Z-up coordinate frame (before GLTF axis conversion or viewer scaling). GET the design's weld_candidates_url for located paths. Its length must match weld_length_mm within 0.01 mm or one part per million for a continuous weld. Required for a ready DFM report or quote. Omitting it returns a blocking weld_path_required finding; no location is invented. With stitch, this is the full guide; only the repeated beads are welded and priced.
              - …
            - `part_instance_ids` string[], required
            - `weld_finish` 'none' | 'rough' | 'fine'
            - `joint_access` 'open' | 'tight' | 'blind'
          - `accepted_risks` string[] — Findings the customer accepts responsibility for. Holes or countersinks near a bend may distort when the part is formed; listing the code here turns that finding into a warning (`accepted: true`) so the part can be quoted and ordered.
        - `parts` V1PartDFM[], required
          - `part_id` string, required
          - `status` 'requires_input' | 'ready' | 'blocked'
          - `issues` V1DFMIssue[]
            - `code` string, required
            - `message` string, required
            - `severity` 'blocking' | 'warning' | 'info'
            - `customer_visible` boolean — False for internal review warnings that customer interfaces must omit.
            - `accepted` boolean — True when the caller listed this finding in `configuration.accepted_risks`.
            - `source` 'geometry' | 'manufacturing_rules', required — `geometry` findings come from analyzing the uploaded file; `manufacturing_rules` findings depend on the selected material, tooling, or operations.
            - `part_id` string, nullable
            - `hole_id` integer, nullable
            - `bend_id` integer, nullable
            - `operation` string, nullable — Configuration field the finding refers to, e.g. `taps`.
            - `details` object — Code-specific measurements. Numeric keys use `_mm`, `_degrees`, `_psi`, or `_tons` suffixes; see the documentation for each code.
          - `capabilities` V1PartCapabilities — Keyed by the configuration field each capability governs.
            - `taps` V1OperationCapability, required
              - …
            - `studs` V1OperationCapability, required
              - …
            - `standoffs` V1OperationCapability
              - …
            - `nuts` V1OperationCapability, required
              - …
            - `countersinks` V1OperationCapability, required
              - …
            - `powder_coat_color_id` V1OperationCapability, required
              - …
            - `finish_id` V1OperationCapability, required
              - …
            - `holes` V1HoleCapabilities[] — Per-hole eligibility; authoritative for hole operations.
              - …
          - `files` V1PartFiles — Stable authenticated links; storage paths remain private.
            - `source_step_url` string, required
            - `normalized_step_url` string, required — The analyzed STEP re-oriented into the coordinate frame used by the returned geometry.
            - `formed_model_url` string, required
            - `flat_pattern_step_url` string, nullable
            - `flat_pattern_model_url` string, nullable
            - `production_step_url` string, nullable
            - `production_model_url` string, nullable
            - `production_flat_step_url` string, nullable
            - `production_flat_model_url` string, nullable
            - `production_dxf_url` string, nullable — Laser-ready DXF of the prepared flat pattern, unfolded with the tooling K-factor. Sheet-metal parts only.
            - `production_bend_lines_dxf_url` string, nullable — The same flat pattern with bend lines drawn; sheet-metal parts with bends.
          - `image_url` string, nullable — Rendered picture of this part with the configured taps, studs, nuts, and countersinks marked on the face they are applied from. Uses the production geometry once it is ready. Accepts the same `view`, `format`, and `width` parameters as design images.
          - `transformations` V1ManufacturingTransformation[]
            - `type` 'hole_diameter_adjustment' | 'bend_radius_adjustment' | 'material_thickness_adjustment' | 'hole_face_inverted', required
            - `code` 'tap_hole_diameter' | 'stud_hole_diameter' | 'nut_hole_diameter' | 'standoff_hole_diameter' | 'countersink_inner_diameter' | 'tooling_bend_radius' | 'stocked_material_thickness' | 'hole_normal_inverted', required
            - `message` string, required
            - `hole_id` integer, nullable
            - `bend_id` integer, nullable
            - `from_mm` number, nullable
            - `to_mm` number, nullable
          - `production_design_id` string, nullable — Identifier of the prepared production geometry once files are ready. Equals `part_id` when the uploaded geometry needed no change.
          - `tooling` V1ProductionTooling — The press-brake setup the production files were prepared for.
            - `k_factor` number, required
            - `bend_radius_mm` number, nullable
            - `punch_id` string, nullable
            - `die_id` string, nullable
            - `calibration_id` string, nullable
          - `bend_input_ready` boolean — Corrected STEP and material calibration are ready for bend planning. May become true while DXF and display models are still processing.
          - `production_warnings` string[] — Non-blocking notes from file preparation, e.g. DXF checks.
        - `requirements` V1Requirement[]
          - `code` string, required
          - `message` string, required
          - `part_id` string, nullable
          - `part_ids` string[]
          - `field` string, nullable
          - `allowed_values_url` string, nullable
        - `assembly_issues` V1DFMIssue[]
          - `code` string, required
          - `message` string, required
          - `severity` 'blocking' | 'warning' | 'info'
          - `customer_visible` boolean — False for internal review warnings that customer interfaces must omit.
          - `accepted` boolean — True when the caller listed this finding in `configuration.accepted_risks`.
          - `source` 'geometry' | 'manufacturing_rules', required — `geometry` findings come from analyzing the uploaded file; `manufacturing_rules` findings depend on the selected material, tooling, or operations.
          - `part_id` string, nullable
          - `hole_id` integer, nullable
          - `bend_id` integer, nullable
          - `operation` string, nullable — Configuration field the finding refers to, e.g. `taps`.
          - `details` object — Code-specific measurements. Numeric keys use `_mm`, `_degrees`, `_psi`, or `_tons` suffixes; see the documentation for each code.
        - `production_files` V1ProductionFilesStatus, required
          - `status` 'skipped' | 'queued' | 'processing' | 'ready' | 'failed', required
          - `status_url` string, nullable
          - `reason` 'not_requested' | 'disabled_by_request' | 'requirements_missing' | 'dfm_blocked', nullable
          - `error` V1ResourceError
            - `code` string, required
            - `message` string, required
          - `review_warning` V1ManufacturingReviewWarning — An advisory for manual preparation; never a checkout requirement.
            - `design_id` string, required
            - `code` 'bend_radius_review' | 'hole_correction_review' | 'manufacturing_file_review', required
            - `message` string, required
          - `corrections_applied` boolean
      - `requirements` V1Requirement[]
        - `code` string, required
        - `message` string, required
        - `part_id` string, nullable
        - `part_ids` string[]
        - `field` string, nullable
        - `allowed_values_url` string, nullable
      - `line_items` V1QuoteLineItem[]
        - `part_id` string, required
        - `process` 'sheet_metal' | 'tube_laser', required
        - `quantity` integer, required — Manufactured parts: design quantity × `instance_count`.
        - `unit_amount_cents` integer, required — Effective price per manufactured part after discounts, including operations.
        - `amount_cents` integer, required — `unit_amount_cents` × `quantity`.
        - `discounts` V1LineItemDiscount[]
          - `type` 'quantity', required
          - `percent` number, required
          - `unit_amount_cents` integer, required — Reduction per manufactured part.
          - `amount_cents` integer, required — `unit_amount_cents` × `quantity`.
        - `breakdown` V1LineItemBreakdown[]
          - `type` 'base' | 'bends' | 'taps' | 'studs' | 'nuts' | 'standoffs' | 'countersinks' | 'powder_coat' | 'finish', required
          - `unit_amount_cents` integer, required
          - `amount_cents` integer, required
        - `material_id` string, nullable
        - `tube_profile_id` string, nullable
        - `pricing_version` string, nullable
        - `pricing` V1PricingMetadata — Which pricing rules produced a number, for audit and reproducibility. Contains only rule identifiers; never costs, margins, or rates.
          - `version` string, required
          - `calculator` string, required
          - `components` object — Pricing component name to the rule version applied.
          - `config_hash` string, required — Fingerprint of the rule set; equal hashes priced identically.
      - `assembly_operations` V1WeldingOperation[]
        - `type` 'weld'
        - `method` 'auto' | 'mig' | 'tig'
        - `weld_length_mm` number, nullable — Total deposited weld length, excluding stitch gaps. Calculated from the path and optional stitch pattern when omitted; if supplied it must match.
        - `stitch` V1StitchWeldPattern — Repeat beads along the guide's arc length; clip the last bead at its end. Pitch is start-to-start spacing, not the unwelded gap. Reversing the guide changes the starting end. A closed guide is traversed once, without wrapping.
          - `length_mm` number, required
          - `pitch_mm` number, required
          - `offset_mm` number
        - `path_points_mm` V1WeldPoint[], nullable — Ordered seam polyline in millimetres, in the analyzed assembly model's Z-up coordinate frame (before GLTF axis conversion or viewer scaling). GET the design's weld_candidates_url for located paths. Its length must match weld_length_mm within 0.01 mm or one part per million for a continuous weld. Required for a ready DFM report or quote. Omitting it returns a blocking weld_path_required finding; no location is invented. With stitch, this is the full guide; only the repeated beads are welded and priced.
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `part_instance_ids` string[], required
        - `weld_finish` 'none' | 'rough' | 'fine'
        - `joint_access` 'open' | 'tight' | 'blind'
      - `pricing_version` string, nullable
      - `pricing` V1PricingMetadata — Which pricing rules produced a number, for audit and reproducibility. Contains only rule identifiers; never costs, margins, or rates.
        - `version` string, required
        - `calculator` string, required
        - `components` object — Pricing component name to the rule version applied.
        - `config_hash` string, required — Fingerprint of the rule set; equal hashes priced identically.
    - `requirements` V1Requirement[]
      - `code` string, required
      - `message` string, required
      - `part_id` string, nullable
      - `part_ids` string[]
      - `field` string, nullable
      - `allowed_values_url` string, nullable
    - `fulfillment` V1FulfillmentEstimate
      - `production` V1ProductionEstimate[], required
        - `speed` 'standard' | 'expedited', required
        - `production_days` integer, required
        - `estimated_ship_date` string, date, required
        - `surcharge_cents` integer
        - `explanation` string[]
      - `shipping_status` 'destination_required' | 'ready' | 'invalid_address' | 'service_unavailable', required
      - `shipping_options` V1ShippingOption[]
        - `id` string, required
        - `production_speed` 'standard' | 'expedited', required
        - `carrier` string, required
        - `service` string, required
        - `amount_cents` integer, required
        - `production_surcharge_cents` integer
        - `planned_ship_date` string, date, required
        - `estimated_delivery_date` string, date, required
        - `delivery_days` integer, required
        - `delivery_date_guaranteed` boolean
        - `requires_freight` boolean
        - `rate_source` 'live' | 'estimated', required
      - `requires_freight` boolean
      - `freight_reasons` string[]
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `error` V1ResourceError
      - `code` string, required
      - `message` string, required
  - `totals` V1CartTotals, required — Every amount the website's checkout charges, computed by the API.
    - `amount_subtotal_cents` integer, required — Manufacturing: Σ quote items.
    - `amount_shipping_cents` integer, nullable — Selected shipping option, including the freight surcharge when the order requires LTL. Null until an option is selected.
    - `amount_production_surcharge_cents` integer, nullable — Expedited production fee of the selected option; 0 for standard.
    - `amount_tax_cents` integer, nullable — Sales tax for the destination; see `tax_status`.
    - `tax_status` 'calculated' | 'destination_required' | 'unavailable', required — `unavailable` means tax could not be calculated now and will be charged at checkout.
    - `amount_total_cents` integer, required — Sum of the known amounts above; what checkout will charge before any promotion code.
  - `dfm_run_ids` object — DFM report id per `design_id` whose production files (resized holes, calibrated bends, laser DXF) are prepared for this cart. Poll `GET /v1/dfm/{id}` for `production_files.status`.
  - `designs` V1CartDesignSummary[]
    - `id` string, required
    - `name` string, required
    - `formed_dimensions` V1Dimensions, required
      - `length_mm` number, required
      - `width_mm` number, required
      - `height_mm` number, required
    - `parts` V1CartPartSummary[], required
      - `id` string, required
      - `name` string, required
      - `suggested_process` 'sheet_metal' | 'tube_laser', required
      - `instance_count` integer
      - `formed_dimensions` V1Dimensions, required
        - `length_mm` number, required
        - `width_mm` number, required
        - `height_mm` number, required
      - `surface_area_cm2` number, nullable
      - `tube_length_mm` number, nullable
  - `manufacturing_warnings` V1ManufacturingReviewWarning[] — Advisories from automatic file preparation. These do not prevent ordering a ready quote.
    - `design_id` string, required
    - `code` 'bend_radius_review' | 'hole_correction_review' | 'manufacturing_file_review', required
    - `message` string, required
  - `order_id` string, nullable — Set once payment completes.
  - `payment` V1CartPayment
    - `object` 'cart_payment'
    - `cart_id` string, required
    - `status` 'paid' | 'processing' | 'failed' | 'refunded', required
    - `payment_intent_id` string, nullable
    - `amount_total_cents` integer, required
    - `order_id` string, nullable
    - `order_url` string, nullable — `/v1/orders/{order_id}` once the order exists.
    - `paid_at` string, date-time, nullable
  - `client_reference_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `expires_at` string, date-time, nullable

## Other responses

- `400` — Malformed request.
- `401` — Missing or invalid credentials.
- `403` — The credentials do not permit this operation.
- `404` — The resource does not exist or is not visible to the caller.
- `409` — The resource is not ready, or Idempotency-Key was reused with a different request.
- `422` — Validation failed; see `error.param` and `error.details`.
- `429` — Rate limit exceeded; retry after the `Retry-After` header.
- `500` — Unexpected failure; safe to retry with the same Idempotency-Key.
- `503` — A dependency is temporarily unavailable; retry later.

## Changes

- **2026-09-29** `4b9d1538aecf` — 2 info
  - the `dfm_ruleset_version` response's property default value changed from `2026-09-11-v7` to `2026-09-28-v8` for the status `201`
  - the `dfm_ruleset_version` response's property default value changed from `2026-09-11-v7` to `2026-09-28-v8` for the status `201`
- **2026-09-28** `3568b01e288d` — 1 info
  - added the optional property `quote/items/items/dfm/parts/items/bend_input_ready` to the response with the `201` status
- **2026-09-11** `5810b934dd3b` — 6 info
  - added the new optional request property `items/items/generate_production_files`
  - added the optional property `items/items/generate_production_files` to the response with the `201` status
  - added the optional property `quote/items/items/dfm/assembly_issues/items/customer_visible` to the response with the `201` status
  - added the optional property `quote/items/items/dfm/parts/items/issues/items/customer_visible` to the response with the `201` status
  - …2 more
- **2026-09-07** `8423a56e45c0` — 3 info
  - added the optional property `quote/items/items/pricing_token` to the response with the `201` status
  - added the optional property `quote/items/items/quantity_options/items/assembly_operations_amount_cents` to the response with the `201` status
  - added the optional property `quote/items/items/quantity_options/items/line_items` to the response with the `201` status
- …earlier changes not shown

[Full history](https://skmtc.dev/rmfg/apis/fastapi/changes/v1/carts/post.md)

---

[API](https://skmtc.dev/rmfg/apis/fastapi.md) · [All operations](https://skmtc.dev/rmfg/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/rmfg/apis/fastapi/revisions/737527fc081e?raw)