---
title: "Delete an appointment"
method: DELETE
path: "/appointments/{appointmentId}"
tags: ["appointments"]
---

# Delete an appointment

`DELETE /appointments/{appointmentId}`

## Path parameters

- `appointmentId` string, required

## Response `200`

Deleted appointment

- Appointment — An Appointment represents a scheduled visit between a patient and a provider at a facility, including the date, duration, appointment type, and status (unconfirmed, confirmed, or cancelled). It tracks how the appointment was created or updated, for example through an EHR integration sync, the scheduling UI, telehealth, or a patient rescheduling via text, and is the core object driving Luma Health's scheduling, reminders, and check-in workflows.
  - `_id` string — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `patient` string
  - `provider` string
  - `facility` string
  - `type` string
  - `date` string, date-time
  - `duration` integer
  - `source` 'integrator' | 'reminder' | 'ui' | 'waitlist' | 'reschedule' | 'telehealth'
  - `status` 'unconfirmed' | 'confirmed' | 'cancelled'

## Other responses

- `401` — Not authenticated
- `403` — Access token does not have the required scope

---

[API](https://skmtc.net/lumahealth/apis/rest-service.md) · [All operations](https://skmtc.net/lumahealth/apis/rest-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lumahealth/rest-service/revisions/d3c75c2a2f1d/schema)
