Delete appointment

Deletes one appointment from the agenda with Supprimer.

MCP tool planity_write → delete_appointment

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

Parameters: delete_appointment
NameTypeDescription
appointment_id string required string Id from list_appointments.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "planity_write",
    "arguments": {
      "operation": "delete_appointment",
      "arguments": {
        "appointment_id": "appointment_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "a_9124",
    "deleted": true,
    "start": "2026-10-26T11:00:00",
    "client": {
      "client_id": "c_0877",
      "name": "Noah Petit"
    },
    "service": "Couleur"
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.