Skip to main content
PATCH
/
appointments
/
{appointmentId}
Update an appointment
curl --request PATCH \
  --url https://api.healos.ai/ext-api/v1/appointments/{appointmentId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "patient_id": "1743552000000",
  "appointment_type": "Follow-up",
  "visit_type": "In-Person",
  "start_at": "2026-04-15T14:00:00.000Z",
  "duration_minutes": 50,
  "notes": "Updated notes",
  "status": "COMPLETED"
}
'
{
  "data": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "patient_id": "1743552000000",
    "patient_name": "Maria Santos",
    "appointment_type": "Initial Evaluation",
    "visit_type": "Telehealth",
    "start_at": "2026-04-15T14:00:00.000Z",
    "duration_minutes": 50,
    "notes": "New patient intake. Please complete forms beforehand.",
    "status": "SCHEDULED",
    "created_at": "2026-04-01T10:00:00.000Z",
    "updated_at": "2026-04-01T10:00:00.000Z",
    "repeat_rule": {
      "frequency": "WEEKLY",
      "interval": 1,
      "end_date": "2026-07-15"
    },
    "external_id": "PARTNER-APPT-789"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.healos.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key obtained from /api/v1/ext-api-keys

Path Parameters

​
appointmentId
string
required

Appointment UUID

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Body

application/json
​
patient_id
string

Patient ID

Example:

"1743552000000"

​
appointment_type
string
Example:

"Follow-up"

​
visit_type
enum<string>
Available options:
Telehealth,
In-Person,
Both,
Other
Example:

"In-Person"

​
start_at
string

ISO 8601 datetime

Example:

"2026-04-15T14:00:00.000Z"

​
duration_minutes
number
Required range: x >= 1
Example:

50

​
notes
string
Example:

"Updated notes"

​
status
enum<string>
Available options:
SCHEDULED,
COMPLETED,
CANCELLED,
NO_SHOW
Example:

"COMPLETED"

Response

Appointment updated

​
data
object
required