Skip To Main Content
All modules

Medications

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

MedicationmedicationHealth, off until allowed

A medication, supplement, or vitamin with dose and schedule.

medications_queryMedicationDashboardFindthrough vritto_find

List all non-archived medications plus recent dose logs. Use for schedule/refill questions and to resolve a medication ID before any write. Defaults to a compact summary: counts plus capped lean rows (name, strength, schedule, refills, runs-out, status; recent dose logs).

FieldTypeDescription
detailone of summary, fullResponse shape: "summary" (default, counts + capped lean medication/dose-log rows) or "full" (every record incl. dosage instructions, prescriber/pharmacy, and notes).
subjectPersonIdstringFilter to one person's medications: a People person id, or 'me' for the account owner's own. ALWAYS pass this when the question names a family member. Omit for everyone's.
medications_upsertMedicationCreate or Updatethrough vritto_create or vritto_update

Create or update one medication. Omit record.id to create (name required); include a real record.id from medications_queryMedicationDashboard to update, sent fields merge over the existing record. Pass record.rxcui from medications_searchDrugs to link reference data.

FieldTypeDescription
record*objectMedication fields; name is required when creating.
record.idstringExisting medication ID to update, from medications_queryMedicationDashboard. Omit to create a new medication.
record.rxcuistringRxNorm concept id from medications_searchDrugs. Pass it to link the medication to reference/label data.
record.namestringMedication name as the user refers to it. Required when creating.
record.genericNamestringGeneric/active-ingredient name.
record.brandNamestringBrand name, if any.
record.kindone of prescription, otc, supplementDefaults to 'prescription'.
record.statusone of active, as_needed, paused, discontinuedDefaults to 'active'.
record.formone of tablet, capsule, liquid, injection, topical, drops, inhaler, patch, spray, suppository, otherDose form.
record.routeone of oral, topical, injection, inhalation, nasal, ophthalmic, otic, rectal, sublingual, otherRoute of administration.
record.strengthstringStrength, e.g. '500 mg'.
record.dosageAmountstringAmount taken each time, e.g. '1 tablet', '2 puffs'.
record.dosageInstructionsstringExtra directions, e.g. 'Take with food'.
record.reasonstringCondition or purpose, e.g. 'Blood pressure'.
record.prescriberstringPrescribing clinician (free-text name).
record.prescriberProviderIdstringID of a saved Appointments provider to link as the prescriber, from appointments_queryAppointmentDashboard, never invented.
record.pharmacystringDispensing pharmacy (free-text name).
record.pharmacyPlaceKeystringPlace key ('google:<id>' or 'manual:<uuid>') of the pharmacy, from a Places tool result, never invented.
record.frequencyone of once_daily, twice_daily, three_times_daily, four_times_daily, every_morning, every_night, weekly, monthly, as_needed, customDefaults to 'once_daily'.
record.timeslist of stringClock times for daily doses.
record.daysOfWeeklist of integer0=Sunday … 6=Saturday; omit or empty means every day. REQUIRED when frequency is 'weekly', a weekly drug with no day is rejected, never defaulted to daily.
record.dayOfMonthintegerDay of the month a monthly medication is taken, clamped into short months. REQUIRED when frequency is 'monthly', a monthly drug with no day is rejected, never defaulted to daily.
record.withFoodbooleanWhether to take with food.
record.startedOnstringDate started.
record.endsOnstringPlanned end date, if any.
record.quantityPerFillintegerUnits per fill.
record.refillsRemainingintegerRefills left.
record.daysSupplyintegerDays a fill lasts, drives the runs-out estimate.
record.lastFilledOnstringDate of the most recent fill.
record.refillReminderDaysintegerDays before running out to remind (default 7).
record.notesstring
record.tagslist of string
record.favoriteboolean
record.subjectPersonIdstringWhose medication: a People person id (resolve with people_resolvePerson). Omit for the account owner's own.
record.providerRefobjectOptional reference-link details supplementing rxcui.
Example input
{
  "record": {
    "name": "Vitamin D3",
    "kind": "supplement",
    "strength": "2000 IU",
    "frequency": "every_morning",
    "times": [
      "08:00"
    ],
    "withFood": true
  }
}
medications_deleteMedicationDeletethrough vritto_delete

Delete (archive) one medication. Only for explicit removal requests, to stop a medication while keeping the record, use medications_upsertMedication with status 'discontinued'. Resolve the ID with medications_queryMedicationDashboard first.

FieldTypeDescription
medicationId*stringMedication ID from a prior medications_queryMedicationDashboard result, never invented.

Dose Logdose_logHealth, off until allowed

A dose taken, skipped, or missed.

medications_logDoseCreate or Updatethrough vritto_create or vritto_update

Record that a dose was taken, skipped, or missed for one medication, building the adherence history. Resolve the medicationId with medications_queryMedicationDashboard first. Include id to correct an existing dose log instead of creating a new one.

FieldTypeDescription
medicationId*stringMedication ID from a prior medications_queryMedicationDashboard result, never invented.
idstringExisting dose-log ID to update (from the dashboard's recent dose logs). Omit to create a new log entry.
statusone of taken, skipped, missedDefaults to 'taken'.
takenAtstringISO timestamp of the dose; defaults to now.
scheduledForstringISO timestamp of the schedule slot this dose belongs to (e.g. the 08:00 dose), so adherence attributes it correctly. Omit for unscheduled/as-needed doses.
notesstring
Example input
{
  "medicationId": "med_vitd",
  "status": "taken",
  "takenAt": "2026-09-26T13:05:00Z"
}
medications_deleteDoseLogDeletethrough vritto_delete

Delete one adherence-log entry. Only for explicit removals or corrections.

FieldTypeDescription
doseLogId*stringDose log id to delete.

Drug Referencedrug_catalogHealth, off until allowed

RxNorm and FDA drug reference data.

medications_getDrugInfoLook Upthrough vritto_lookup

Fetch reference/label information for a drug by rxcui: FDA label uses, dosage, warnings, and side effects, plus a MedlinePlus patient summary. Reference content only, not medical advice.

FieldTypeDescription
rxcui*stringRxNorm concept id from medications_searchDrugs.
medications_searchDrugsLook Upthrough vritto_lookup

Search the U.S. RxNorm drug vocabulary by name (typeahead). Returns candidate drugs with an rxcui to link a medication or fetch reference data. This is the catalog, not the user's saved medications: use medications_queryMedicationDashboard for those.

FieldTypeDescription
query*stringDrug name or partial name.
limitintegerMax results (default 12).