This article assumes that you have read the introduction to actions in our introduction to booking graphs.
Cancellations are basically just an action that you issue on a booking, there's just some small details worth knowing.
In this tutorial we will assume that you have created a booking with the "instant" graph. For a guide to how you make bookings please read this tutorial.
Issuing a cancel request looks like this:
curl --request POST \
--user :live_api_key_7nzvc7wsBQQISLeFSVhROys9V1bUJ1z7 \
--url https://api.timekit.io/v2/bookings/:id/cancel \
--data '{
"cancel": {
"message": "Sorry, gotta fix the DeLorean"
}
}'
Whats worth noting is the cancel message.
After issuing the cancel action, the booking will enter a cancelled state and a notification email will be sent to both the owner and customer, unless emails have been disabled.
Next steps
If a booking is cancelled that particular booking is at an end-state and a new booking must be created to request the same time-slot.
We may instead of cancelling a booking confirm it.