How do I install the Azure API Management skill?

Run npx skillmds@latest add microsoftdocs/azure-api-management in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Azure API Management skill do?

Expert knowledge for Azure API Management development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when integrating APIM with AI backends, VNet/domains, OAuth/Entra ID, self-hosted gateways, or Front Door/App Gateway, and other Azure API Management related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Logic Apps (use azure-logic-apps), Azure Service Bus (use azure-service-bus). It is listed under DevOps & Infra on SkillMD.

Is Azure API Management safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Azure API Management?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Azure API Management free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Azure API Management?

microsoftdocs (@microsoftdocs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Azure API Management by microsoftdocs

Name: Azure API Management
Rating: 4.2 (5 reviews)
Author: microsoftdocs

Azure API Management Skill

This skill provides expert guidance for Azure API Management. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L45	Diagnosing and fixing API Management issues: request tracing, SNAT port exhaustion, custom domain/Key Vault cert errors, and developer portal problems using Diagnose and Solve tools.
Best Practices	L46-L54	Best practices for caching, throttling, security (OWASP API Top 10), SSE setup, and running the self-hosted gateway on Kubernetes in production for Azure API Management.
Decision Making	L55-L73	Guidance for planning and migrating API Management: pricing and scaling, cost control, DevOps/CI/CD, VNet choices, workspace and portal changes, and moving from legacy or other platforms.
Architecture & Design Patterns	L74-L79	Patterns for placing API Management behind App Gateway/WAF, Azure Front Door, or AKS, including routing, security, and high‑availability reference architectures.
Limits & Quotas	L80-L100	Limits, quotas, and throttling rules for APIs (REST/SOAP/WebSocket), including rate/usage caps, token limits, validation policies, and service/gateway constraints in Azure API Management.
Security	L101-L143	Securing APIs and gateways: authN/authZ (OAuth2, Entra ID, B2C, JWT, certs, managed identities), TLS/ciphers, content safety, DDoS/Defender, RBAC, and secure developer portal/self-hosted gateway.
Configuration	L144-L242	Configuring Azure API Management and AI Gateway: networking/VNet, domains, caching, policies, monitoring, backends, developer portal, self-hosted gateways, and infrastructure-as-code setup.
Integrations & Coding Patterns	L243-L275	Patterns and scripts for integrating API Management with AI/LLM backends, logging/monitoring, Event Hubs/Service Bus/Dapr, OAuth/Graph/GitHub, and importing/exporting APIs (OpenAPI, SAP, Web Apps, Postman, Power Platform).
Deployment	L276-L296	Deploying and scaling API Management: autoscale, multi-region, backup/restore, vNet/external access, self-hosted gateways (AKS/K8s/Docker/Arc), portal automation, APIOps, and MCP versioning.

Troubleshooting

Topic	URL
Trace and debug API requests in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-api-inspector
Fix API Management custom domain failures with Key Vault certificates	https://learn.microsoft.com/en-us/azure/api-management/api-management-troubleshoot-cannot-add-custom-domain
Developer portal FAQ and troubleshooting for API Management	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-faq
Use Diagnose and Solve Problems for Azure API Management APIs	https://learn.microsoft.com/en-us/azure/api-management/diagnose-solve-problems
Diagnose SNAT port exhaustion in API Management	https://learn.microsoft.com/en-us/azure/api-management/troubleshoot-response-timeout-and-errors

Best Practices

Topic	URL
Configure response caching for APIs in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache
Implement custom key-based caching in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-cache-by-key
Run API Management self-hosted gateway on Kubernetes in production	https://learn.microsoft.com/en-us/azure/api-management/how-to-self-hosted-gateway-on-kubernetes-in-production
Configure server-sent events for Azure API Management APIs	https://learn.microsoft.com/en-us/azure/api-management/how-to-server-sent-events
Mitigate OWASP API Top 10 threats with API Management	https://learn.microsoft.com/en-us/azure/api-management/mitigate-owasp-api-threats

Decision Making

Topic	URL
Use API Management capacity metrics to plan scaling	https://learn.microsoft.com/en-us/azure/api-management/api-management-capacity
Compare Azure API Management pricing tiers by features	https://learn.microsoft.com/en-us/azure/api-management/api-management-features
Transition from built-in API Management analytics dashboard to Azure Monitor	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/analytics-dashboard-retirement-march-2027
Migrate Azure API Management ARM API versions before retirement	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/api-version-retirement-sep-2023
Migrate from direct management API to ARM-based API in API Management	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/direct-management-api-retirement-march-2025
Move from built-in Git configuration to APIOps for API Management	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/git-configuration-retirement-march-2025
Migrate from legacy to new API Management developer portal	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/legacy-portal-retirement-oct-2023
Handle breaking changes for API Management workspaces (June 2024)	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/workspaces-breaking-changes-june-2024
Migrate preview API Management workspaces to GA workspaces	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/workspaces-breaking-changes-march-2025
Plan DevOps and CI/CD pipelines for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/devops-api-development-templates
Migrate Amazon API Gateway workloads to Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/migrate-amazon-api-gateway-to-api-management
Use API Management features to support API monetization	https://learn.microsoft.com/en-us/azure/api-management/monetization-support
Plan and manage Azure API Management costs	https://learn.microsoft.com/en-us/azure/api-management/plan-manage-costs
Upgrade and scale Azure API Management tiers and units	https://learn.microsoft.com/en-us/azure/api-management/upgrade-and-scale
Choose and configure virtual network options for API Management	https://learn.microsoft.com/en-us/azure/api-management/virtual-network-concepts

Architecture & Design Patterns

Topic	URL
Use API Management with AKS microservices architectures	https://learn.microsoft.com/en-us/azure/api-management/api-management-kubernetes
Front Azure API Management with Azure Front Door	https://learn.microsoft.com/en-us/azure/api-management/front-door-api-management

Limits & Quotas

Topic	URL
API format support restrictions for OpenAPI, WSDL, and WADL	https://learn.microsoft.com/en-us/azure/api-management/api-management-api-import-restrictions
Understand Azure API Management limits and behaviors	https://learn.microsoft.com/en-us/azure/api-management/api-management-faq
Configure flexible throttling in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-flexible-throttling
Import SOAP APIs and handle WSDL restrictions in API Management	https://learn.microsoft.com/en-us/azure/api-management/import-soap-api
Limit concurrent request execution in API Management	https://learn.microsoft.com/en-us/azure/api-management/limit-concurrency-policy
Enforce LLM token limits with llm-token-limit policy	https://learn.microsoft.com/en-us/azure/api-management/llm-token-limit-policy
Configure quota-by-key policy for per-key limits	https://learn.microsoft.com/en-us/azure/api-management/quota-by-key-policy
Configure quota policy limits in API Management	https://learn.microsoft.com/en-us/azure/api-management/quota-policy
Set rate-limit policy thresholds in API Management	https://learn.microsoft.com/en-us/azure/api-management/rate-limit-policy
Import and convert SOAP APIs to REST in API Management	https://learn.microsoft.com/en-us/azure/api-management/restify-soap-api
Understand support policies and limitations for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-support-policies
Understand Azure API Management service limits	https://learn.microsoft.com/en-us/azure/api-management/service-limits
Validate request and response content with size limits	https://learn.microsoft.com/en-us/azure/api-management/validate-content-policy
Validate response headers with validate-headers policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-headers-policy
Validate request parameters with validate-parameters policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-parameters-policy
Validate HTTP status codes with validate-status-code policy	https://learn.microsoft.com/en-us/azure/api-management/validate-status-code-policy
Understand WebSocket API limits in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/websocket-api

Security

Topic	URL
Configure governance and security for AI Gateway tier	https://learn.microsoft.com/en-us/azure/api-management/ai-gateway-govern-secure-assets
Configure authentication and authorization for LLM APIs in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-authenticate-authorize-ai-apis
Authorize API Management developer portal with Microsoft Entra ID	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-aad
Configure API Management developer portal with Azure AD B2C	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-aad-b2c
Add and manage custom CA certificates in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-ca-certificates
Manage API Management developer access using groups	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-groups
Configure TLS protocols and cipher suites in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-manage-protocols-ciphers
Configure mutual TLS client certificates in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-mutual-certificates
Secure API Management front-end access with client certificate authentication	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-mutual-certificates-for-clients
Configure OAuth 2.0 authorization in API Management test console	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-oauth2
Protect APIs in API Management using OAuth 2.0 with Microsoft Entra ID	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-protect-backend-with-aad
Configure managed identities for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-use-managed-service-identity
Configure RBAC roles for Azure API Management access	https://learn.microsoft.com/en-us/azure/api-management/api-management-role-based-access-control
Configure Microsoft Entra applications for product-level OAuth access	https://learn.microsoft.com/en-us/azure/api-management/applications
Use authentication-basic policy to secure backend calls in API Management	https://learn.microsoft.com/en-us/azure/api-management/authentication-basic-policy
Configure managed identity authentication in API Management	https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy
Migrate API Management identity providers from ADAL to MSAL	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/identity-provider-adal-retirement-sep-2025
Prepare Azure API Management for TLS 1.0/1.1 retirement	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/tls-versions-retirement-oct-2025
Configure credential providers in API Management	https://learn.microsoft.com/en-us/azure/api-management/credentials-configure-common-providers
Set up basic username/password auth for API Management developer portal	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-basic-authentication
Configure CORS for API Management developer portal test console	https://learn.microsoft.com/en-us/azure/api-management/enable-cors-developer-portal
Use get-authorization-context policy for credential providers	https://learn.microsoft.com/en-us/azure/api-management/get-authorization-context-policy
Secure serverless APIs via API Management and Azure AD B2C	https://learn.microsoft.com/en-us/azure/api-management/howto-protect-backend-frontend-azure-ad-b2c
Apply llm-content-safety policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/llm-content-safety-policy
Protect Azure API Management with DDoS Protection	https://learn.microsoft.com/en-us/azure/api-management/protect-with-ddos-protection
Enable Defender for APIs protection in API Management	https://learn.microsoft.com/en-us/azure/api-management/protect-with-defender-for-apis
Configure secure access to Azure API Management developer portal	https://learn.microsoft.com/en-us/azure/api-management/secure-developer-portal-access
Secure inbound and outbound access to MCP servers in API Management	https://learn.microsoft.com/en-us/azure/api-management/secure-mcp-servers
Apply Azure Policy compliance controls to API Management	https://learn.microsoft.com/en-us/azure/api-management/security-controls-policy
Configure authentication options for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-authentication-options
Configure access token authentication for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-default-authentication
Configure Microsoft Entra authentication for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-azure-ad
Enable workload identity authentication for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-workload-identity
Secure perimeter-protected backends with API Management and managed identity	https://learn.microsoft.com/en-us/azure/api-management/using-network-security-perimeter
Validate Microsoft Entra JWTs in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-azure-ad-token-policy
Enforce client certificate validation in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-client-certificate-policy
Use validate-graphql-request policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-graphql-request-policy
Configure validate-jwt policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-jwt-policy
Use validate-odata-request policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/validate-odata-request-policy

Configuration

Topic	URL
Configure private networking for API Management AI Gateway	https://learn.microsoft.com/en-us/azure/api-management/ai-gateway-configure-private-networking
Configure models and MCP tools in AI Gateway tier	https://learn.microsoft.com/en-us/azure/api-management/ai-gateway-manage-models-tools
Configure error handling policies in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-error-handling-policies
Configure external Redis-compatible cache for API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache-external
Configure custom domain names for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-configure-custom-domain-gateway
Configure notifications and email templates in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-configure-notifications
Create and manage user accounts in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-or-invite-developers
Create and configure subscriptions in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-subscriptions
Integrate API Management with Application Gateway in VNets	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-integrate-internal-vnet-appgateway
Retrieve and manage Azure API Management IP addresses	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-ip-addresses
Configure and apply Azure API Management policies	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-policies
Configure named values in Azure API Management policies	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-properties
Configure delegation for user registration and subscriptions in API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-setup-delegation
Configure Azure Monitor metrics and logs for API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-use-azure-monitor
Deploy Azure API Management in internal VNets	https://learn.microsoft.com/en-us/azure/api-management/api-management-using-with-internal-vnet
Configure authentication-certificate policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/authentication-certificate-policy
Configure semantic caching for LLM APIs in API Management	https://learn.microsoft.com/en-us/azure/api-management/azure-openai-enable-semantic-caching
Configure and manage Azure API Management backends	https://learn.microsoft.com/en-us/azure/api-management/backends
Update network settings for API Management CAPTCHA endpoint change	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/captcha-endpoint-change-sep-2025
Migrate from retired API Management legacy metrics to Requests metric	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/metrics-retirement-aug-2023
Update VNet settings for API Management RP source IP change (Mar 2023)	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/rp-source-ip-address-change-mar-2023
Update VNet settings for API Management RP source IP change (Sep 2023)	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/rp-source-ip-address-change-sep-2023
Replace trusted service connectivity for API Management gateways	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/trusted-service-connectivity-retirement-march-2026
Configure cache-lookup policy for response caching	https://learn.microsoft.com/en-us/azure/api-management/cache-lookup-policy
Use cache-lookup-value policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/cache-lookup-value-policy
Configure cache-remove-value policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/cache-remove-value-policy
Configure cache-store policy to cache API responses	https://learn.microsoft.com/en-us/azure/api-management/cache-store-policy
Configure cache-store-value policy for custom cache entries	https://learn.microsoft.com/en-us/azure/api-management/cache-store-value-policy
Configure check-header policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/check-header-policy
Configure choose policy for conditional logic in APIM	https://learn.microsoft.com/en-us/azure/api-management/choose-policy
Configure multiple credential connections in API Management	https://learn.microsoft.com/en-us/azure/api-management/configure-credential-connection
Configure custom domains and certificates for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/configure-custom-domain
Configure API Management automatic service update settings	https://learn.microsoft.com/en-us/azure/api-management/configure-service-update-settings
Configure CORS behavior with cors policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/cors-policy
Configure cosmosdb-data-source policy for GraphQL resolvers	https://learn.microsoft.com/en-us/azure/api-management/cosmosdb-data-source-policy
Understand credential manager OAuth 2.0 management and runtime flows	https://learn.microsoft.com/en-us/azure/api-management/credentials-process-flow
Enable cross-domain access with cross-domain policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/cross-domain-policy
Extend API Management developer portal with custom functionality	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-extend-custom-functionality
Configure Application Insights for API Management developer portal	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-integrate-application-insights
Integrate Google Tag Manager with API Management portal	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-integrate-google-tag-manager
Configure emit-metric policy for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/emit-metric-policy
Enable availability zones for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/enable-availability-zone-support
Configure CORS for API Management custom connectors in Power Platform	https://learn.microsoft.com/en-us/azure/api-management/enable-cors-power-platform
Configure find-and-replace policy for API Management	https://learn.microsoft.com/en-us/azure/api-management/find-and-replace-policy
Configure forward-request policy to call backends	https://learn.microsoft.com/en-us/azure/api-management/forward-request-policy
Configure cloud metrics and logs for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/how-to-configure-cloud-metrics-logs
Configure local metrics and logs for self-hosted gateway on Kubernetes	https://learn.microsoft.com/en-us/azure/api-management/how-to-configure-local-metrics-logs
Configure http-data-source resolver policy for GraphQL APIs	https://learn.microsoft.com/en-us/azure/api-management/http-data-source-policy
Insert reusable policy fragments with include-fragment	https://learn.microsoft.com/en-us/azure/api-management/include-fragment-policy
Inject Premium v2 API Management into a virtual network	https://learn.microsoft.com/en-us/azure/api-management/inject-vnet-v2
Configure outbound virtual network integration for API Management v2	https://learn.microsoft.com/en-us/azure/api-management/integrate-vnet-outbound
Configure invoke-dapr-binding policy for external resources	https://learn.microsoft.com/en-us/azure/api-management/invoke-dapr-binding-policy
Configure IP filtering rules in API Management	https://learn.microsoft.com/en-us/azure/api-management/ip-filter-policy
Configure json-to-xml policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/json-to-xml-policy
Configure jsonp policy for cross-domain API calls	https://learn.microsoft.com/en-us/azure/api-management/jsonp-policy
Configure llm-emit-token-metric policy for API Management	https://learn.microsoft.com/en-us/azure/api-management/llm-emit-token-metric-policy
Use llm-semantic-cache-lookup policy for LLM caching	https://learn.microsoft.com/en-us/azure/api-management/llm-semantic-cache-lookup-policy
Configure llm-semantic-cache-store policy for LLM caching	https://learn.microsoft.com/en-us/azure/api-management/llm-semantic-cache-store-policy
Programmatically manage MCP servers in API Management	https://learn.microsoft.com/en-us/azure/api-management/manage-mcp-servers-rest-api
Configure mock-response policy to simulate APIs	https://learn.microsoft.com/en-us/azure/api-management/mock-response-policy
Configure monitoring and alerts for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/monitor-api-management
Reference monitoring metrics and logs for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/monitor-api-management-reference
Configure and query MCP server telemetry in API Management	https://learn.microsoft.com/en-us/azure/api-management/monitor-mcp-servers
Create and reuse policy fragments in API Management	https://learn.microsoft.com/en-us/azure/api-management/policy-fragments
Configure inbound private endpoint for API Management	https://learn.microsoft.com/en-us/azure/api-management/private-endpoint
Configure proxy policy and HTTP proxy settings in APIM	https://learn.microsoft.com/en-us/azure/api-management/proxy-policy
Configure publish-event policy for GraphQL subscriptions	https://learn.microsoft.com/en-us/azure/api-management/publish-event-policy
Deploy Azure API Management using ARM templates	https://learn.microsoft.com/en-us/azure/api-management/quickstart-arm-template
Provision Azure API Management with Bicep templates	https://learn.microsoft.com/en-us/azure/api-management/quickstart-bicep
Create Azure API Management with Terraform configuration	https://learn.microsoft.com/en-us/azure/api-management/quickstart-terraform
Configure Azure API Management rate-limit-by-key policy	https://learn.microsoft.com/en-us/azure/api-management/rate-limit-by-key-policy
Configure redirect-content-urls policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/redirect-content-urls-policy
Configure retry policy with conditions and counts in APIM	https://learn.microsoft.com/en-us/azure/api-management/retry-policy
Configure return-response policy for custom API responses	https://learn.microsoft.com/en-us/azure/api-management/return-response-policy
Configure rewrite-uri policy for Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/rewrite-uri-policy
Configure Azure Arc extension for self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-arc-reference
Reference container settings for self-hosted gateway v2	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-settings-reference
Configure send-one-way-request policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/send-one-way-request-policy
Configure send-request policy with timeout settings	https://learn.microsoft.com/en-us/azure/api-management/send-request-policy
Configure set-backend-service policy for backend routing	https://learn.microsoft.com/en-us/azure/api-management/set-backend-service-policy
Configure set-body policy for API Management requests	https://learn.microsoft.com/en-us/azure/api-management/set-body-policy
Configure and edit Azure API Management policy definitions	https://learn.microsoft.com/en-us/azure/api-management/set-edit-policies
Configure set-header policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/set-header-policy
Configure set-method policy for API Management requests	https://learn.microsoft.com/en-us/azure/api-management/set-method-policy
Configure set-query-parameter policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/set-query-parameter-policy
Configure set-status policy for API Management responses	https://learn.microsoft.com/en-us/azure/api-management/set-status-policy
Configure set-variable policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/set-variable-policy
Recover deleted Azure API Management instances with soft-delete	https://learn.microsoft.com/en-us/azure/api-management/soft-delete
Configure sql-data-source policy for Azure SQL GraphQL resolvers	https://learn.microsoft.com/en-us/azure/api-management/sql-data-source-policy
Add custom trace entries in API Management	https://learn.microsoft.com/en-us/azure/api-management/trace-policy
Configure VNet injection resources for API Management	https://learn.microsoft.com/en-us/azure/api-management/virtual-network-injection-resources
Configure VNet settings for Azure API Management classic tiers	https://learn.microsoft.com/en-us/azure/api-management/virtual-network-reference
Configure workspace gateway VNet requirements for API Management	https://learn.microsoft.com/en-us/azure/api-management/virtual-network-workspaces-resources
Configure wait policy for parallel execution in APIM	https://learn.microsoft.com/en-us/azure/api-management/wait-policy
Configure xml-to-json policy in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/xml-to-json-policy

Integrations & Coding Patterns

Topic	URL
Azure PowerShell sample scripts for Azure services	https://github.com/Azure/azure-docs-powershell-samples
Import Amazon Bedrock LLM passthrough APIs into API Management	https://learn.microsoft.com/en-us/azure/api-management/amazon-bedrock-passthrough-llm-api
Integrate Azure API Management with Application Insights logging	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-app-insights
Send Azure API Management logs to Event Hubs	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-log-event-hubs
Send messages to Azure Service Bus from API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-send-service-bus
Log API Management traffic to Event Hubs and Moesif	https://learn.microsoft.com/en-us/azure/api-management/api-management-log-to-eventhub-sample
Use policy expressions in Azure API Management policies	https://learn.microsoft.com/en-us/azure/api-management/api-management-policy-expressions
Call external HTTP services from API Management policies	https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-send-request
Import Microsoft Foundry AI endpoints into API Management	https://learn.microsoft.com/en-us/azure/api-management/azure-ai-foundry-api
Import Azure OpenAI model APIs as REST in API Management	https://learn.microsoft.com/en-us/azure/api-management/azure-openai-api-from-specification
Configure GraphQL field resolvers in Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/configure-graphql-resolver
Create managed connection from API Management to Microsoft Graph	https://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-azure-ad
Configure GitHub OAuth connections in API Management	https://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-github
Configure user-delegated OAuth connections in API Management	https://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-user-delegated
Export Azure API Management APIs to Postman collections	https://learn.microsoft.com/en-us/azure/api-management/export-api-postman
Export Azure API Management APIs to Microsoft Power Platform	https://learn.microsoft.com/en-us/azure/api-management/export-api-power-platform
Configure Service Fabric as API Management backend	https://learn.microsoft.com/en-us/azure/api-management/how-to-configure-service-fabric-backend
Deploy API Management self-hosted gateway with OpenTelemetry on Kubernetes	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-kubernetes-opentelemetry
Integrate Azure API Management events with Event Grid	https://learn.microsoft.com/en-us/azure/api-management/how-to-event-grid
Import OpenAPI specifications into Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/import-api-from-oas
Import Azure Web Apps as APIs into API Management	https://learn.microsoft.com/en-us/azure/api-management/import-app-service-as-api
Configure log-to-eventhub policy for API Management	https://learn.microsoft.com/en-us/azure/api-management/log-to-eventhub-policy
Integrate Google Gemini OpenAI-compatible APIs with API Management	https://learn.microsoft.com/en-us/azure/api-management/openai-compatible-google-gemini-api
Import OpenAI-compatible LLM APIs into API Management	https://learn.microsoft.com/en-us/azure/api-management/openai-compatible-llm-api
Configure publish-to-dapr policy in API Management	https://learn.microsoft.com/en-us/azure/api-management/publish-to-dapr-policy
Import SAP OData metadata into Azure API Management	https://learn.microsoft.com/en-us/azure/api-management/sap-api
Enable Dapr integration for API Management self-hosted gateway	https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-dapr
Send Azure Service Bus messages via API Management policy	https://learn.microsoft.com/en-us/azure/api-management/send-service-bus-message-policy
Route API Management requests to Dapr with set-backend-service	https://learn.microsoft.com/en-us/azure/api-management/set-backend-service-dapr-policy

Deployment

Topic	URL
Configure autoscale rules for Azure API Management instances	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-autoscale
Deploy Azure API Management across multiple regions	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-deploy-multi-region
Backup and restore Azure API Management for disaster recovery	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-disaster-recovery-backup-restore
Migrate Azure API Management instances between regions	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-migrate
Provision gateway resources for self-hosted API Management	https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-provision-self-hosted-gateway
Check region availability for API Management v2 tiers	https://learn.microsoft.com/en-us/azure/api-management/api-management-region-availability
Deploy Azure API Management to an external virtual network	https://learn.microsoft.com/en-us/azure/api-management/api-management-using-with-vnet
Automate deployment of API Management developer portal content	https://learn.microsoft.com/en-us/azure/api-management/automate-portal-deployments
Automate Azure API Management operations with Azure Automation	https://learn.microsoft.com/en-us/azure/api-management/automation-manage-api-management
Plan for managed certificate suspension in API Management	https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/managed-certificates-suspension-august-2025
Self-host the Azure API Management developer portal	https://learn.microsoft.com/en-us/azure/api-management/developer-portal-self-host
Deploy API Management gateway as Azure Arc extension	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-azure-arc
Deploy API Management self-hosted gateway to AKS	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-azure-kubernetes-service
Deploy API Management self-hosted gateway to Azure Container Apps	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-container-apps
Deploy API Management self-hosted gateway to Docker	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-docker
Deploy API Management self-hosted gateway to Kubernetes with YAML	https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-kubernetes
Use APIOps CLI to manage Azure API Management config	https://learn.microsoft.com/en-us/azure/api-management/how-to-manage-apiops-cli
Safely version and roll out MCP servers	https://learn.microsoft.com/en-us/azure/api-management/mcp-server-versions

Azure API Management

File contents

Azure API Management Skill

How to Use This Skill

Category Index

Troubleshooting

Best Practices

Decision Making

Architecture & Design Patterns

Limits & Quotas

Security

Configuration

Integrations & Coding Patterns

Deployment

Frequently asked questions

Azure API Management

File contents

Azure API Management Skill

How to Use This Skill

Category Index

Troubleshooting

Best Practices

Decision Making

Architecture & Design Patterns

Limits & Quotas

Security

Configuration

Integrations & Coding Patterns

Deployment

Related skills

Frequently asked questions

How do I install the Azure API Management skill?

What does the Azure API Management skill do?

Is Azure API Management safe to use?

Which AI agents work with Azure API Management?

Is Azure API Management free to use?

Who published Azure API Management?