{"id":18915,"date":"2024-02-21T09:32:19","date_gmt":"2024-02-21T17:32:19","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=18915"},"modified":"2024-02-21T09:32:19","modified_gmt":"2024-02-21T17:32:19","slug":"breaking-changes-in-microsoft-bookings-graph-apis-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/breaking-changes-in-microsoft-bookings-graph-apis-beta\/","title":{"rendered":"Breaking changes in Microsoft Bookings Graph APIs (beta)"},"content":{"rendered":"

Microsoft Bookings provides support for Microsoft Graph APIs in beta<\/a> as well as V1<\/a>. 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<\/strong>.<\/strong><\/p>\n

What is changing?<\/h2>\n

The path for the following Bookings Graph APIs in beta is getting replaced from \u2018\/beta\u2019 path to \u2018\/beta\/solutions\u2019 path. We are eventually deprecating the \u2018\/beta\u2019 path. This means that you will no longer be able to use the \u2018\/beta\u2019 path after April 30, 2024<\/strong>.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Entity<\/td>\nAPI<\/td>\nOld url format<\/td>\nNew url format<\/td>\n<\/tr>\n
Booking Business<\/td>\nList bookingBusinesses<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses<\/td>\n<\/tr>\n
Create bookingBusiness<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses<\/td>\n<\/tr>\n
Get bookingBusiness <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}<\/td>\n<\/tr>\n
Update bookingbusiness<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}<\/td>\n<\/tr>\n
Delete bookingBusiness <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}<\/td>\n<\/tr>\n
bookingBusiness: publish<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/publish<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/publish<\/td>\n<\/tr>\n
bookingBusiness: unpublish <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/unpublish<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/unpublish<\/td>\n<\/tr>\n
bookingsBusiness: getStaffAvailability <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/getStaffAvailability<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/getStaffAvailability<\/td>\n<\/tr>\n
Appointment<\/td>\nList Bookings calendarView <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/calendarView?start={start-value}&end={end-value}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/calendarView?start={start-value}&end={end-value}<\/td>\n<\/tr>\n
List appointments <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments<\/td>\n<\/tr>\n
Create bookingAppointment <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments<\/td>\n<\/tr>\n
Get bookingAppointment <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\n<\/tr>\n
Update bookingAppointment<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\n<\/tr>\n
Delete bookingAppointment<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments\/{id}<\/td>\n<\/tr>\n
bookingAppointment: cancel <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id} \/appointments\/{id}\/cancel<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id} \/appointments\/{id}\/cancel<\/td>\n<\/tr>\n
Currency<\/td>\nList bookingCurrencies <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingCurrencies<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingCurrencies<\/td>\n<\/tr>\n
Get bookingCurrency <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingCurrencies\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingCurrencies\/{id}<\/td>\n<\/tr>\n
Custom<\/p>\n

Question<\/td>\n

List customQuestions<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customQuestions<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customQuestions<\/td>\n<\/tr>\n
Create bookingCustomQuestion<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customQuestions<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customQuestions<\/td>\n<\/tr>\n
Get bookingCustomQuestion<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\n<\/tr>\n
Update bookingCustomQuestion <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\n<\/tr>\n
Delete bookingCustomQuestion <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customQuestions\/{id}<\/td>\n<\/tr>\n
Customer<\/td>\nList customers <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customers<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customers<\/td>\n<\/tr>\n
Create bookingCustomer <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customers<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customers<\/td>\n<\/tr>\n
Get bookingCustomer<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\n<\/tr>\n
Update bookingcustomer <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\n<\/tr>\n
Delete bookingCustomer<\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/customers\/{id}<\/td>\n<\/tr>\n
Service<\/td>\nList services <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/services<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/services<\/td>\n<\/tr>\n
Create bookingService <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/services<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/services<\/td>\n<\/tr>\n
Get bookingService <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/services\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/services\/{id}<\/td>\n<\/tr>\n
Update bookingservice <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/services\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/services\/{id}<\/td>\n<\/tr>\n
Delete bookingService <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/services\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/services\/{id}<\/td>\n<\/tr>\n
Staff<\/td>\nList staffMembers <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/staffMembers<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/staffMembers<\/td>\n<\/tr>\n
Create bookingStaffMember <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/staffMembers<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/staffMembers<\/td>\n<\/tr>\n
Get bookingStaffMember <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\n<\/tr>\n
Update bookingstaffmember <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\n<\/tr>\n
Delete bookingStaffMember <\/a><\/td>\nhttps:\/\/graph.microsoft.com\/beta\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\nhttps:\/\/graph.microsoft.com\/beta\/solutions\/bookingbusinesses\/{id}\/staffMembers\/{id}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

What do you need to do?<\/h2>\n

If you are using the \u2018\/beta\u2019 path in your applications, you will need to update your code to use the \u2018\/beta\/solutions\u2019 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. <\/strong>After that date, any requests to the \u2018\/beta\u2019 path will return an error.<\/p>\n

Thank you for using the Microsoft Graph Bookings APIs. Happy coding!<\/p>\n

Follow us on X (Twitter) \/ @Microsoft365Dev<\/a> and subscribe to our YouTube channel<\/a> to stay up to date on the latest developer news and announcements.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

We are announcing a breaking change in the beta APIs effective April 30, 2024.<\/p>\n","protected":false},"author":148137,"featured_media":18924,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[218,146,303],"class_list":["post-18915","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-microsoft-bookings","tag-microsoft-graph-api","tag-microsoft-graph-bookings-api"],"acf":[],"blog_post_summary":"

We are announcing a breaking change in the beta APIs effective April 30, 2024.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/18915","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/148137"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=18915"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/18915\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/18924"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=18915"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=18915"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=18915"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}