Change appointment
Changes the date, time, service, staff member or notes of an existing appointment.
PATCH https://cotlet.dev/api/v1/planity/appointments/{appointment_id}
write Confirm
Returns the appointment after the change. Only the fields you pass change. It moves the booking of a real client, and the help article does not say whether Planity notifies them, so the agent reads the appointment back to check. 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. |
| start string | string | New date and start time, ISO 8601, in the salon's local time. |
| staff_id string | string | New staff member. |
| service_id string | string | New service. |
| notes string | string | New note. |
Request
curl -X PATCH https://cotlet.dev/api/v1/planity/appointments/appointment_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("planity", "update_appointment", {"appointment_id":"appointment_8c41d2"})const result = await cotlet.call('planity', 'update_appointment', {"appointment_id":"appointment_8c41d2"});cotlet call planity update_appointment --data '{"appointment_id":"appointment_8c41d2"}'Example response
{
"appointment_id": "a_9120",
"start": "2026-10-27T09:30:00",
"end": "2026-10-27T10:30:00",
"client": {
"client_id": "c_1042",
"name": "Léa Martin"
},
"service": "Coupe femme",
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"status": "confirmed"
}