---
title: "Cancel Appointment"
method: POST
path: "/calendar/self-schedule/cancel-appointment/{appointment_id}"
tags: ["provider", "calendar", "self-schedule", "mfa"]
---

# Cancel Appointment

`POST /calendar/self-schedule/cancel-appointment/{appointment_id}`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/calendar/self-schedule/cancel-appointment/{appointment_id}`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/calendar/self-schedule/cancel-appointment/:appointment_id/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `appointment_id` string, required

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- SelfScheduleCancellationRequest: Schema for self-schedule appointment cancellation requests
  - `cancellationReason` string, nullable: Optional reason for cancelling the appointment

## Response `200`

Successful Response

- boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) - [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)