Betterness
How it worksBett-iTutorialsAboutFor businesses ↗, opens Betterness One in a new tabLog inSign up
How it worksBett-iTutorialsAboutFor businesses: Betterness One ↗, opens Betterness One in a new tab
Log inSign up
Skip to content

Overview

  • What is Betterness

Connect

  • Connect by signing in
  • Claude custom connector
  • ChatGPT custom MCP server
  • Permissions
  • Connected apps
  • Privacy and data

Trust

  • Trust Center
  • Audit Trail
  • Limits & Scopes

Resources

  • Troubleshooting
  • Glossary

Server

Get started

  • Connect with an API Key
  • Authentication
  • First Tool Call

Clients

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • ChatGPT
  • OpenClaw / BetterClaw

Recipes

  • Health Overview
  • Order Labs
  • Upload Lab Results
  • Biomarker Gap Analysis
  • Connect Wearables
  • Health Profile

Tools

  • All Tools
  • Profile
  • Wearables
  • Health Data
  • Nutrition
  • Logging
  • Biomarkers
  • Documents
  • Lab Tests
  • Lab Records
  • Lab Orders
  • Lab Results
  • Purchases
  • Confirming Actions
  • Inbox
  • Training Program
  • Updates
  • Health Profile
Docs/Betterness/Tools/Lab Results

Lab Result Tools

Upload PDFs, correct extracted values, approve.


getLabResultFileUploadEndpoint

Preferred method. Returns the multipart upload URL plus full instructions, including a ready-to-use cURL example. Use the same bk_* API key as the MCP connection.

Parameters: none

Returns: JSON with uploadUrl, method, contentType, fileField, acceptedTypes, maxSizeMB, authentication, curlExample, message.

getLabResultUploadLink

Fallback when the agent cannot make HTTP requests. Returns a platform link the user opens to upload PDFs manually (drag-and-drop or browse).

Returns: JSON with uploadUrl and message.

updateLabResultBiomarker

Updates or deletes one biomarker in an uploaded lab result. Only works on PROCESSED (not yet APPROVED) results. Use getLabRecordDetail first to get biomarker IDs.

ParameterRequiredNotes
biomarkerExternalIdyesFrom the biomarkers array of the record detail
actionnoSet to DELETE to remove. Omit to update.
namenoUpdated name
resultno"5.2", "120", etc.
unitno"mg/dL", "ng/mL", etc.
minRangeValuenoLower bound
maxRangeValuenoUpper bound

updateLabResultMetadata

Updates patient or test metadata. Only works on PROCESSED results.

ParameterRequired
labResultExternalIdyes
patientNameno
patientSexno — MALE or FEMALE
dobno
labNameno
orderingPhysicianno
dateCollectedno — ISO-8601
fastingno — "true" or "false"

updateLabResultStatus

Transitions a result through approval states.

ActionEffect
APPROVEPROCESSED → APPROVED. Biomarkers visible in searchBiomarkers; biological age recalculates.
ROLLBACKAPPROVED → PROCESSED. Hides biomarkers, removes biological age contribution.
REPROCESSRe-runs PDF extraction. Resets to PENDING.

Always show extracted values to the user and get explicit approval before APPROVE.

PreviousLab OrdersNextPurchases
Betterness

Product

  • How it works
  • Bett-i
  • Connect your AI

Resources

  • Tutorials
  • Podcast

Company

  • About
  • News
  • Contact

Legal

  • Privacy
  • Terms
  • Health data
  • Delete your account

For businesses

  • Betterness One ↗, opens Betterness One in a new tab

News from Betterness: the Friday Letter, launches and stories, by email.

  • Instagram ↗, opens in a new tab
  • X ↗, opens in a new tab
  • YouTube ↗, opens in a new tab
  • LinkedIn ↗, opens in a new tab
Download on the App StoreGet it on Google Play
HIPAA, powered by Vanta

HIPAA compliance monitored by Vanta.

Betterness, Inc. · Betterness gives health information, not medical advice.