A request message contains updated information in the booking field. The request
contains the booking_id generated by your platform through the
CreateBooking method to identify the booking to update. It also includes
one of the following message:
Slot details to update (booking modifications)
Status to change (booking cancelation)
Fields which don't require change aren't provided in the request.
UpdateBooking response definition
// Request to update a Booking.
message UpdateBookingRequest {
// The booking to be updated
// The following fields can be set in a booking:
// - status, to cancel a booking.
// - one of the following is required:
// - start_time AND duration in the slot, to reschedule a booking.
// - party_size (for dining reservations).
Booking booking = 1;
}
// Response with the updated Booking.
message UpdateBookingResponse {
// The updated booking (required)
Booking booking = 1;
// The updated user payment option originally used to pay for this booking.
// This should be set if the UpdateBookingRequest results in a change to
// the UserPaymentOption.
// For example, if the booking is canceled, the UserPaymentOption should
// reflect an additional credit to the user. In the case of a multi-use
// payment option, the current_count should be increased by one to
// allow the user to create another booking with this payment option. In the
// case of a single-use payment option, a new single-use user payment option
// should be returned. (required if altered in update)
UserPaymentOption user_payment_option = 2;
// If updating a booking fails, this field should reflect the business logic
// error (e.g., booking is not cancelable) (required if failure occurs)
BookingFailure booking_failure = 3;
}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-22 UTC."],[],[],null,["# UpdateBooking Samples and Definitions\n\n### UpdateBooking request and response sample\n\n### UpdateBooking request\n\n {\n \"booking\" : {\n \"booking_id\" : \"890\",\n \"slot\" : {\n \"duration_sec\" : \"1800\",\n \"start_sec\" : \"1606473000\"\n }\n }\n }\n\n### UpdateBooking response\n\n {\n \"booking\" : {\n \"booking_id\" : \"890\",\n \"slot\" : {\n \"duration_sec\" : 1800,\n \"merchant_id\" : \"1234\",\n \"resources\" : {\n \"party_size\" : 2\n },\n \"service_id\" : \"1000\",\n \"start_sec\" : 1606473000\n },\n \"status\" : \"CONFIRMED\",\n \"user_information\" : {\n \"email\" : \"john.smith@gmail.com\",\n \"family_name\" : \"Smith\",\n \"given_name\" : \"John\",\n \"telephone\" : \"+12091111111\",\n \"user_id\" : \"1111111111111111111\"\n }\n }\n }\n\n### Definitions\n\n#### UpdateBooking request definition\n\nA request message contains updated information in the booking field. The request\ncontains the `booking_id` generated by your platform through the\n`CreateBooking` method to identify the booking to update. It also includes\none of the following message:\n\n- Slot details to update (booking modifications)\n- Status to change (booking cancelation)\n\nFields which don't require change aren't provided in the request.\n\n#### UpdateBooking response definition\n\n // Request to update a Booking.\n message UpdateBookingRequest {\n // The booking to be updated\n // The following fields can be set in a booking:\n // - status, to cancel a booking.\n // - one of the following is required:\n // - start_time AND duration in the slot, to reschedule a booking.\n // - party_size (for dining reservations).\n Booking booking = 1;\n }\n\n // Response with the updated Booking.\n message UpdateBookingResponse {\n // The updated booking (required)\n Booking booking = 1;\n\n // The updated user payment option originally used to pay for this booking.\n // This should be set if the UpdateBookingRequest results in a change to\n // the UserPaymentOption.\n // For example, if the booking is canceled, the UserPaymentOption should\n // reflect an additional credit to the user. In the case of a multi-use\n // payment option, the current_count should be increased by one to\n // allow the user to create another booking with this payment option. In the\n // case of a single-use payment option, a new single-use user payment option\n // should be returned. (required if altered in update)\n UserPaymentOption user_payment_option = 2;\n\n // If updating a booking fails, this field should reflect the business logic\n // error (e.g., booking is not cancelable) (required if failure occurs)\n BookingFailure booking_failure = 3;\n }"]]