azure-api-center

Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when automating API linting/registration, synci

SKILL.md

GitHub

Azure Api Center Skill

This skill provides expert guidance for Azure Api Center. Covers best practices, 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

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.
  • Fallback: Use WebFetch. Returns Markdown.

Category Index

Category Lines Description
Best Practices L29-L34 Best practices for API governance in API Center: using managed linting for style compliance and applying shift-left checks via the VS Code extension.
Security L35-L40 Configuring API auth schemes (keys, OAuth, etc.) in API Center and managing portal access/permissions via the VS Code extension
Configuration L41-L51 Configuring and deploying Azure API Center: backup/restore, plugin marketplace endpoints, ARM/Bicep/CLI provisioning, and defining/customizing governance metadata schemas.
Integrations & Coding Patterns L52-L58 Patterns and scripts for syncing APIs between API Center and platforms like API Management, Amazon API Gateway, and Copilot Studio, plus automation via Azure CLI and Logic Apps/Teams
Deployment L59-L63 Automating API linting and registration to Azure API Center (e.g., via GitHub Actions) and instructions for self-hosting the Azure API Center portal.

Best Practices

Topic URL
Use managed linting to enforce API style compliance in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting
Apply shift-left API governance with VS Code extension https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension

Security

Topic URL
Configure API authorization schemes in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access
Control API Center portal access via VS Code extension https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension

Configuration

Topic URL
Configure backup and restore for Azure API Center https://learn.microsoft.com/en-us/azure/api-center/backup-restore
Configure Azure API Center plugin marketplace endpoint https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-plugin-marketplace
Configure metadata schema for Azure API Center governance https://learn.microsoft.com/en-us/azure/api-center/metadata
Create Azure API Center via ARM template https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template
Provision Azure API Center using Azure CLI https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli
Deploy Azure API Center with Bicep templates https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep
Define custom metadata schema in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties

Integrations & Coding Patterns

Topic URL
Import Azure API Management APIs into API Center https://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis
Script API Center inventory management with Azure CLI https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli
Automate API registration notifications with Logic Apps and Teams https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow

Deployment

Topic URL
Automate API linting deployment in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting
Automate API registration to API Center with GitHub Actions https://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions