SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-api-management

MicrosoftDocs

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 managing APIM policies/callouts, VNet and custom domains, self-hosted gateways, Entra ID/OAuth2 auth, or autoscale, 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).

globalRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
generated_at:2026-06-21
generator:docs2skills/1.0.0
New~9.3k
v1.0Saved Jun 26, 2026

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 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 Practices L46-L55 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 L56-L74 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 L75-L81 Patterns for placing API Management behind App Gateway/WAF, Azure Front Door, or AKS, including routing, security, and high‑availability reference architectures.
Limits & Quotas L82-L99 Limits, quotas, and validation rules in API Management: request/concurrency caps, per-key and bandwidth quotas, LLM token limits, SOAP/WSDL/WebSocket constraints, and validate-* policies.
Security L100-L141 Securing APIs and APIM: authN/Z (Entra ID, B2C, OAuth2, JWT, mTLS, basic), managed identities/RBAC, secure portals/self-hosted gateways, security policies, and DDoS/Defender protections.
Configuration L142-L235 Configuring Azure API Management services, policies, networking, caching, monitoring, domains, gateways, and developer portal behavior for runtime and operational control.
Integrations & Coding Patterns L236-L267 Patterns and samples for integrating API Management with external services (LLMs, Event Hubs, Service Bus, Graph, GitHub, Dapr), importing APIs (OpenAPI, SAP, web apps), and using policies/callouts.
Deployment L268-L286 Deploying and scaling API Management: autoscale, multi-region, DR/backup, VNet and zone deployment, self-hosted gateways (AKS/Kubernetes/Docker/Arc), automation, and certificate planning.

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
Troubleshoot SNAT port exhaustion and timeouts in Azure 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
Implement flexible throttling policies in API Management https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-flexible-throttling
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
Front internal API Management with Application Gateway and WAF https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-integrate-internal-vnet-appgateway
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
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 for call and bandwidth limits https://learn.microsoft.com/en-us/azure/api-management/quota-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 and work within Azure API Management service limits https://learn.microsoft.com/en-us/azure/api-management/service-limits
Validate request and response bodies with validate-content policy 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 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 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
Use authentication-certificate policy for client certificate auth in API Management https://learn.microsoft.com/en-us/azure/api-management/authentication-certificate-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
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
Retrieve authorization context with get-authorization-context policy 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
Configure llm-content-safety policy in API Management https://learn.microsoft.com/en-us/azure/api-management/llm-content-safety-policy
Protect API Management in VNets with Azure 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 tokens with validate-azure-ad-token policy https://learn.microsoft.com/en-us/azure/api-management/validate-azure-ad-token-policy
Validate client certificates with validate-client-certificate policy 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 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
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
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
Configure Azure API Management policies and gateways https://learn.microsoft.com/en-us/azure/api-management/api-management-policies
Configure internal VNet mode for Azure API Management https://learn.microsoft.com/en-us/azure/api-management/api-management-using-with-internal-vnet
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
Emit custom metrics from API Management to App Insights https://learn.microsoft.com/en-us/azure/api-management/emit-metric-policy
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
Configure include-fragment policy for reusable APIM policies 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 in API Management https://learn.microsoft.com/en-us/azure/api-management/llm-emit-token-metric-policy
Configure semantic cache lookup for LLM APIs in API Management 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
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
Monitoring data reference for Azure API Management with Azure Monitor https://learn.microsoft.com/en-us/azure/api-management/monitor-api-management-reference
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 Azure API Management rate-limit policy https://learn.microsoft.com/en-us/azure/api-management/rate-limit-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 API Management self-hosted gateway https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-arc-reference
Set self-hosted gateway container settings for API Management 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 send-service-bus-message policy for Azure Service Bus https://learn.microsoft.com/en-us/azure/api-management/send-service-bus-message-policy
Configure Dapr set-backend-service policy in API Management https://learn.microsoft.com/en-us/azure/api-management/set-backend-service-dapr-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 and context variables in APIM 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
Meet virtual network resource requirements for API Management injection 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 virtual network requirements for API Management workspace gateways 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 services as API Management backends 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
Log API Management events to Azure Event Hubs 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
Configure set-backend-service policy in API Management https://learn.microsoft.com/en-us/azure/api-management/set-backend-service-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 regional availability of 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 API Management managed certificate suspension 2025–2026 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
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

84/100

Grade

B

Good

Safety

88

Quality

85

Clarity

82

Completeness

78

Summary

This skill provides expert guidance for Azure API Management development, covering troubleshooting, best practices, architecture patterns, security, configuration, integrations, and deployment. It uses a structured category index with curated links to Microsoft Learn documentation and remote documentation fetching via MCP tools (preferred: mcp_microsoftdocs, fallback: fetch_webpage).

Detected Capabilities

documentation fetching (mcp_microsoftdocs, fetch_webpage)network access to learn.microsoft.com and github.comagent-guided reference lookups via read_fileindex-based documentation navigation

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure api managementapi gateway configurationapi policy troubleshootingazure apim securityapi rate limitingself-hosted gateway deploymentoauth2 api authenticationapi versioning strategy

Risk Signals

INFO

Remote documentation fetching via network tools (mcp_microsoftdocs, fetch_webpage)

Compatibility section
INFO

Network access requirement to Microsoft Learn and GitHub

How to Use This Skill section
INFO

Agent instructed to query remote documentation with 'from=learn-agent-skill' parameter

This skill requires network access section

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Diagnosing APIM policy failures, custom domain cert issues, SNAT timeouts, and request tracing
  • Implementing caching, throttling, and security best practices (OWASP API Top 10) for APIs
  • Planning API Management pricing, scaling, DevOps pipelines, and VNet configurations
  • Designing high-availability architectures with App Gateway, Front Door, or AKS
  • Understanding and enforcing API limits, quotas, and validation constraints
  • Securing APIs with authentication (Entra ID, B2C, OAuth2, JWT, mTLS) and authorization
  • Configuring policies, backends, caching, domains, and developer portal behavior
  • Integrating API Management with LLMs, Event Hubs, Service Bus, Microsoft Graph, and external services
  • Deploying and scaling API Management across regions, configuring autoscale and disaster recovery
  • Managing self-hosted gateways on Kubernetes, Docker, Azure Arc, or Container Apps

Quality Notes

  • Excellent documentation structure with comprehensive Category Index mapping topics to line ranges and descriptions
  • Clear, actionable agent instructions for documentation lookup (read_file for line ranges, read_file for linked files)
  • Well-organized reference tables with specific URLs for each topic, enabling targeted learning
  • Proactive guidance on skill freshness (3-month check) and tool installation instructions
  • Scope boundaries are explicit: clearly states what is NOT covered (App Service, Functions, Logic Apps, Service Bus)
  • Network access is clearly marked as required, with preferred and fallback tools documented
  • Metadata includes generation timestamp for freshness tracking
  • Comprehensive coverage across 8 major categories with 60+ specific topics and 180+ curated links
  • No local content files beyond frontmatter; skill is entirely documentation-indexed, reducing maintenance burden
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Add MicrosoftDocs/azure-api-management to your library

Get Started Free

Command Palette

Search for a command to run...