Skip to main content
DELETE

Overview

Permanently deletes an appointment. Access is owner-only: the appointment’s doctor_id must match the caller, otherwise a 403 Forbidden is returned.
This action is irreversible. The appointment and every document attached to it are permanently removed.

Authentication

string
required
Bearer token for authenticated access.

Path Parameters

string
required
Appointment ObjectId to delete. Owner-only. A malformed value fails with a 400 cast error.

Response

boolean
Whether the deletion succeeded. On success the body is { "success": true } with no data.

Example Request

Example Response

Error Responses

403 Forbidden is returned when the appointment is owned by a different doctor. A missing or invalid Bearer token returns 401 with a message key.

Side Effects

  • Every document attached to the appointment is cascade-deleted along with it.
  • Other appointments that share the same case_id are not affected.