Releases: Azure/API-Management
Release - self-hosted gateway: 1.1.2
New stable version of the self-hosted gateway is now available. Full list of container versions can be found here.
New
None
Bug fixes
- Rate limit policy throttling at a lower than configured rate.
Breaking changes
None
Release - developer portal: 2.5.7
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Release - API Management service: December, 2020
A regular Azure API Management service update was started on December 7, 2020, and included the following new features and bug fixes, along other improvements. It may take several weeks for your API Management service to receive the update.
New
- You can now create and manage API backends in the Azure portal.

- You can now log API inspector traces to Application Insights and Azure Monitor by setting the
verbosityproperty of theservice/diagnosticsresource todebug. Azure portal interface for this feature will be released in early 2021. - You can now mask or hide sensitive query parameters and headers in diagnostic logs. The
hidesetting will remove an entity, whilemasksetting will replace it with the word "hidden". Refer to theservice/diagnosticsAPI endpoint documentation for more details. Azure portal interface for this feature will be released in early 2021. - You can now monitor database connectivity in secondary regions in the
Network Statuspage in the Azure portal as well as via the respective API call, if your API Management service is deployed in multiple regions. - New management API version
2020-06-01-previewis now available for testing.
Fixed
- Elements of collections in responses from the
Content TypesandContent Itemsmanagement API endpoints no longer overlap between pages.
Release - developer portal: 2.5.6
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Release - self-hosted gateway: 1.1.1
New stable version of the self-hosted gateway is now available. Full list of container versions can be found here.
New
None
Bug fixes
- TLS connection to upstream is unexpectedly terminated under certain conditions.
Breaking changes
None
Release - developer portal: 2.5.5
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Release - developer portal: 2.5.4
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Release - developer portal: 2.5.3
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Release - developer portal: 2.5.2
A new developer portal version has just been released.
If you're using the built-in (managed) developer portal, your portal will be automatically upgraded within two weeks. Make sure to republish it to upgrade the published portal.
If you're using a self-hosted developer portal, you need to merge the source code changes and republish and redeploy your portal manually.
Detailed release notes are available in the developer portal repository.
Deprecation: Legacy developer portal will retire on 31 October 2023
The new developer portal in Azure API Management offers many improvements over the legacy developer portal with the built-in visual editor for customization and styling, automation capabilities, and extensibility options. With this new experience, we retire the legacy developer portal on 31 October 2023. You will continue to receive critical security updates until 31 October 2023.
Required action: Transition from the legacy developer portal to the new developer portal in API Management. Review the documentation to learn how to migrate to the new portal and how to access and customize it.
If you have a support plan and need technical help, create a support request:
- Under Issue type, select Technical.
- Under Subscription, select your subscription.
- Under Service, click My services, then select API Management service.
- Under Summary, type a description of your issue.
- Under Problem type, select Developer portal.
- Under Problem subtype, select the category your request falls into.