---
title: "Start CR simulation"
method: POST
path: "/api/v1/simulation/run"
tags: ["simulation"]
---

# Start CR simulation

`POST /api/v1/simulation/run`

## Request

- Base URL: `https://api.helena.bio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helena.bio/api/v1/simulation/run`
- Auth: HTTP bearer

Start a CR simulation subprocess.

Resolves session IDs via session-orchestration, writes them to a temp file,
launches simulate_cr_template.py as subprocess. One simulation at a time.

HELENA-PLATFORM-SIM-001

## Request body

- RunSimulationRequest
  - `cr_id` string, required
  - `scope` string, required
  - `organization_id` string, nullable
  - `user_ids` string[], nullable

## Response `202`

Successful Response

- SimulationStatusResponse
  - `run_id` string, required
  - `status` string, required
  - `cr_id` string, nullable
  - `progress_current` integer
  - `progress_total` integer
  - `elapsed_seconds` number
  - `result` object, nullable
  - `error` string, nullable
  - `log_lines` string[], nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service.md) · [All operations](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/llms.txt) · [OpenAPI document](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/revisions/fe51fd20cdf1?raw)