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