---
title: "Update an appointment"
method: PUT
path: "/api/v1/appointments/{id}"
tags: ["Appointments"]
---

# Update an appointment

`PUT /api/v1/appointments/{id}`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/appointments/{id}`
- Auth: none declared. Required headers: `Api-Key`

Updates an existing appointment. Only the fields provided will be changed. If the start time or end time changes, a rescheduled notification is automatically sent.

**Required permission:** `assigned_appointment_write` or `unassigned_appointment_write`

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Request body

- object
  - `guest_name` string: Guest name
  - `guest_email` string: Guest email address
  - `guest_phone` string: Guest phone number
  - `additional_guests` string: Additional guest names or details
  - `starts_at_date` string: New appointment date (YYYY-MM-DD)
  - `starts_at_time` string: New appointment start time (e.g., "2:00 PM")
  - `length_in_minutes` integer: Duration in minutes
  - `location` string: Appointment location
  - `location_details` string: Additional location details
  - `private_notes` string: Private internal notes
  - `custom_title` string: Custom title override
  - `brand_id` integer: Brand ID

## Response `200`

appointment updated

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)