| title | Enable Dapr Support in Self-Hosted Gateway | Azure API Management |
|---|---|
| description | Learn now to enable Dapr support in the self-hosted gateway of Azure API Management for exposing and managing Dapr microservices as APIs. |
| services | api-management |
| author | dlepow |
| ms.service | azure-api-management |
| ms.topic | how-to |
| ms.date | 10/08/2025 |
| ms.author | danlep |
[!INCLUDE api-management-availability-premium-dev]
Dapr integration in API Management enables operations teams to directly expose Dapr microservices deployed on Kubernetes clusters as APIs, and make those APIs discoverable and easily consumable by developers with proper controls across multiple Dapr deployments—whether in the cloud, on-premises, or on the edge.
Dapr is a portable runtime for building stateless and stateful microservices-based applications with any language or framework. It codifies the common microservice patterns, like service discovery and invocation with built-in retry logic, publish-and-subscribe with at-least-once delivery semantics, or pluggable binding resources to ease composition using external services. Go to dapr.io for detailed information and instruction on how to get started with Dapr.
To turn on Dapr support in the API Management self-hosted gateway, add the following Dapr annotations to the Kubernetes deployment template, replacing app-name with a desired name. A complete walkthrough of setting up and using API Management with Dapr is available here.
template:
metadata:
labels:
app: app-name
annotations:
dapr.io/enabled: "true"
dapr.io/app-id: "app-name"Tip
You can also deploy the self-hosted gateway with Helm and use the Dapr configuration options.
API Management provides specific policies to interact with Dapr APIs exposed through the self-hosted gateway.
- Learn more about Dapr integration in API Management