---
title: "Design Multi Chain Endpoint"
method: POST
path: "/api/rf-chain/design-multi"
tags: ["rf-chain", "rf-chain"]
---

# Design Multi Chain Endpoint

`POST /api/rf-chain/design-multi`

## Request

- Base URL: `https://api.pcbgenerator.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pcbgenerator.com/api/rf-chain/design-multi`
- Auth: none declared

Run multi-objective RF chain optimization.

1. Runs the existing single-chain orchestrator to get a primary chain.
2. Generates variant chains by swapping components from alternatives.
3. Scores all chains on cost, size, and performance.
4. Returns ranked chains with Pareto frontier.

## Request body

- MultiChainDesignRequest: Request body for POST /api/rf-chain/design-multi.
  - `params` object, required
  - `filtering_reqs` object
  - `agent_config` object
  - `weights` ObjectiveWeights: Weights for cost / size / performance objectives. Must sum to 1.0.
    - `cost` number
    - `size` number
    - `performance` number
  - `max_chains` integer
  - `use_ai_advisor` boolean

## Response `200`

Successful Response

- MultiChainDesignResponse: Response from multi-chain optimization endpoint.
  - `status` 'success' | 'error'
  - `primary_chain` object, nullable
  - `scored_chains` ScoredChain[]
    - `chain` object, required
    - `scores` ChainScores, required: Individual objective scores (0-1, higher is better).
      - `cost` number
      - `size` number
      - `performance` number
      - `composite` number
    - `label` 'Primary (Best RF Match)' | 'Best Performance' | 'Lowest Cost' | 'Most Compact' | 'Balanced' | 'Pareto Optimal'
    - `is_primary` boolean
    - `is_pareto` boolean
    - `swap_description` string
    - `bom` object, nullable
    - `power_flow` object[], nullable
    - `total_cost_usd` number
    - `total_area_mm2` number, nullable
    - `actual_output_power` number, nullable
    - `output_delta` number, nullable
  - `pareto_frontier` integer[]
  - `recommended_weights` ObjectiveWeights: Weights for cost / size / performance objectives. Must sum to 1.0.
    - `cost` number
    - `size` number
    - `performance` number
  - `weight_reasoning` string, nullable
  - `design_time_ms` number
  - `iterations` integer
  - `warnings` string[]
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pcbgenerator/apis/pcb-stackup-generator-api.md) · [All operations](https://skmtc.dev/pcbgenerator/apis/pcb-stackup-generator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pcbgenerator/apis/pcb-stackup-generator-api/revisions/b6084b3ace32?raw)