Reschedule appointment

An appointment is rescheduled by updating the Appointment resource. The Slot reference and start and end times are updated to match the new appointment slot.

  • Appointment slot => new slot
  • Appointment start/end => new time
PUT [base]/Appointment/605790
Content-Type: application/fhir+json
  "resourceType": "Appointment",
  "id": "605790",
  "start": "2020-01-03T09:00:00Z",
  "end": "2020-01-03T09:30:00Z",
  "slot": [
      "reference": "Slot/234567890"


If the appointment is created successfully, the server responds with a 200 OK.

The full resource can also be returned. See more:

Implementation example

Example client call when using HAPI FHIR

    public void rescheduleAppointment(FinnishAppointmentAppointment appointment) {
        appointment.setSlot(List.of(new Reference(new IdDt(ResourceTypes.SLOT.toCode(), "12345"))));

        String baseUrl = "";
        FhirContext fhirContext = FhirContext.forR4();
        IGenericClient client = fhirContext.newRestfulGenericClient(baseUrl);


Error handling

The update should be rejected with a 400 Bad Request if the resource id in the URL and JSON body do not match.

See more: