Graph versioning and breaking-change policy
Microsoft's edit ·
Microsoft's commit message in microsoftgraph/microsoft-graph-docs-contrib · commit df03d73 · +1 −1 lines · also on GitHub
⋯ 11 unchanged lines
1212
1313
Microsoft Graph follows the [Microsoft Lifecycle Policy](https://support.microsoft.com/lifecycle).
1414
15
−As new versions of the Microsoft Graph REST APIs are released, earlier versions will be retired. Microsoft declares a version as deprecated at least 24 months in advance of retiring it. Similarly, for individual APIs that are generally available (GA), Microsoft declares an API as deprecated at least 24 months in advance of removing it from the GA version. As for Microsoft Graph SDKs, we only support the latest version. New features, bug fixes, and workarounds are only provided to the latest version, and we will not be maintaining older versions. Our best advice is to upgrade to the latest version whenever possible.
15
+As new versions of the Microsoft Graph REST APIs are released, earlier versions will be retired. Microsoft declares a version as deprecated at least 24 months in advance of retiring it. Similarly, for individual APIs that are generally available (GA), Microsoft declares an API as deprecated at least 24 months in advance of removing it from the GA version. As for Microsoft Graph SDKs, we only support the latest major version of any given library. New features, bug fixes, and workarounds are only provided to the latest version. The major version prior to the latest is supported for 12 months from the general availability date of the latest major version for security fixes only. Our best advice is to upgrade to the latest version whenever possible.
1616
1717
When we increment the major version of the API (for example, from v1.0 to v2.0), we're announcing that the current version (in this example, v1.0) is immediately deprecated and we'll no longer support it 24 months after the announcement. We might make exceptions to this policy for service security or health reliability issues.
1818
⋯ 60 unchanged lines
Microsoft's Markdown source from microsoftgraph/microsoft-graph-docs-contrib, © Microsoft Corporation, under CC BY 4.0. Changed lines with up to 3 unchanged lines around each; ChangeIntel kept this copy 10 Oct 09:39 UTC. The commit date is when the source changed, which can be hours or days before Learn published it.