Reschedule Appointment

Overview

reschedule_appointment reschedules an existing appointment via the FHIR $reschedule operation. An LLM/agent should call this tool when a patient wants to change the date/time of an existing appointment. It requires appointment_id (from get_appointments), start_date_time (ISO 8601 with timezone offset), and minutes_duration. The recommended flow is to first call get_scheduling_slots to find available slots, then reschedule to the patient's selected time.

Required Parameters

appointment_id (string)

• The appointment ID to reschedule (from get_appointments).

start_date_time (string)

• New start datetime in ISO 8601 format with timezone offset (e.g. '2025-08-22T08:45:00.000-05:00').

minutes_duration (integer)

• Duration of the appointment in minutes.

Optional Parameters

reschedule_comment (string)

• Default: None
• Optional comment explaining the reason for the reschedule.

reschedule_reason_code (string)

• Default: None
• Optional reschedule reason code.

debug (boolean)

• Default: false
• Whether to display debugging information.

Returns

Returns a RescheduleResult object with:

• appointment_id (string, optional) — The rescheduled appointment ID.
• start_date_time (string, optional) — New start date/time.
• timezone (string, optional) — Timezone.
• appointment_dat (string, optional) — Appointment DAT identifier.
• Also includes the shared base result fields: result, error, urls, meta, and debug (the latter two populated only when debug=true).

Notes

• This tool is the final step of the reschedule flow: get_appointments → get_scheduling_slots → reschedule_appointment.