Reschedule Recurring Home Visits Action

Reschedule all the home visits based on the recurrence pattern and scheduling policy provided.

This action is available in API version 60.0 and later.

Special Access Rules 

The Schedule Recurring Home Visit action is available in Enterprise and Unlimited Editions with Health Cloud enabled with the Home Health setting.

Supported REST HTTP Methods 

URI: /services/data/vXX.X/actions/standard/rescheduleRecurringHomeVisits

Where XX.X is the latest API version.

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

Inputs 

InputTypeDescription
schedulingPolicyIdstringRequired.
ID of the home health scheduling policy to be used to schedule the home visit.
firstVisitStartDateTimedatetimeRequired.
Rescheduled date and time for the start of the first recurring home visit.
firstVisitEndDateTimedatetimeRescheduled date and time for the end of the first recurring home visit.
recurrenceFrequencyTypestringRequired.
Days of recurring home visits. If specified, the selectedDays property is required. Valid values are:
  • Daily
  • Weekly
recurringDaysListstringComma-delimited list of days to reschedule recurring home visits for the patient. For example, Monday, Thursday, Saturday. If recurrenceFrequencyType is set to Weekly, recurringDaysList is required.
operatingHoursIdstringID of the operating hours record that specifies the time slots that the patient wants to reschedule recurring visits for.
serviceAppointmentIdstringRequired.
ID of the service appointment record that’s associated with the first recurring home visit to be rescheduled.

Outputs 

None.

Example 

POST

This sample request is for the Reschedule Recurring Home Visit action.

1{ 
2  "inputs" : [
3    {
4      "schedulingPolicyId" : "001SG000005OtxxYA0",
5      "serviceAppointmentId" : "0jyxx0000000001AAA",
6      "firstVisitStartDateTime" : "2024-03-16T07:00:00.000Z",
7      "firstVisitEndDateTime" : "2024-03-17T01:00:00.000Z",
8      "operatingHoursId" : "0OHxx0000004CKKGA2",
9      "recurrenceFrequencyType" : "WEEKLY",
10      "recurringDaysList" : "Monday, Thursday"
11    }
12  ]
13}

This sample response is for the Reschedule Recurring Home Visit action.

1[ {
2  "actionName" : "rescheduleRecurringHomeVisits",
3  "errors" : null,
4  "isSuccess" : true,
5  "version" : 1
6} ]