---
title: "Updates an existing viewing"
method: PATCH
path: "/appointments/viewings/{appointmentId}"
tags: ["Appointments"]
---

# Updates an existing viewing

`PATCH /appointments/viewings/{appointmentId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/appointments/viewings/{appointmentId}`
- Auth: `appAuth` (a scheme the document does not define)

Updates a viewing with any of the following fields supported for update:
- /startDate ie. The start date and time in ISO 8601 format to update against the requested viewing
- /endDate ie. The end date and time in ISO 8601 format to update against the requested viewing
- /negotiatorId ie. The unique identifier of the negotiator to be associated with the requested viewing
- /status ie. When cancelling, the status the requested viewing should be set to
- /notes ie. The notes to be associated with the requested viewing
- /internalNotes ie. The internal notes to be associated with the requested viewing
- /applicantFeedback ie. The applicant feedback to be associated with the requested viewing
            
Required scope: alto/write:appointments_viewings

## Path parameters

- `appointmentId` integer, required

## Headers

- `AgencyRef` string, required

## Request body

- ViewingPatchOperation[]: Array of operations to perform
  - `op` 'replace'
  - `value` string
  - `path` '/status' | '/startDate' | '/endDate' | '/negotiatorId' | '/notes' | '/applicantFeedback' | '/internalNotes'

## Response `200`

Returns an object with a flag indicating a successful update

## Other responses

- `400`: Validation error e.g. invalid date range selection or unsupported patch path/value.
- `401`: Unauthorized
- `403`: Invalid scope or AgencyRef for request.
- `404`: Appointment requesting to be updated does not exist against the requested AgencyRef
- `500`: Internal Server Error

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)