v1

latestOpenAPI 3.1.02026-07-26364986.4 KB

Medications

Update a medication

Update a medication by its ID

patch/api/2026-01-01/medical-record/medications/{medication_id}

Path parameters

medication_idstring uuid required

The ID of the medication

Request body

Response

The medication was updated

idstring uuid required

UUIDv7 identifier for the medication

patient_idstring uuid required

Reference to the patient

practitioner_idstring uuid required

Reference to the practitioner

encounter_idstring uuid nullable

Reference to the encounter where medication was prescribed (optional)

dose_formstring nullable

Pharmaceutical form (tablet, capsule, suspension, etc.) (optional)

routestring nullable

Route of administration (oral, IV, topical, etc.) (optional)

frequencystring nullable

Textual frequency (daily, bid, etc.) (optional)

quantityinteger nullable

Number of units (e.g., tablets, capsules) dispensed

period_startstring date nullable

When the medication course starts (optional)

period_endstring date nullable

Planned end date (if any) (optional)

instructionsstring nullable

Free-text administration instructions for the patient (optional)

status'active' | 'inactive' required

Lifecycle state of the medication

source'prescribed' | 'patient_reported' required

Origin of record – prescribed (from practitioner) or reported (self-reported)

change_reasonstring nullable

Selected reason for status change (e.g., adverse_reaction, completed, patient_request)

prescription_valid_untilstring date nullable

Expiry date after which repeats aren't valid (optional)

prescription_refillsinteger nullable

Allowed refill count (optional)

prescription_days_supplyinteger nullable

Number of days that the dispensed medication is intended to last (optional)

prescription_reasonstring nullable

Clinical indication or problem being treated (optional)

created_atstring date-time required

When the medication record was created