Back to Tools
cancel_booking
write:bookingsCancel an existing booking. The booking must belong to this business and not already be cancelled or completed.
Input Parameters
Parameters
| Property | Type | Description |
|---|---|---|
bookingIdrequired | string | Booking UUID to cancel |
reason | string | Cancellation reason (max 500 chars) |
Response
Response Schema
| Property | Type | Description |
|---|---|---|
bookingIdrequired | string | Cancelled booking UUID |
statusrequired | string | New status ("cancelled") |
cancelledAtrequired | string | Cancellation 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.