cancel
Cancels the user's appointment by booking_id, as returned by list_current_bookings. Returns ok=true with cancelled set to that booking_id, or ok=false with a reason: not_found (no such appointment for this user) or bad_id (not a valid UUID). A cancellation is reversible — the freed slot can be booked again — which is why this tool is not marked destructive. To change the time instead of giving the appointment up, reschedule moves it atomically within the same day. Authorization required: the one-time Telegram OAuth consent (scope booking:write), which also covers later calls.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"booking_id": "<booking_id>"
},
"name": "cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| booking_id | Yes | UUID of the appointment, exactly as list_current_bookings returned it. |