Skip to main content
PATCH
/
notes
/
{noteId}
Edit SOAP note fields
curl --request PATCH \
  --url https://api.maxcare.ai/v1/notes/{noteId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-Id: <x-organization-id>' \
  --data '
{
  "additionalHpiComments": "Patient reports improvement since last visit.",
  "impressionsPlansComments": "Continue current treatment plan for 3 months.",
  "otherExamComments": "No new lesions noted on re-examination.",
  "stickyNoteDescription": "Patient prefers morning appointments."
}
'
{
  "code": "success",
  "data": {
    "id": "3cc73cb6-9c59-403c-a910-8af6c5693b25",
    "version": 3,
    "visitDate": "2026-03-20 18:30:00+00",
    "status": "awaiting_sign",
    "aiStatus": "issues_found",
    "aiIssueCount": 2,
    "patient": {
      "id": "8de03039-3a9e-417a-b2b3-a8b8df183631",
      "mrn": "MRN-10042",
      "firstName": "Sarah",
      "lastName": "Johnson",
      "middleName": "Marie",
      "gender": "Female",
      "dateOfBirth": "1985-03-15",
      "email": "sarah.johnson@email.com",
      "phone": "(555) 123-4567",
      "avatar": "https://s3.amazonaws.com/bucket/patients-avatars/org/avatar.jpg?X-Amz-...",
      "createdAt": "2024-08-15T09:30:00.000Z",
      "updatedAt": "2025-01-20T14:22:00.000Z"
    },
    "facility": {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "name": "West LA Dermatology",
      "timezone": "America/Los_Angeles",
      "specialty": "Dermatology",
      "isVisible": true,
      "organizationNpi": "1234567890",
      "createdAt": "2024-05-01T10:00:00.000Z",
      "updatedAt": "2025-01-15T12:30:00.000Z"
    },
    "ehrType": "modmed",
    "assignedProviders": [
      {
        "id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
        "firstName": "James",
        "lastName": "Wilson",
        "displayFirstName": "Dr. James",
        "displayLastName": "Wilson, MD",
        "username": "jwilson",
        "roles": [
          "Physician"
        ],
        "individualNpi": "1234567890",
        "canFinalize": true,
        "canCosign": false,
        "hidden": false,
        "roleType": "PRIMARY_PROVIDER"
      }
    ],
    "createdAt": "2026-03-20 18:35:10.209452+00",
    "updatedAt": "2026-03-23 03:15:47.285+00",
    "soapNote": {}
  }
}

Authorizations

​
Authorization
string
header
required

Marketplace API key

Headers

​
X-Organization-Id
string
required

Target clinic organization ID

Path Parameters

​
noteId
string
required

Note ID (stable root ID or any version ID)

Query Parameters

​
providerId
string
required

Body

application/json
​
additionalHpiComments
string

Additional HPI comments text (use empty string to clear)

Example:

"Patient reports improvement since last visit."

​
impressionsPlansComments
string

Impressions & Plans additional comments text (use empty string to clear)

Example:

"Continue current treatment plan for 3 months."

​
otherExamComments
string

Other physical exam comments text (use empty string to clear)

Example:

"No new lesions noted on re-examination."

​
stickyNoteDescription
string

Patient sticky note description (patient-level, not note-level; use empty string to clear)

Example:

"Patient prefers morning appointments."

Response

Success

​
code
string
required

Response code

Example:

"success"

​
data
object
required