OneNote get-pages?search API deprecation

Lauren Go

Brian Hardy

Today, we are announcing the deprecation of the OneNote get-pages?search API endpoint supporting consumer Notebooks. It will be decommissioned on May 5, 2024. Beyond this date, the service will be retired. The endpoint will return a 400 bad request response. Developers should remove calls to this service from their apps and workflows.  

Why we’re making this change

For the past 7 years, OneNote APIs on Microsoft Graph have been generally available. Microsoft Graph is the modern API for the Microsoft 365 platform. We make continuous, significant investments in its security, performance, and features to ensure it meets the needs of our own product teams as well as the global ecosystem of developers who build applications using its capabilities.   

While investing in Microsoft Graph, we also examine our classic surface areas. Deprecating unused endpoints or classic patterns allows us to provide the best service and focus on features and APIs most loved by our customers to continue to achieve these goals.  

What action you should take

We do not currently have a replacement for this notification endpoint for OneNote. We understand that for some applications this change, even if anticipated, will require some amount of work to accommodate, but we are confident it will ensure better security, reliability, and performance overall for our customers.  

Thank you for being a OneNote customer. For more information on OneNote APIs in Microsoft Graph, check out this documentation. We listen closely to our customers and their needs and continue to evaluate and develop the endpoints and workflows that enable rich interactions with the Notes ecosystem. Please let us know if you have any additional questions or concerns by reaching out toour Q&A Notes forum.  


Leave a comment

Feedback usabilla icon