Upload Lab Results

Prerequisites

• Authenticated CLI
• A lab result PDF on disk

Step 1 — upload

betterness lab-results upload --file ./my-results.pdf

Accepted formats: PDF, PNG, JPG. Max size: 50 MB. The file is processed automatically — biomarkers are extracted and the result enters PENDING → PROCESSING → PROCESSED status.

Step 2 — wait for processing

betterness lab-records list

Look for status PROCESSED. Processing usually takes seconds to minutes.

Step 3 — review extracted values

betterness lab-records detail --record-id abc123

Shows patient info, test details, and the full biomarker array with names, values, units, and ranges.

Step 4 — correct any errors

# Fix a value
betterness lab-results update-biomarker --biomarker-id bio_xyz --result 5.2 --unit "mg/dL"

# Delete an incorrect entry
betterness lab-results update-biomarker --biomarker-id bio_wrong --action DELETE

# Fix patient or lab metadata
betterness lab-results update-metadata \
  --result-id abc123 \
  --patient-name "Jane Doe" \
  --lab-name "Quest Diagnostics" \
  --fasting

Step 5 — approve

betterness lab-results update-status --result-id abc123 --action APPROVE

Approval makes the biomarkers visible in biomarkers search and triggers biological age recalculation.

If extraction was wrong

betterness lab-results update-status --result-id abc123 --action REPROCESS

Re-runs PDF extraction. Status returns to PENDING then advances again.

Roll back an approval

betterness lab-results update-status --result-id abc123 --action ROLLBACK

Reverts APPROVED → PROCESSED. Hides the biomarkers from searches until re-approved.

Status lifecycle

Status	What it means
PENDING	Queued for processing
PROCESSING	PDF being extracted
PROCESSED	Extraction complete — review and approve
APPROVED	Biomarkers visible everywhere