Delete Waitlist Request¶

Delete a patient waitlist request by ID. The request is removed and any pending invites associated with it are closed.

Endpoint¶

DELETE /apis/v1/waitlist-requests/{id}

Parameter	Type	Required	Description
`id`	string (uuid)	Yes	Unique identifier of the waitlist request to delete.

curl --location --request DELETE '{base_url}/apis/v1/waitlist-requests/req-123' \
  --header 'Authorization: Bearer JWT_TOKEN'

Code: 204 No Content

No response body is returned on success.

Code: 404 Not Found

{
  "code": 4040,
  "message": "waitlist request not found",
  "data": null
}

Code: 409 Conflict

{
  "code": 4090,
  "message": "active invites exist for this request",
  "data": null
}

Deletion is rejected with 409 Conflict if the request has active invites in PENDING, SENT, or READ state. Cancel or let those invites expire first, or use Update Waitlist Request to set status: "CANCELLED" instead.
To soft-cancel and preserve the request for audit, prefer PATCH with status: "CANCELLED" rather than DELETE.