---
title: "Simulate Fermentation"
method: POST
path: "/api/simulate-fermentation"
---

# Simulate Fermentation

`POST /api/simulate-fermentation`

## Request

- Base URL: `https://biotechdsp-579272663320.europe-west1.run.app`
- URL: `https://biotechdsp-579272663320.europe-west1.run.app/api/simulate-fermentation`
- Auth: HTTP bearer

Run only the fermentation and return the broth it produces.

Route generation treats the bioreactor as a fixed first step and searches
downstream of whatever it makes, so the broth is the real input to the search
- every candidate route, every yield and every cost is conditioned on it. It
used to be computed invisibly inside the search, which meant an oxygen-limited
design producing a third of the requested titer generated a purification train
for a broth the user had never seen and would not have accepted.

This endpoint exists so that broth can be put in front of the user and agreed
before the search spends a minute on it.

## Request body

- FermentationPreflightBody: The bioreactor alone, before any downstream train exists.
  - `bioreactor_id` string, required
  - `bioreactor_params` object
  - `product_identity_requested_targets` string[]
  - `product_identity_warnings` string[]
  - `stream` object, required
  - `stream_closure_warnings` string[]
  - `target_products` string[]
  - `target_provenance` object, nullable
  - `terminal_streams` TerminalStream[], nullable
    - `fraction` number, required
    - `output_index` integer, required
    - `port_id` string, required
    - `sink` 'product' | 'waste' | 'vent', required
    - `step_index` integer, required
    - `target_products` string[]
    - `terminal_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/untangle/apis/untangle-bio-engine-api.md) · [All operations](https://skmtc.dev/untangle/apis/untangle-bio-engine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/untangle/apis/untangle-bio-engine-api/revisions/161714bf261c?raw)
