>_SkillsHub▋

> azure-api-management

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 Azure services/LLMs, configuring policies/quotas, securing gateways, or deploying self-hosted gateways, and other Azure API Management related development tasks. Not for Azure Application Gateway (use azure-application-gateway), Azur

fetch
$curl "https://skillshub.wtf/MicrosoftDocs/Agent-Skills/azure-api-management?format=md"
SKILL.md•azure-api-management

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

CategoryLinesDescription
TroubleshootingL37-L46Diagnosing and fixing APIM issues: policies and error handling, request tracing/debugging, custom domain/Key Vault cert failures, SNAT timeouts, portal problems, and using Diagnose and Solve.
Best PracticesL47-L56Best practices for caching, throttling/quotas, self-hosted gateway on Kubernetes, server-sent events, and securing APIs against OWASP API Top 10 in Azure API Management
Decision MakingL57-L77Guidance for strategic APIM decisions: choosing tiers, scaling and costs, networking, DevOps/CI-CD, migrations (portals, workspaces, APIs, AWS), analytics/monitoring, and monetization.
Architecture & Design PatternsL78-L84Patterns for placing API Management behind App Gateway/WAF, Azure Front Door, or AKS, including routing, security, and high‑availability reference architectures.
Limits & QuotasL85-L105Policies and limits for request rates, quotas, concurrency, tokens (incl. Azure OpenAI/LLMs), protocol formats (OpenAPI/WSDL/WADL), validation rules, WebSocket, and self-hosted gateway.
SecurityL106-L146Securing API Management and its portals: authN/Z (Entra ID, B2C, OAuth2, JWT, certs, managed identity), TLS/certs, private access, DDoS/Defender, policies, and self-hosted gateway security.
ConfigurationL147-L246Configuring Azure API Management behavior: policies, caching, logging/metrics, networking/VNet, domains, credentials, subscriptions/users, self-hosted gateways, and deployment templates.
Integrations & Coding PatternsL247-L277Patterns and samples for integrating API Management with external APIs, LLMs, logging/monitoring, OAuth, MCP, and Azure services (Event Hubs, Service Bus, App Service, Service Fabric).
DeploymentL278-L297Deploying and scaling API Management: multi-region, VNet and zone setups, self-hosted gateways (AKS/K8s/Docker/Arc), backup/restore, migration, and automation of operations/portal.

Troubleshooting

TopicURL
Handle errors using Azure API Management policy featureshttps://learn.microsoft.com/en-us/azure/api-management/api-management-error-handling-policies
Trace and debug API requests in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-api-inspector
Fix API Management custom domain failures with Key Vault certificateshttps://learn.microsoft.com/en-us/azure/api-management/api-management-troubleshoot-cannot-add-custom-domain
Developer portal FAQ and troubleshooting for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-faq
Use Diagnose and Solve Problems for Azure API Management APIshttps://learn.microsoft.com/en-us/azure/api-management/diagnose-solve-problems
Troubleshoot SNAT port exhaustion and timeouts in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/troubleshoot-response-timeout-and-errors

Best Practices

TopicURL
Configure response caching for APIs in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache
Implement custom key-based caching in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-sample-cache-by-key
Implement advanced throttling and quotas in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-sample-flexible-throttling
Run API Management self-hosted gateway on Kubernetes in productionhttps://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 APIshttps://learn.microsoft.com/en-us/azure/api-management/how-to-server-sent-events
Mitigate OWASP API Top 10 threats with API Managementhttps://learn.microsoft.com/en-us/azure/api-management/mitigate-owasp-api-threats

Decision Making

TopicURL
Use API Management capacity metrics for scaling decisionshttps://learn.microsoft.com/en-us/azure/api-management/api-management-capacity
Choose the right Azure API Management tierhttps://learn.microsoft.com/en-us/azure/api-management/api-management-features
Transition from built-in API Management analytics dashboard to Azure Monitorhttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/analytics-dashboard-retirement-march-2027
Migrate Azure API Management ARM API versions before retirementhttps://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 Managementhttps://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 Managementhttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/git-configuration-retirement-march-2025
Migrate from legacy to new API Management developer portalhttps://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 workspaceshttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/workspaces-breaking-changes-march-2025
Choose alternative approaches for self-hosting API portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-alternative-processes-self-host
Plan DevOps and CI/CD pipelines for Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/devops-api-development-templates
Migrate Amazon API Gateway workloads to Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/migrate-amazon-api-gateway-to-api-management
Use API Management features to support API monetizationhttps://learn.microsoft.com/en-us/azure/api-management/monetization-support
Plan and manage Azure API Management costshttps://learn.microsoft.com/en-us/azure/api-management/plan-manage-costs
Upgrade and scale Azure API Management tiers and unitshttps://learn.microsoft.com/en-us/azure/api-management/upgrade-and-scale
Understand and select Azure API Management v2 tiershttps://learn.microsoft.com/en-us/azure/api-management/v2-service-tiers-overview
Choose and configure virtual network options for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/virtual-network-concepts

Architecture & Design Patterns

TopicURL
Front internal API Management with Application Gateway and WAFhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-integrate-internal-vnet-appgateway
Use API Management with AKS microservices architectureshttps://learn.microsoft.com/en-us/azure/api-management/api-management-kubernetes
Front Azure API Management with Azure Front Doorhttps://learn.microsoft.com/en-us/azure/api-management/front-door-api-management

Limits & Quotas

TopicURL
API format support restrictions for OpenAPI, WSDL, and WADLhttps://learn.microsoft.com/en-us/azure/api-management/api-management-api-import-restrictions
Enforce Azure OpenAI token rate and quota limits in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-token-limit-policy
Import SOAP APIs and handle WSDL restrictions in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/import-soap-api
Limit concurrent request execution in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/limit-concurrency-policy
Limit LLM token usage with API Management policieshttps://learn.microsoft.com/en-us/azure/api-management/llm-token-limit-policy
Configure quota-by-key policy for per-key limitshttps://learn.microsoft.com/en-us/azure/api-management/quota-by-key-policy
Configure quota policy for call and bandwidth limitshttps://learn.microsoft.com/en-us/azure/api-management/quota-policy
Configure per-key rate limiting in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/rate-limit-by-key-policy
Configure rate-limit policy to throttle API callshttps://learn.microsoft.com/en-us/azure/api-management/rate-limit-policy
Convert SOAP WSDL APIs to REST in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/restify-soap-api
Understand support policies and limitations for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-support-policies
Understand and work within Azure API Management service limitshttps://learn.microsoft.com/en-us/azure/api-management/service-limits
Validate request and response bodies with validate-content policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-content-policy
Validate response headers with validate-headers policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/validate-headers-policy
Validate request parameters with validate-parameters policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/validate-parameters-policy
Validate HTTP status codes with validate-status-code policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-status-code-policy
WebSocket API limits and configuration in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/websocket-api

Security

TopicURL
Configure authentication and authorization for LLM APIs in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-authenticate-authorize-ai-apis
Authorize API Management developer portal with Microsoft Entra IDhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-aad
Configure API Management developer portal with Azure AD B2Chttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-aad-b2c
Add and manage custom CA certificates in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-ca-certificates
Manage API Management developer access using groupshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-groups
Configure TLS protocols and cipher suites in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-manage-protocols-ciphers
Secure API Management backends with client certificate authenticationhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-mutual-certificates
Secure API Management front-end access with client certificate authenticationhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-mutual-certificates-for-clients
Configure OAuth 2.0 auth for API Management test consolehttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-oauth2
Protect APIs in API Management using OAuth 2.0 with Microsoft Entra IDhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-protect-backend-with-aad
Configure managed identities for Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-use-managed-service-identity
Configure RBAC roles for Azure API Management access controlhttps://learn.microsoft.com/en-us/azure/api-management/api-management-role-based-access-control
Configure Microsoft Entra applications for product-level OAuth accesshttps://learn.microsoft.com/en-us/azure/api-management/applications
Use authentication-basic policy to secure backend calls in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/authentication-basic-policy
Use authentication-certificate policy for client certificate auth in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/authentication-certificate-policy
Configure authentication-managed-identity policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy
Migrate API Management identity providers from ADAL to MSALhttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/identity-provider-adal-retirement-sep-2025
Plan for suspension of API Management managed certificates for custom domainshttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/managed-certificates-suspension-august-2025
Configure custom domains and certificates for API Management endpointshttps://learn.microsoft.com/en-us/azure/api-management/configure-custom-domain
Set up basic authentication for API Management developer portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-basic-authentication
Configure CORS for API Management developer portal test consolehttps://learn.microsoft.com/en-us/azure/api-management/enable-cors-developer-portal
Retrieve authorization context with get-authorization-context policyhttps://learn.microsoft.com/en-us/azure/api-management/get-authorization-context-policy
Secure serverless APIs via API Management and Azure AD B2Chttps://learn.microsoft.com/en-us/azure/api-management/howto-protect-backend-frontend-azure-ad-b2c
Apply LLM content safety checks in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/llm-content-safety-policy
Protect API Management in VNets with Azure DDoS Protectionhttps://learn.microsoft.com/en-us/azure/api-management/protect-with-ddos-protection
Enable Defender for APIs protection in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/protect-with-defender-for-apis
Configure secure access to Azure API Management developer portalhttps://learn.microsoft.com/en-us/azure/api-management/secure-developer-portal-access
Secure inbound and outbound access to MCP servers in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/secure-mcp-servers
Apply Azure Policy regulatory compliance controls to API Managementhttps://learn.microsoft.com/en-us/azure/api-management/security-controls-policy
Configure authentication options for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-authentication-options
Configure access token authentication for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-default-authentication
Configure Microsoft Entra authentication for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-azure-ad
Enable workload identity authentication for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-workload-identity
Secure perimeter-protected backends with API Management and managed identityhttps://learn.microsoft.com/en-us/azure/api-management/using-network-security-perimeter
Validate Microsoft Entra tokens with validate-azure-ad-token policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-azure-ad-token-policy
Validate client certificates with validate-client-certificate policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-client-certificate-policy
Configure validate-jwt policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/validate-jwt-policy

Configuration

TopicURL
Configure external Redis-compatible cache for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache-external
Configure custom domain names for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-configure-custom-domain-gateway
Configure notifications and email templates in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-configure-notifications
Create and manage user accounts in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-or-invite-developers
Create and configure subscriptions in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-create-subscriptions
Retrieve and manage Azure API Management IP addresseshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-ip-addresses
Configure Azure Monitor logging for LLM APIs in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-llm-logs
Configure and use named values in API Management policieshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-properties
Configure delegation for user registration and subscriptions in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-setup-delegation
Configure Azure Monitor metrics and logs for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-use-azure-monitor
Reference index for Azure API Management policieshttps://learn.microsoft.com/en-us/azure/api-management/api-management-policies
Configure Azure OpenAI token metrics in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-emit-token-metric-policy
Enable and configure semantic caching for LLM APIs in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-enable-semantic-caching
Use semantic cache lookup for Azure OpenAI in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-semantic-cache-lookup-policy
Store Azure OpenAI responses in semantic cache via API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-semantic-cache-store-policy
Update network settings for API Management CAPTCHA endpoint changehttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/captcha-endpoint-change-sep-2025
Migrate from retired API Management legacy metrics to Requests metrichttps://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 gatewayshttps://learn.microsoft.com/en-us/azure/api-management/breaking-changes/trusted-service-connectivity-retirement-march-2026
Configure cache-lookup policy for response cachinghttps://learn.microsoft.com/en-us/azure/api-management/cache-lookup-policy
Configure cache-lookup-value policy for key-based cachinghttps://learn.microsoft.com/en-us/azure/api-management/cache-lookup-value-policy
Configure cache-remove-value policy to delete cached itemshttps://learn.microsoft.com/en-us/azure/api-management/cache-remove-value-policy
Configure cache-store policy to cache API responseshttps://learn.microsoft.com/en-us/azure/api-management/cache-store-policy
Configure cache-store-value policy for custom cache entrieshttps://learn.microsoft.com/en-us/azure/api-management/cache-store-value-policy
Configure check-header policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/check-header-policy
Configure choose policy for conditional logic in APIMhttps://learn.microsoft.com/en-us/azure/api-management/choose-policy
Configure multiple credential connections in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/configure-credential-connection
Configure API Management automatic service update settingshttps://learn.microsoft.com/en-us/azure/api-management/configure-service-update-settings
Configure CORS behavior with cors policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/cors-policy
Configure cosmosdb-data-source policy for GraphQL resolvershttps://learn.microsoft.com/en-us/azure/api-management/cosmosdb-data-source-policy
Configure identity providers for API Management credential managerhttps://learn.microsoft.com/en-us/azure/api-management/credentials-configure-common-providers
Use credential manager to store backend API credentialshttps://learn.microsoft.com/en-us/azure/api-management/credentials-overview
Understand credential manager OAuth 2.0 management and runtime flowshttps://learn.microsoft.com/en-us/azure/api-management/credentials-process-flow
Enable cross-domain access with cross-domain policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/cross-domain-policy
Extend API Management developer portal with custom functionalityhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-extend-custom-functionality
Configure Application Insights for API Management developer portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-integrate-application-insights
Integrate Google Tag Manager with API Management portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-integrate-google-tag-manager
Configure WordPress plugin for API Management developer portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-wordpress-plugin
Emit custom metrics from API Management to App Insightshttps://learn.microsoft.com/en-us/azure/api-management/emit-metric-policy
Configure CORS for API Management custom connectors in Power Platformhttps://learn.microsoft.com/en-us/azure/api-management/enable-cors-power-platform
Configure find-and-replace policy for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/find-and-replace-policy
Configure forward-request policy to call backendshttps://learn.microsoft.com/en-us/azure/api-management/forward-request-policy
Configure cloud metrics and logs for self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/how-to-configure-cloud-metrics-logs
Configure local metrics and logs for self-hosted gateway on Kuberneteshttps://learn.microsoft.com/en-us/azure/api-management/how-to-configure-local-metrics-logs
Create and configure workspaces in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/how-to-create-workspace
Configure http-data-source resolver policy for GraphQL APIshttps://learn.microsoft.com/en-us/azure/api-management/http-data-source-policy
Configure include-fragment policy for reusable APIM policieshttps://learn.microsoft.com/en-us/azure/api-management/include-fragment-policy
Inject Premium v2 API Management into a virtual networkhttps://learn.microsoft.com/en-us/azure/api-management/inject-vnet-v2
Configure outbound virtual network integration for API Management v2https://learn.microsoft.com/en-us/azure/api-management/integrate-vnet-outbound
Configure invoke-dapr-binding policy for external resourceshttps://learn.microsoft.com/en-us/azure/api-management/invoke-dapr-binding-policy
Configure IP filtering rules in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/ip-filter-policy
Configure json-to-xml policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/json-to-xml-policy
Configure jsonp policy for cross-domain API callshttps://learn.microsoft.com/en-us/azure/api-management/jsonp-policy
Emit LLM token consumption metrics from API Managementhttps://learn.microsoft.com/en-us/azure/api-management/llm-emit-token-metric-policy
Configure semantic cache lookup for LLM APIs in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/llm-semantic-cache-lookup-policy
Store LLM responses in semantic cache via API Managementhttps://learn.microsoft.com/en-us/azure/api-management/llm-semantic-cache-store-policy
Configure mock-response policy to simulate APIshttps://learn.microsoft.com/en-us/azure/api-management/mock-response-policy
Configure monitoring and alerts for Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/monitor-api-management
Monitoring data reference for Azure API Management with Azure Monitorhttps://learn.microsoft.com/en-us/azure/api-management/monitor-api-management-reference
Create and reuse policy fragments in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/policy-fragments
Configure inbound private endpoint for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/private-endpoint
Configure proxy policy and HTTP proxy settings in APIMhttps://learn.microsoft.com/en-us/azure/api-management/proxy-policy
Configure publish-event policy for GraphQL subscriptionshttps://learn.microsoft.com/en-us/azure/api-management/publish-event-policy
Configure publish-to-dapr policy for APIM sidecar integrationhttps://learn.microsoft.com/en-us/azure/api-management/publish-to-dapr-policy
Deploy Azure API Management using ARM templateshttps://learn.microsoft.com/en-us/azure/api-management/quickstart-arm-template
Provision Azure API Management with Bicep templateshttps://learn.microsoft.com/en-us/azure/api-management/quickstart-bicep
Create Azure API Management with Terraform configurationhttps://learn.microsoft.com/en-us/azure/api-management/quickstart-terraform
Configure redirect-content-urls policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/redirect-content-urls-policy
Configure retry policy with conditions and counts in APIMhttps://learn.microsoft.com/en-us/azure/api-management/retry-policy
Configure return-response policy for custom API responseshttps://learn.microsoft.com/en-us/azure/api-management/return-response-policy
Configure rewrite-uri policy for Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/rewrite-uri-policy
Configure Azure Arc extension for API Management self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-arc-reference
Set self-hosted gateway container settings for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-settings-reference
Configure send-one-way-request policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/send-one-way-request-policy
Configure send-request policy with timeout settingshttps://learn.microsoft.com/en-us/azure/api-management/send-request-policy
Configure send-service-bus-message policy for Azure Service Bushttps://learn.microsoft.com/en-us/azure/api-management/send-service-bus-message-policy
Configure Dapr set-backend-service policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/set-backend-service-dapr-policy
Configure set-backend-service policy and backend entitieshttps://learn.microsoft.com/en-us/azure/api-management/set-backend-service-policy
Configure set-body policy for API Management requestshttps://learn.microsoft.com/en-us/azure/api-management/set-body-policy
Configure Azure API Management policies using the portal editorhttps://learn.microsoft.com/en-us/azure/api-management/set-edit-policies
Configure set-header policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/set-header-policy
Configure set-method policy for API Management requestshttps://learn.microsoft.com/en-us/azure/api-management/set-method-policy
Configure set-query-parameter policy in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/set-query-parameter-policy
Configure set-status policy for API Management responseshttps://learn.microsoft.com/en-us/azure/api-management/set-status-policy
Configure set-variable policy and context variables in APIMhttps://learn.microsoft.com/en-us/azure/api-management/set-variable-policy
Recover deleted Azure API Management instances with soft-deletehttps://learn.microsoft.com/en-us/azure/api-management/soft-delete
Configure sql-data-source policy for Azure SQL GraphQL resolvershttps://learn.microsoft.com/en-us/azure/api-management/sql-data-source-policy
Add custom trace entries in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/trace-policy
Validate GraphQL requests with validate-graphql-request policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-graphql-request-policy
Validate OData requests with validate-odata-request policyhttps://learn.microsoft.com/en-us/azure/api-management/validate-odata-request-policy
Meet virtual network resource requirements for API Management injectionhttps://learn.microsoft.com/en-us/azure/api-management/virtual-network-injection-resources
Configure VNet settings for API Management classic tiershttps://learn.microsoft.com/en-us/azure/api-management/virtual-network-reference
Configure virtual network requirements for API Management workspace gatewayshttps://learn.microsoft.com/en-us/azure/api-management/virtual-network-workspaces-resources
Configure wait policy for parallel execution in APIMhttps://learn.microsoft.com/en-us/azure/api-management/wait-policy
Configure xml-to-json policy in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/xml-to-json-policy

Integrations & Coding Patterns

TopicURL
Azure PowerShell sample scripts for Azure serviceshttps://github.com/Azure/azure-docs-powershell-samples
Import and manage Agent2Agent (A2A) agent APIs in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/agent-to-agent-api
Import Amazon Bedrock LLM passthrough APIs into API Managementhttps://learn.microsoft.com/en-us/azure/api-management/amazon-bedrock-passthrough-llm-api
Integrate Azure API Management with Application Insights logginghttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-app-insights
Send Azure API Management logs to Event Hubshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-log-event-hubs
Send messages to Azure Service Bus from API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-send-service-bus
Log API Management traffic to Event Hubs and Moesifhttps://learn.microsoft.com/en-us/azure/api-management/api-management-log-to-eventhub-sample
Use policy expressions in Azure API Management policieshttps://learn.microsoft.com/en-us/azure/api-management/api-management-policy-expressions
Call external HTTP services from API Management policieshttps://learn.microsoft.com/en-us/azure/api-management/api-management-sample-send-request
Import Azure OpenAI model APIs as REST in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/azure-openai-api-from-specification
Configure GraphQL field resolvers in Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/configure-graphql-resolver
Create managed Microsoft Graph connections via API Management credential managerhttps://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-azure-ad
Configure GitHub OAuth connections in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-github
Configure user-delegated OAuth connections in API Managementhttps://learn.microsoft.com/en-us/azure/api-management/credentials-how-to-user-delegated
Export Azure API Management APIs to Postman collectionshttps://learn.microsoft.com/en-us/azure/api-management/export-api-postman
Export Azure API Management APIs to Microsoft Power Platformhttps://learn.microsoft.com/en-us/azure/api-management/export-api-power-platform
Expose REST APIs as MCP servers via API Managementhttps://learn.microsoft.com/en-us/azure/api-management/export-rest-mcp-server
Connect and govern external MCP servers with API Managementhttps://learn.microsoft.com/en-us/azure/api-management/expose-existing-mcp-server
Configure Service Fabric services as API Management backendshttps://learn.microsoft.com/en-us/azure/api-management/how-to-configure-service-fabric-backend
Deploy API Management self-hosted gateway with OpenTelemetry on Kuberneteshttps://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-kubernetes-opentelemetry
Integrate Azure API Management events with Event Gridhttps://learn.microsoft.com/en-us/azure/api-management/how-to-event-grid
Import OpenAPI specifications into Azure API Managementhttps://learn.microsoft.com/en-us/azure/api-management/import-api-from-oas
Import Azure App Service web APIs into API Managementhttps://learn.microsoft.com/en-us/azure/api-management/import-app-service-as-api
Log API Management events to Azure Event Hubshttps://learn.microsoft.com/en-us/azure/api-management/log-to-eventhub-policy
Integrate Google Gemini OpenAI-compatible APIs with API Managementhttps://learn.microsoft.com/en-us/azure/api-management/openai-compatible-google-gemini-api
Import OpenAI-compatible LLM APIs into API Managementhttps://learn.microsoft.com/en-us/azure/api-management/openai-compatible-llm-api
Enable Dapr integration for API Management self-hosted gatewayhttps://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-enable-dapr

Deployment

TopicURL
Configure autoscale rules for Azure API Management instanceshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-autoscale
Deploy Azure API Management across multiple regionshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-deploy-multi-region
Backup and restore Azure API Management for disaster recoveryhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-disaster-recovery-backup-restore
Migrate Azure API Management instances between regionshttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-migrate
Provision gateway resources for self-hosted API Managementhttps://learn.microsoft.com/en-us/azure/api-management/api-management-howto-provision-self-hosted-gateway
Check regional availability of API Management v2 tiershttps://learn.microsoft.com/en-us/azure/api-management/api-management-region-availability
Deploy Azure API Management to an internal virtual networkhttps://learn.microsoft.com/en-us/azure/api-management/api-management-using-with-internal-vnet
Deploy Azure API Management to an external virtual networkhttps://learn.microsoft.com/en-us/azure/api-management/api-management-using-with-vnet
Automate deployment of API Management developer portal contenthttps://learn.microsoft.com/en-us/azure/api-management/automate-portal-deployments
Automate Azure API Management operations with Azure Automationhttps://learn.microsoft.com/en-us/azure/api-management/automation-manage-api-management
Self-host the Azure API Management developer portalhttps://learn.microsoft.com/en-us/azure/api-management/developer-portal-self-host
Enable availability zone support for API Managementhttps://learn.microsoft.com/en-us/azure/api-management/enable-availability-zone-support
Deploy API Management gateway as Azure Arc extensionhttps://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-azure-arc
Deploy API Management self-hosted gateway to AKShttps://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 Appshttps://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-container-apps
Deploy API Management self-hosted gateway to Dockerhttps://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-docker
Deploy API Management self-hosted gateway to Kubernetes with YAMLhttps://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-kubernetes

> related_skills --same-repo

> microsoft-foundry

Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with Azure OpenAI, vector search/RAG, Sora video, realtime audio, or MCP/LangChain APIs, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic),

> microsoft-foundry-tools

Expert knowledge for Microsoft Foundry Tools (aka Azure AI services, Azure Cognitive Services) development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Content Understanding analyzers, Content Moderator APIs, Foundry containers, VNet/Key Vault security, or Entra auth, and other Microsoft Foundry Tools related development tasks. Not for Microsoft Foundry (use micr

> microsoft-foundry-local

Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including troubleshooting, best practices, decision making, configuration, and integrations & coding patterns. Use when using Foundry Local CLI, chat/transcription APIs, tools, OpenAI/LangChain clients, or upgrading legacy SDKs, and other Microsoft Foundry Local related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foun

> microsoft-foundry-classic

Expert knowledge for Microsoft Foundry Classic (aka Azure AI Foundry classic) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with RAG, tools, evaluators, Azure OpenAI, VNet/Private Link, or CI/CD deployments, and other Microsoft Foundry Classic related development tasks. Not for Microsoft Foundry (use microsoft-foundry

┌ stats

installs/wk0
░░░░░░░░░░
github stars525
██████████
first seenMar 17, 2026
└────────────

┌ repo

MicrosoftDocs/Agent-Skills
by MicrosoftDocs
└────────────

┌ tags

#azure#security
└────────────