| title | Upcoming Breaking Changes in Azure API Management | Microsoft Docs |
|---|---|
| description | A list of all the upcoming breaking changes and feature retirements for the Azure API Management service. |
| services | api-management |
| author | dlepow |
| ms.service | azure-api-management |
| ms.topic | reference |
| ms.date | 12/03/2025 |
| ms.author | danlep |
[!INCLUDE api-management-availability-all-tiers] The following table lists all the upcoming breaking changes and feature retirements for Azure API Management.
| Change Title | Effective Date |
|---|---|
| Resource provider source IP address updates | March 31, 2023 |
| Metrics retirements | August 31, 2023 |
| Resource provider source IP address updates | September 30, 2023 |
| Deprecated (legacy) portal retirement | October 31, 2023 |
| Self-hosted gateway v0/v1 retirement | October 1, 2023 |
| API version retirements | June 1, 2024 |
| Workspaces preview breaking changes | June 14, 2024 |
| stv1 platform retirement - Global Azure | August 31, 2024 |
| stv1 platform retirement - Azure Government, Azure in China | February 24, 2025 |
| Git repository retirement | March 15, 2025 |
| Direct management API retirement | March 15, 2025 |
| Workspaces preview breaking changes, part 2 | March 31, 2025 |
| Managed certificates suspension | August 15, 2025 - March 15, 2026 |
| ADAL-based Microsoft Entra ID identity provider retirement | September 30, 2025 |
| CAPTCHA endpoint update | September 30, 2025 |
| Trusted service connectivity retirement | March 15, 2026 |
| Built-in analytics dashboard retirement | March 15, 2027 |