---
title: "Create Assembly Quote"
method: POST
path: "/quotes/assembly"
tags: ["quotes"]
---

# Create Assembly Quote

`POST /quotes/assembly`

Generate a quote for caller-owned designs in an assembly.

The request contains a list of design-level quote requests. For each design we
calculate the unit price using the existing quoting logic and then aggregate
all unit prices to return a single assembly-level quote. Authenticate with
`rmfg_key`, both Supabase session headers, or the anonymous website session
token that owns every requested design.

## Request body

- AssemblyQuoteRequest — Request model for quoting an entire assembly. Attributes ---------- assembly_id: Optional[str] Identifier for the assembly (if already persisted). This is optional because an assembly may not be stored yet – the caller can still supply a list of individual design quote requests. design_quotes: List[QuoteRequest] A list of quote requests, one for each design that belongs to the assembly. welds: Optional[List[Weld]] = None # Assembly-level weld information
  - `assembly_id` string, nullable
  - `design_quotes` QuoteRequest[], required
    - `design_id` string, required
    - `material_id` string, nullable
    - `tube_profile_id` string, nullable
    - `pooled_tube_material_cents` number
    - `taps` Tap[], nullable
      - `hole_id` integer, required
      - `size` string, required
    - `studs` Stud[], nullable
      - `hole_id` integer, required
      - `size` string, required
      - `cost` integer, required
    - `nuts` Nut[], nullable
      - `hole_id` integer, required
      - `size` string, required
      - `cost` integer, required
    - `countersinks` Countersink[], nullable
      - `hole_id` integer, required
      - `outer_diameter` number, required
      - `outer_diameter_unit` 'mm' | 'inches', required
      - `angle` 82 | 90, required
      - `side` 'top' | 'bottom', required
    - `powder_coat` string, nullable
    - `finish_type` string, nullable
  - `welds` Weld[], nullable
    - `type` string, required
    - `length` number, required
    - `part_ids` string[], nullable
    - `finish` 'none' | 'rough' | 'fine'
    - `joint_access` 'open' | 'tight' | 'blind'
  - `assembly_bounding_dimensions` number[], nullable
  - `assembly_quantity` integer
  - `design_quantities` DesignQuantity[], nullable
    - `design_id` string, required
    - `quantity` integer, required
  - `requested_quantity_range` RequestedQuantityRange — Inclusive range of assembly quantities to precompute.
    - `min_quantity` integer, required
    - `max_quantity` integer, required
  - `requested_quantities` integer[], nullable

## Response `200`

Successful Response

- AssemblyQuoteWithCalculationResponse — Assembly quote response with optional calculated pricing rows.
  - `assembly_id` string, nullable
  - `quotes` QuoteResponse[], required
    - `unit_price` integer, required
    - `secondary_operations` SecondaryOperation[], required
      - `name` string, required
      - `pricing` union, required
        - BendPricing
          - `price_per_bend` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
          - `num_bends` integer, required
        - TapPricing
          - `price_per_tap` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
          - `num_taps` integer, required
          - `base_price` integer, required
        - StudPricing
          - `price_per_stud` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
          - `num_studs` integer, required
          - `base_price` integer, required
        - NutPricing
          - `price_per_nut` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
          - `num_nuts` integer, required
          - `base_price` integer, required
        - CountersinkPricing
          - `price_per_countersink` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
          - `num_countersinks` integer, required
          - `base_price` integer, required
        - PowderCoatPricing
          - `color` string, required
          - `base_price` integer, required
          - `price_per_cm2` number, required
          - `surface_area_cm2` number, required
          - `price_tiers` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
        - MechanicalFinishPricing
          - `finish_type` string, required
          - `base_price` integer, required
          - `price_per_cm2` number, required
          - `surface_area_cm2` number, required
          - `price_tiers` UnitPricing[], required
            - `quantity` integer, required
            - `price` integer, required
    - `discounts` Discount[], required
      - `quantity` integer, required
      - `discount_percent` number, required
    - `material` MaterialTable
      - `id` string, required
      - `material` 'Steel' | 'Aluminum' | 'Stainless Steel', required
      - `type` string, required
      - `thickness_in` number, nullable
      - `thickness_mm` number, nullable
      - `weight_cm2` number, nullable
      - `display_thickness` string, nullable
      - `bendable` boolean, nullable
      - `ultimate_tensile_strength_psi` integer, nullable
      - `yield_tensile_strength_psi` integer, nullable
    - `tube_profile` TubeProfileTable
      - `id` string, required
      - `material` 'Steel' | 'Aluminum' | 'Stainless Steel', required
      - `type` string, required
      - `shape` string, required
      - `display_name` string, required
      - `outer_width_mm` number, nullable
      - `outer_height_mm` number, nullable
      - `outer_diameter_mm` number, nullable
      - `inner_diameter_mm` number, nullable
      - `wall_thickness_mm` number, nullable
      - `outer_corner_radius_mm` number, nullable
      - `inner_corner_radius_mm` number, nullable
      - `weight_kg_per_m` number, nullable
      - `default_stock_length_mm` number, nullable
      - `active` boolean
    - `tube_pricing` TubePricingBreakdown — Cost/margin snapshot behind a tube quote, for audit and calibration. Persisting this with the quote is what lets predicted material/machine numbers be compared against factory actuals later.
      - `pricing_model` string, required
      - `material_cents` number, required
      - `machine_cents` number, required
      - `handling_cents` number, required
      - `unit_cost_cents` number, required
      - `machine_time_s` number, required
      - `length_mm` number, required
      - `stock_cost_per_mm_cents` number, required
      - `utilization_factor` number, required
      - `margin_at_unit_price` number, required
      - `pooled_material_cents` number, required
    - `manufacturability` QuoteManufacturability — Complete manufacturability result for one quoted configuration.
      - `is_manufacturable` boolean, required
      - `issues` QuoteManufacturabilityIssue[]
        - `code` string, required
        - `message` string, required
        - `source` 'planner' | 'reason_api', required
        - `blocking` boolean
        - `design_id` string, required
        - `bend_id` integer, nullable
        - `hole_id` integer, nullable
        - `material` string, nullable
        - `material_type` string, nullable
        - `actual_length_mm` number, nullable
        - `min_length_mm` number, nullable
        - `max_length_mm` number, nullable
        - `actual_angle_degrees` number, nullable
        - `max_angle_degrees` number, nullable
        - `required_tonnage` number, nullable
        - `max_tonnage` number, nullable
        - `thickness_mm` number, nullable
        - `designed_thickness_mm` number, nullable
        - `designed_bend_radius_mm` number, nullable
        - `tooling_bend_radius_mm` number, nullable
        - `die_id` string, nullable
        - `die_name` string, nullable
        - `die_v_width_mm` number, nullable
        - `die_selection` 'preferred_calibration' | 'best_guess_8x_thickness', nullable
        - `ultimate_tensile_strength_psi` number, nullable
        - `distance_mm` number, nullable
        - `min_distance_mm` number, nullable
    - `design` QuoteDesign, required — Customer-safe design metadata embedded in quote responses. Pricing needs the analyzed geometry, but callers do not need database ownership fields, anonymous bearer tokens, or internal storage paths. A serialized quote can therefore be sent back to `/quotes/calculate` without carrying any of those secrets.
      - `id` string, required
      - `file_name` string, required
      - `part_type` 'sheet' | 'tube'
      - `part_name` string, nullable
      - `file_size` integer, required
      - `bends` Bend[], required
        - `id` integer, required
        - `angle` number, required
        - `radius` number, required
        - `location` BentLocation, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `direction` BentLocation, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `length` number, required
        - `line_start` BentLocation
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `line_end` BentLocation
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `distortion_zone_sides` BendDistortionZoneSide[]
          - `source_hole_id` integer, nullable
          - `edge_start` BentLocation, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `edge_end` BentLocation, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `outward_direction` BentLocation, required
            - `x` number, required
            - `y` number, required
            - `z` number, required
      - `thickness` number, required
      - `surface_area_cm2` number, required
      - `bounding_dimensions` number[], required
      - `flat_bounding_dimensions_mm` number[], required
      - `manufacturability` 'manufacturable' | 'not_within_shippable_dimensions' | 'not_within_manufacturable_dimensions', required
      - `manufacturability_details` string[], nullable, required
      - `cut_length_mm` number, nullable
      - `hole_count` integer, nullable
      - `flat_pattern_number_of_interior_boundaries` integer, required
      - `original_holes` Hole[], nullable
        - `id` integer, required
        - `area_mm2` number, required
        - `center` Point3D, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `diameter_mm` number, required
        - `perimeter_mm` number, required
        - `hole_center_dist_to_nearest_edge` number, required
        - `normal` Normal, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `nearest_bend` NearestBend
          - `bend_id` integer, nullable
          - `distance_to_flange` number, nullable
          - `is_inner_cylindrical_face` boolean, nullable
          - `outside_bend_path` boolean, nullable
          - `line_start` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `line_end` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `distortion_zone_side` BendDistortionZoneSide — Planner geometry for one sheet side adjacent to a bend line.
            - `source_hole_id` integer, nullable
            - `edge_start` BentLocation, required
              - …
            - `edge_end` BentLocation, required
              - …
            - `outward_direction` BentLocation, required
              - …
        - `nearby_bends` NearestBend[]
          - `bend_id` integer, nullable
          - `distance_to_flange` number, nullable
          - `is_inner_cylindrical_face` boolean, nullable
          - `outside_bend_path` boolean, nullable
          - `line_start` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `line_end` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `distortion_zone_side` BendDistortionZoneSide — Planner geometry for one sheet side adjacent to a bend line.
            - `source_hole_id` integer, nullable
            - `edge_start` BentLocation, required
              - …
            - `edge_end` BentLocation, required
              - …
            - `outward_direction` BentLocation, required
              - …
        - `outline` Point3D[], nullable
          - `x` number, required
          - `y` number, required
          - `z` number, required
      - `flange_lengths` union[], required
        - union
          - FlangeLength
            - `flange_length` number, required
            - `flange_bend_radius` number, required
            - `flange_bend_angle` number, required
          - number
      - `backgauge_flanges` object[], required
      - `u_channels` object[]
      - `transformed_holes` Hole[], nullable
        - `id` integer, required
        - `area_mm2` number, required
        - `center` Point3D, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `diameter_mm` number, required
        - `perimeter_mm` number, required
        - `hole_center_dist_to_nearest_edge` number, required
        - `normal` Normal, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `nearest_bend` NearestBend
          - `bend_id` integer, nullable
          - `distance_to_flange` number, nullable
          - `is_inner_cylindrical_face` boolean, nullable
          - `outside_bend_path` boolean, nullable
          - `line_start` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `line_end` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `distortion_zone_side` BendDistortionZoneSide — Planner geometry for one sheet side adjacent to a bend line.
            - `source_hole_id` integer, nullable
            - `edge_start` BentLocation, required
              - …
            - `edge_end` BentLocation, required
              - …
            - `outward_direction` BentLocation, required
              - …
        - `nearby_bends` NearestBend[]
          - `bend_id` integer, nullable
          - `distance_to_flange` number, nullable
          - `is_inner_cylindrical_face` boolean, nullable
          - `outside_bend_path` boolean, nullable
          - `line_start` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `line_end` Point3D
            - `x` number, required
            - `y` number, required
            - `z` number, required
          - `distortion_zone_side` BendDistortionZoneSide — Planner geometry for one sheet side adjacent to a bend line.
            - `source_hole_id` integer, nullable
            - `edge_start` BentLocation, required
              - …
            - `edge_end` BentLocation, required
              - …
            - `outward_direction` BentLocation, required
              - …
        - `outline` Point3D[], nullable
          - `x` number, required
          - `y` number, required
          - `z` number, required
      - `countersinks` AnalyzedCountersink[], nullable
        - `id` integer, required
        - `center` Point3D, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `normal` Normal, required
          - `x` number, required
          - `y` number, required
          - `z` number, required
        - `inverted` boolean, required
        - `counters_sink_inner_radius` number, required
        - `counters_sink_outer_radius` number, required
        - `counter_sink_angle` number, required
      - `design_tree` object, nullable
      - `detected_tube_profile_key` string, nullable
      - `tube_profile_id` string, nullable
      - `tube_length_mm` number, nullable
      - `tube_features` object[]
      - `tube_holes` object[]
      - `tube_metadata` object
      - `public` boolean, required
      - `issues` Issue[], required
        - `bend_id` integer, required
        - `issue` string, required
      - `assembly_id` string, nullable
  - `weld_cost_cents` integer, nullable
  - `welds` Weld[], nullable
    - `type` string, required
    - `length` number, required
    - `part_ids` string[], nullable
    - `finish` 'none' | 'rough' | 'fine'
    - `joint_access` 'open' | 'tight' | 'blind'
  - `weld_discounts` Discount[], nullable
    - `quantity` integer, required
    - `discount_percent` number, required
  - `weld_pricing` WeldPricingBreakdown — Full parametric weld pricing for an assembly quote. `weld_unit_cost_cents` (seams + finishing for ONE assembly) scales with quantity via the qty run-rate discounts; the setup and fixturing fees are charged once per order and never discounted.
    - `welds` WeldLineItem[], required
      - `length_cm` number, required
      - `process` string, required
      - `material_family` string, required
      - `rate_per_inch_cents` integer, required
      - `thickness_multiplier` number, required
      - `access_multiplier` number, required
      - `weld_cost_cents` integer, required
      - `finish` string, required
      - `finish_cost_cents` integer, required
    - `weld_unit_cost_cents` integer, required
    - `setup_fee_cents` integer, required
    - `fixturing_piece_fee_cents` integer, required
    - `fixturing_size_fee_cents` integer, required
    - `one_time_fees_cents` integer, required
    - `part_sqft` number, required
    - `piece_count` integer, required
  - `calculated_quote` CalculatedAssemblyQuoteResponse — Calculated quote response with optional precomputed quantity rows.
    - `assembly` AssemblyTotals, required — Aggregate totals for the entire assembly.
      - `partCostTotal` integer, required
      - `weldCostTotal` integer, required
      - `totalAmountAfterDiscount` integer, required
      - `effectiveUnitCost` integer, required
    - `designs` CalculatedQuote[], required
      - `originalUnitAmount` integer, required
      - `discountAmount` integer, required
      - `discountPercent` number, required
      - `priceAfterDiscount` integer, required
      - `totalAmountBeforeSecondaryOperations` integer, required
      - `totalBendCost` integer, required
      - `totalTapCost` integer, required
      - `totalStudCost` integer, required
      - `totalNutCost` integer, required
      - `totalCountersinkCost` integer, required
      - `totalPowderCoatCost` integer, required
      - `totalFinishCost` integer
      - `totalAmount` integer, required
      - `effectiveUnitCost` integer, required
      - `designId` string, required
      - `pricingVersion` string, nullable
      - `pricingMetadata` PricingMetadata — Version metadata for the pricing logic that generated a quote.
        - `pricingVersion` string, required
        - `calculator` string, required
        - `components` object, required
        - `configHash` string, required
        - `snapshot` object
    - `pricingVersion` string, nullable
    - `pricingMetadata` PricingMetadata — Version metadata for the pricing logic that generated a quote.
      - `pricingVersion` string, required
      - `calculator` string, required
      - `components` object, required
      - `configHash` string, required
      - `snapshot` object
    - `quantityQuotes` object, nullable

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/rmfg/apis/fastapi.md) · [All operations](https://skmtc.dev/rmfg/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rmfg/fastapi/revisions/17a4ad42a016/schema)