mtdna-curation

Update mtDNA curation evidence

Update mtDNA curation fields with partial-update semantics.

Mirrors override pattern (CR-HELENA-MUTABLE-STATE-001):

  • Writes only to PostgreSQL variant_annotations.
  • Read paths apply evaluator overlay to compute effective classification.

Atomic semantics (addendum B3 / Option B): audit emit happens BEFORE db.commit. If audit fails, the PostgreSQL transaction is rolled back and the client receives HTTP 500. The geneticist retries; no silent state corruption.

patch/sessions/{session_id}/variants/{variant_idx}/mtdna-curation

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/sessions/{session_id}/variants/{variant_idx}/mtdna-curation
  • Auth: HTTP bearer

Path parameters

session_idstring uuid required
variant_idxinteger required

Request body

pipeline_acmg_classstring required

Pipeline-original ACMG class read from variants list. Captured for audit before/after comparison.

pipeline_acmg_criteriastring required

Pipeline-original ACMG criteria string. Captured for audit.

Response

Successful Response

session_idstring uuid required
variant_idxinteger required
audit_event_idstring uuid nullable

Audit event UUID emitted on this write. None for GET responses (no audit emission on read paths).

validation_warningsstring[]

Non-blocking advisory warnings emitted during save. Curator may proceed regardless; warnings are logged in audit trail. HET-001: PP1 homoplasmy reminder fires when proband heteroplasmy >= 0.95 and homoplasmic_in_all=FALSE. GET, DELETE, and preview endpoints always return an empty list.

Changes

No recorded changes to this operation across all 1 revision of this API.