Direct management API retirement (March 2025)

APPLIES TO: Developer | Basic | Standard | Premium

Effective 15 March 2025, Azure API Management will retire its direct management REST API. If you enable and use the direct management API to configure and manage your API Management instance programmatically, migrate to use the standard Azure Resource Manager-based API instead.

Is my service affected by this?

A built-in direct management API to programmatically manage your API Management is disabled by default but can be enabled in the Premium, Standard, Basic, and Developer tiers of API Management. While your API Management instance isn't affected by this change, any tool, script, or program that uses the direct management API to interact with the API Management service is affected by this change. You'll be unable to run those tools successfully after the retirement date unless you update the tools to use the standard Azure Resource Manager-based REST API for API Management.

What is the deadline for the change?

Support for the direct management API will no longer be available after 15 March 2025.

What do I need to do?

From now through 15 March 2025, if you have enabled the direct management API, you can continue to use it normally. At any time before the retirement date, update your tools, scripts, and programs to use equivalent operations in the Azure Resource Manager-based REST API instead.

Help and support

If you have questions, get answers from community experts in Microsoft Q&A. If you have a support plan and you need technical help, create a support request.

1. Under Issue type, select Technical.
2. Under Subscription, select your subscription.
3. Under Service, select My services, then select API Management Service.
4. Under Resource, select the Azure resource that you’re creating a support request for.
5. For Summary, type a description of your issue, for example, "Direct management API".

Related content

See all upcoming breaking changes and feature retirements.