Sign in
Patients

Update a patient

Partially updates an existing patient. Only the fields present in the request body are modified; omitted fields are left untouched. The clinic is determined by the provided API key and must own the patient.

For the array fields (diagnoses, medications, allergies, insurances, relatedContacts), each entry may include an optional id:

  • When id matches an existing entry, that entry is updated (shallow-merged).
  • When id is omitted, a new entry is appended.
patch/patients/{patientId}

Path parameters

patientIdstring required

The unique identifier of the patient to update.

Request body

firstNamestring
lastNamestring
middleNamestring
gender'Male' | 'Female' | 'Non-binary' | 'Prefer not to say' | 'Other' | 'Unknown'
genderIdentitystring
pronoun'he/him' | 'she/her' | 'they/them'
dateOfBirthstring

Date of birth in MM/DD/YYYY format

raceEthnicity'White' | 'Black or African American' | 'Asian' | 'Hispanic or Latino' | 'American Indian or Alaska Native' | 'Native Hawaiian or Other Pacific Islander' | 'Other' | 'Prefer not to say'
emailstring email
phoneNumberstring

Example request

{
  "firstName": "Alice",
  "lastName": "Johnson",
  "middleName": "Marie",
  "gender": "Female",
  "genderIdentity": "Non-binary",
  "pronoun": "they/them",
  "dateOfBirth": "06/28/1996",
  "email": "patient@test.com",
  "phoneNumber": "+12025551234",
  "address": {
    "address1": "123 Main St",
    "address2": "Apt 4B",
    "city": "New York",
    "state": "NY",
    "zip": "10001"
  },
  "diagnoses": [
    {
      "id": "1718000000000",
      "code": "F32.1",
      "description": "Major depressive disorder, single episode, moderate"
    }
  ],
  "relatedContacts": [
    {
      "fullName": "Jane Doe",
      "email": "jane@example.com",
      "phones": [
        "+12025551234"
      ],
      "relationship": "Spouse",
      "hipaaConsent": true
    }
  ],
  "insurances": [
    {
      "tradingPartnerName": "Blue Cross Blue Shield",
      "memberId": "XYZ123456789",
      "groupNumber": "GRP001",
      "company": "Anthem",
      "isPrimary": true
    }
  ],
  "medications": [
    {
      "name": "sildenafil 25 MG Oral Tablet [Viagra]",
      "brandName": "Viagra",
      "genericName": "sildenafil",
      "strength": "25 MG",
      "route": "by mouth",
      "form": "Oral Tablet",
      "reason": "Depression",
      "comment": "Take with food",
      "currentMedication": true,
      "date": "2026-01-15",
      "stopDate": "2026-06-01",
      "dosage": {
        "dose": "2",
        "doseUnit": "tablet",
        "doseTiming": "twice a day",
        "duration": "30",
        "quantity": "60",
        "refills": "3"
      }
    }
  ],
  "allergies": [
    {
      "name": "glutamic acid",
      "reactions": [
        "asthma",
        "rash"
      ],
      "severity": "Severe",
      "notes": "Causes severe respiratory distress"
    }
  ]
}

Response

Patient updated successfully

patientIdstring

Example response

{
  "patientId": "abc123"
}

Changes