Breaking changes in Microsoft Bookings Graph APIs (beta)

Purva Ekatpure

Microsoft Bookings provides support for Microsoft Graph APIs in beta as well as V1. Due to the evolving nature of pre-production APIs (beta APIs), we are implementing some essential modifications in beta. We are announcing a breaking change in the beta APIs which will impact developers whose solutions are currently calling these APIs. This change will be effective from April 30, 2024.

What is changing?

The path for the following Bookings Graph APIs in beta is getting replaced from ‘/beta’ path to ‘/beta/solutions’ path. We are eventually deprecating the ‘/beta’ path. This means that you will no longer be able to use the ‘/beta’ path after April 30, 2024.

Entity API Old url format New url format
Booking Business List bookingBusinesses https://graph.microsoft.com/beta/bookingbusinesses https://graph.microsoft.com/beta/solutions/bookingbusinesses
Create bookingBusiness https://graph.microsoft.com/beta/bookingbusinesses https://graph.microsoft.com/beta/solutions/bookingbusinesses
Get bookingBusiness https://graph.microsoft.com/beta/bookingbusinesses/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}
Update bookingbusiness https://graph.microsoft.com/beta/bookingbusinesses/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}
Delete bookingBusiness https://graph.microsoft.com/beta/bookingbusinesses/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}
bookingBusiness: publish https://graph.microsoft.com/beta/bookingbusinesses/{id}/publish https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/publish
bookingBusiness: unpublish https://graph.microsoft.com/beta/bookingbusinesses/{id}/unpublish https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/unpublish
bookingsBusiness: getStaffAvailability https://graph.microsoft.com/beta/bookingbusinesses/{id}/getStaffAvailability https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/getStaffAvailability
Appointment List Bookings calendarView https://graph.microsoft.com/beta/bookingbusinesses/{id} /calendarView?start={start-value}&end={end-value} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /calendarView?start={start-value}&end={end-value}
List appointments https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments
Create bookingAppointment https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments
Get bookingAppointment https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments/{id}
Update bookingAppointment https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments/{id}
Delete bookingAppointment https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments/{id}
bookingAppointment: cancel https://graph.microsoft.com/beta/bookingbusinesses/{id} /appointments/{id}/cancel https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id} /appointments/{id}/cancel
Currency List bookingCurrencies https://graph.microsoft.com/beta/bookingCurrencies https://graph.microsoft.com/beta/solutions/bookingCurrencies
Get bookingCurrency https://graph.microsoft.com/beta/bookingCurrencies/{id} https://graph.microsoft.com/beta/solutions/bookingCurrencies/{id}
Custom

Question

List customQuestions https://graph.microsoft.com/beta/bookingbusinesses/{id}/customQuestions https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customQuestions
Create bookingCustomQuestion https://graph.microsoft.com/beta/bookingbusinesses/{id}/customQuestions https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customQuestions
Get bookingCustomQuestion https://graph.microsoft.com/beta/bookingbusinesses/{id}/customQuestions/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customQuestions/{id}
Update bookingCustomQuestion https://graph.microsoft.com/beta/bookingbusinesses/{id}/customQuestions/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customQuestions/{id}
Delete bookingCustomQuestion https://graph.microsoft.com/beta/bookingbusinesses/{id}/customQuestions/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customQuestions/{id}
Customer List customers https://graph.microsoft.com/beta/bookingbusinesses/{id}/customers https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customers
Create bookingCustomer https://graph.microsoft.com/beta/bookingbusinesses/{id}/customers https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customers
Get bookingCustomer https://graph.microsoft.com/beta/bookingbusinesses/{id}/customers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customers/{id}
Update bookingcustomer https://graph.microsoft.com/beta/bookingbusinesses/{id}/customers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customers/{id}
Delete bookingCustomer https://graph.microsoft.com/beta/bookingbusinesses/{id}/customers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/customers/{id}
Service List services https://graph.microsoft.com/beta/bookingbusinesses/{id}/services https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/services
Create bookingService https://graph.microsoft.com/beta/bookingbusinesses/{id}/services https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/services
Get bookingService https://graph.microsoft.com/beta/bookingbusinesses/{id}/services/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/services/{id}
Update bookingservice https://graph.microsoft.com/beta/bookingbusinesses/{id}/services/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/services/{id}
Delete bookingService https://graph.microsoft.com/beta/bookingbusinesses/{id}/services/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/services/{id}
Staff List staffMembers https://graph.microsoft.com/beta/bookingbusinesses/{id}/staffMembers https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/staffMembers
Create bookingStaffMember https://graph.microsoft.com/beta/bookingbusinesses/{id}/staffMembers https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/staffMembers
Get bookingStaffMember https://graph.microsoft.com/beta/bookingbusinesses/{id}/staffMembers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/staffMembers/{id}
Update bookingstaffmember https://graph.microsoft.com/beta/bookingbusinesses/{id}/staffMembers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/staffMembers/{id}
Delete bookingStaffMember https://graph.microsoft.com/beta/bookingbusinesses/{id}/staffMembers/{id} https://graph.microsoft.com/beta/solutions/bookingbusinesses/{id}/staffMembers/{id}

What do you need to do?

If you are using the ‘/beta’ path in your applications, you will need to update your code to use the ‘/beta/solutions’ path instead for the APIs listed above. We recommend that you update your applications as soon as possible, before the deprecation date of April 30, 2024. After that date, any requests to the ‘/beta’ path will return an error.

Thank you for using the Microsoft Graph Bookings APIs. Happy coding!

Follow us on X (Twitter) / @Microsoft365Dev and subscribe to our YouTube channel to stay up to date on the latest developer news and announcements.

0 comments

Leave a comment

Feedback usabilla icon