Delete appointment
Deletes one appointment from the agenda with Supprimer.
DELETE https://cotlet.dev/api/v1/planity/appointments/{appointment_id}
write Confirm
Returns the id and the details of the deleted appointment. Deleting from the agenda ignores the cancellation deadline you set for online bookings. Planity deletes one appointment at a time and has no bulk delete, so the agent calls this once per appointment. A deleted appointment is not restored by Cotlet; add it again with create_appointment. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_id string required | string | Id from list_appointments. |
Request
curl -X DELETE https://cotlet.dev/api/v1/planity/appointments/appointment_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("planity", "delete_appointment", {"appointment_id":"appointment_8c41d2"})const result = await cotlet.call('planity', 'delete_appointment', {"appointment_id":"appointment_8c41d2"});cotlet call planity delete_appointment --data '{"appointment_id":"appointment_8c41d2"}'Example response
{
"appointment_id": "a_9124",
"deleted": true,
"start": "2026-10-26T11:00:00",
"client": {
"client_id": "c_0877",
"name": "Noah Petit"
},
"service": "Couleur"
}