---
schema_version: "1"
id: 752ffa9fa70b50ecf61b3f8116c60e12bec519807388363942d23d8bb59a2cb3
title: Update Service Appointments
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/salesforce-scheduler-dev-guide/guides/salesforce-scheduler/uc4-update-service-appointment.md
canonical_url: https://developer.salesforce.com/docs/service/salesforce-scheduler-dev-guide/guide/uc4-update-service-appointment.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 85ce34beb26d425f5eeacb2446a0c57ed6d15fb881c433f6dd0f16704604cf96
products:
  - Salesforce Scheduler Developer Guide
  - Service Cloud Developer Content
---

# Update Service Appointments

Show your users the details of a service appointment—an appointment modified through Salesforce Scheduler—so that users can review and update the appointment.

1.  Create a page where the user can review the appointment details and update the appointment.

    Here’s how a Review Service Appointment page can look.

    ![A representation of the Review Service Appointment screen.](https://developer.salesforce.com/media/salesforce-scheduler-dev-guide/screen_review_appointment.png)

2.  Make a `PATCH` request to the [`service-appointments`](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_service_appointments.htm) Connect API to modify the service appointment.

    **Resource URI**

    ```nolang
    https://YOUR_INSTANCE.salesforce.com/services/data/v68.0/connect/scheduling/service-appointments
    ```

    Where `YOUR_INSTANCE` is a variable.

    **Sample Request**

    **note:** Specify the scheduling policy ID in which the shift is defined. Additionally, pass the parameters including the standard and custom fields that are not available in the input parameters list as extended fields. Edit access on these fields is required to update their values. For example, pass the `status` field as extended fields with its value set to `Canceled` to indicate that the appointment is canceled.

    **Update Service Resource and engagement channel type**

    ```nolang
    {
      "serviceAppointmentId": "08pS7000000019BIAQ",
      "schedulingPolicyId": "2F0VrRM0000004CUV",
      "serviceAppointment": {
        "schedStartTime": "2023-03-24T18:00:00.000+0000",
        "schedEndTime": "2023-03-24T19:00:00.000+0000",
        "serviceTerritoryId": "0HhS700000001DYKAY",
        "engagementChannelTypeId": "0eFS70000004CGFMA2",
        "workTypeId": "08qS70000004DQsIAM"
      },
      "assignedResources": [
        {
          "serviceResourceId": "0HnS700000002jAKAQ",
          "isRequiredResource": true,
          "extendedFields": []
        }
      ]
    }
    ```

    **Update Time Slot**

    ```nolang
    {
       "serviceAppointmentId": "08pS7000000019BIAQ",
       "serviceAppointment": {
          "schedStartTime": "2023-03-24T18:00:00.000+0000",
          "schedEndTime": "2023-03-24T19:00:00.000+0000",
       }
    }
    ```

    **Update Appointment Status**

    ```nolang
    {
       "serviceAppointmentId": "08pS7000000019BIAQ",
       "serviceAppointment": {
          "extendedFields": [{
            "name": "status",
            "value": "Canceled"
          }]
       }
    }
    ```

    **Sample Response**

    The API returns the service appointment ID and the assigned service resources.

    ```nolang
    {
      "result": {
        "assignedResourceIds": [
          "03rS700000000heIAA"
        ],
        "serviceAppointmentId": "08pS7000000019BIAQ"
      }
    }
    ```

3.  Create a page to show confirmation when the service appointment is modified successfully.

    Here’s how a sample confirmation page can look.

    ![A representation of the confirmation screen.](https://developer.salesforce.com/media/salesforce-scheduler-dev-guide/screen_appointment_creation.png)