---
title: "PUT /api/patient/{patientId}"
method: PUT
path: "/api/patient/{patientId}"
---

# PUT /api/patient/{patientId}

`PUT /api/patient/{patientId}`

## Request

- Base URL: `https://forecaster.cairhealth.com`
- URL: `https://forecaster.cairhealth.com/api/patient/{patientId}`
- Auth: HTTP bearer

Updates a patient's demographic fields, preserving all other data on the resource (identifiers, contacts, links, etc.). Insurance/policy data is not accepted.

## Path parameters

- `patientId` string, required

## Request body

- PatientCrudRequest: Patient demographics. `id` is the external patient id, keyed by the Cair customer-patient-id naming system (https://fhir.cairhealth.com/fhir/identifier/customer-patient-id)
  - `id` string, required: External patient id
  - `first_name` string, required: Patient's first name
  - `last_name` string, required: Patient's last name
  - `name` string, nullable: Patient's full name
  - `gender` 'male' | 'female' | 'other' | 'unknown', nullable: Patient gender
  - `dob` string, nullable: Date of birth, yyyy-MM-dd
  - `email` string, nullable: Patient email address
  - `phone_number` string, nullable: Patient phone number
  - `address` object: Patient address
    - `city` string, nullable: City
    - `country` string, nullable: Country
    - `line1` string, nullable: Address line 1
    - `line2` string, nullable: Address line 2
    - `state` string, nullable: State
    - `zip` string, nullable: Postal code
  - `preferredContactMethod` string[], nullable: Preferred contact methods. Each value is one of text, email, or call. On update, an empty array clears the preference; omitting the field leaves it unchanged.

## Response `200`

Patient updated successfully

- PatientCrudResponse
  - `success` boolean
  - `message` string
  - `data` object
    - `patientId` string: External patient id
    - `patientFhirId` string: FHIR id of the Patient resource

## Other responses

- `400`: Invalid request body or validation error
- `401`: Unauthorized access or invalid organization ID
- `404`: Organization or patient not found
- `500`: Server error

## Changes

- **2026-11-03** `b32380ccde9a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cairhealth/apis/cair-health-apis/changes/api/patient/:patientId/put.md)

---

[API](https://skmtc.dev/cairhealth/apis/cair-health-apis.md) - [All operations](https://skmtc.dev/cairhealth/apis/cair-health-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/cairhealth/apis/cair-health-apis/revisions/b32380ccde9a?raw)