Back to Tools

cancel_booking

write:bookings

Cancel an existing booking. The booking must belong to this business and not already be cancelled or completed.

Input Parameters

Parameters

PropertyTypeDescription
bookingIdrequiredstringBooking UUID to cancel
reasonstringCancellation reason (max 500 chars)

Response

Response Schema

PropertyTypeDescription
bookingIdrequiredstringCancelled booking UUID
statusrequiredstringNew status ("cancelled")
cancelledAtrequiredstringCancellation timestamp (ISO 8601)

Example

Requestjson
{
  "type": "tool",
  "name": "cancel_booking",
  "params": {
    "bookingId": "booking-uuid",
    "reason": "Customer requested reschedule"
  }
}
Responsejson
{
  "success": true,
  "data": {
    "bookingId": "booking-uuid",
    "status": "cancelled",
    "cancelledAt": "2024-01-18T15:30:00Z"
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "cancel_booking",\n  "params": {\n    "bookingId": "booking-uuid",\n    "reason": "Customer requested reschedule"\n  }\n}'

Required scope: This tool requires the write:bookings scope. Make sure your API key has this permission enabled in Settings → Developer.