---
title: "Cancel an Appointment"
method: POST
path: "/api/v1/appointments/{id}/cancel"
tags: ["Appointments"]
---

# Cancel an Appointment

`POST /api/v1/appointments/{id}/cancel`

Permissions needed: EDIT_APPOINTMENTS
Shorthand version of appointment update endpoint for changing just status to cancelled.

## Parameters

- `#/paths/~1api~1v1~1sales/delete/parameters/0` — unresolved $ref

## Request body

- object
  - `observations` string
  - `notification_message` string
  - `cancellation_reason` string
  - `recurrence_update_mode` 'this' | 'this_and_following' | 'all' — Recurrence update mode

## Response `200`

successful operation

- object
  - `data` Data — unresolved $ref

## Other responses

- `422` — unresolved $ref

---

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