Azure REST API Specifications is a repository that serves as the canonical source for REST API specifications for Microsoft Azure services.
The repository addresses the need for a centralized, authoritative definition of Azure's REST APIs. It maintains specifications in both OpenAPI and TypeSpec formats, enabling consistent API design across Azure services and serving as the foundation for SDK generation and API reference documentation. The repository provides getting-started guides for both OpenAPI and TypeSpec specifications, along with example configurations for data plane and management plane (ARM) API structures that libraries should follow.
The tool is essential for Microsoft employees and teams building Azure SDKs, as it establishes the contract between API specifications and the generated client libraries across multiple programming languages. External contributors can participate by following the provided documentation for OpenAPI or TypeSpec specifications. The repository distinguishes itself by supporting both specification formats, allowing teams to choose the approach that fits their needs while maintaining consistency through shared structural patterns and examples.
The project maintains active engagement with both internal Microsoft teams and external contributors through documented processes and examples. The repository includes comprehensive getting-started documentation tailored to different specification formats and contributor types. Development activity reflects ongoing maintenance of a large, multi-format specification collection serving numerous Azure services and SDKs.
