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

# Start reclassification

`POST /api/v1/reclassification/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/reclassification/run`
- Auth: HTTP bearer

Start a reclassification subprocess (reclassify mode only).

Requires confirm=true in request body as safety guard -- this operation
modifies production DuckDB files and sends notification emails.

HELENA-PLATFORM-RERUN-001 + HELIX-CR-2026-095-A.

## Request body

- RunReclassificationRequest
  - `target_version` string, required
  - `version_description` string, required
  - `scope` string, required
  - `organization_id` string, nullable
  - `user_ids` string[], nullable
  - `notify` boolean
  - `confirm` boolean

## Response `202`

Successful Response

- ReclassificationStatusResponse
  - `run_id` string, required
  - `status` string, required
  - `target_version` string, nullable
  - `progress_current` integer
  - `progress_total` integer
  - `elapsed_seconds` number
  - `log_lines` string[], nullable
  - `error` 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)