Microsoft
Microsoft Graph
Microsoft
This article describes the support and breaking change policies for Microsoft Graph and the versions of the Microsoft Graph API that are currently available.
Microsoft Graph follows the Microsoft Lifecycle Policy.
As new versions of the Microsoft Graph REST APIs and Microsoft Graph SDKs are released, earlier versions will be retired. Microsoft will declare a version as deprecated at least 24 months in advance of retiring an API or an SDK.
When we increment the major version of the API (for example, from v1.0 to v2.0), we are announcing that the current version (in this example, v1.0) is immediately deprecated and we will no longer support it 24 months after the announcement. When an API is marked as deprecated, we strongly recommend that you migrate to the latest version as soon as possible to avoid being affected. We might make exceptions to this policy for service security or health reliability issues.
Microsoft Graph has a log of changes across versions. These changes are listed in the Microsoft Graph Changelog. As new functionality and data is added to Microsoft Graph, we will increment the API version number for any non-backward compatible changes to the API.
The following are examples of non-backward compatible changes:
The following are examples of backward compatible changes:
Note: Over time, we will update the list of backward compatible changes. If you generate your own client proxies (like WCF clients), our guidance is that your client applications should be prepared to receive properties and derived types not previously defined by the Microsoft Graph API service. Microsoft Graph API follows the guidance described in the Model Versioning section in the Microsoft REST API guidelines.
The following versions of the Microsoft Graph API are currently available.
Exposed under https://graph.microsoft.com/beta, the Microsoft Graph API beta version contains features that are currently in preview. For beta API documentation, see Microsoft Graph beta endpoint reference. Expect breaking changes to the beta version from time to time. Do not take a production dependency on /beta APIs.
We make no guarantees that a beta feature will be promoted to the current version. When the Microsoft Graph API team believes that a beta feature is ready for general availability (GA), we will add that feature to the latest current version. If the promotion of the feature would result in a breaking change to the current version, the version number will be incremented, with the new version becoming the current version. Our developer community can post feature request on UserVoice, including requests for new features as well as requests to promote existing beta APIs to the current version.
The current version of Microsoft Graph is v1.0. Exposed under https://graph.microsoft.com/v1.0, the Microsoft Graph API /v1.0 version contains features that are generally available and ready for production use. You can browse the documentation for the v1.0 APIs in the table of contents.
There are currently no deprecated versions of Microsoft Graph.
By using the Microsoft Graph APIs, you agree to the Terms of Use.
Your feedback is important to us. Connect with us on StackOverflow. Tag your questions with {MicrosoftGraph}.
