---
search:
  tags:
    - Appointments
    - DELETE
seo:
  description: >-
    Deletes an existing scheduled appointment. Reference for the DELETE
    /appointments/{appointment_id} endpoint in the Almendra API.
sidebar:
  label: Delete a scheduled appointment
  badge: DELETE
title: Delete a scheduled appointment
type: openapi-operation
---
Deletes an existing scheduled appointment.

Requires the `appointments:write` permission.

`DELETE /appointments/{appointment_id}`

**Responses**

- `200` — Appointment deleted successfully
- `400` — Invalid path parameter, query parameter or request body
- `401` — Unauthorized - Invalid API key
- `403` — The account behind the API key has no active paid plan, or the key lacks the permission this operation needs
- `404` — Appointment not found
- `429` — Rate limit exceeded (600 requests per 60 seconds); retry after \`Retry-After\` seconds
- `500` — Unexpected server error

Response example, 200:

```json
{
  "message": "string",
  "deletedId": "string"
}
```