# Microsoft REST API Guidelines

**Canonical:** https://apis.io/apis/style-guides/microsoft/  
**Provider:** API Style Guides — https://apis.io/providers/style-guides/  
**Base URL:** https://raw.githubusercontent.com/microsoft/api-guidelines/vNext/  
**Documentation:** https://github.com/microsoft/api-guidelines

Microsoft REST API Guidelines is one of 11 APIs that [API Style Guides](https://apis.io/providers/style-guides/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include REST, Microsoft, Azure, Microsoft Graph, and OData. The published artifact set on APIs.io includes a GitHub repository.

Microsoft's organization-wide REST API design guidelines, originally published in 2016 and now maintained as separate Azure and Microsoft Graph guideline documents under the umbrella Guidelines.md. Licensed CC BY 4.0 to encourage adoption beyond Microsoft.

## Machine-readable artifacts (7)

- **StyleGuide** — https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md
- **AzureStyleGuide** — https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md
- **GraphStyleGuide** — https://github.com/microsoft/api-guidelines/blob/vNext/graph/GuidelinesGraph.md
- **License** — https://github.com/microsoft/api-guidelines/blob/vNext/license.txt
- **GitHubRepository** — https://github.com/microsoft/api-guidelines
- **Scope**
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/style-guides/refs/heads/main/apis.yml

## Other API Style Guides APIs (10)

- [Google API Improvement Proposals (AIPs)](https://apis.io/apis/style-guides/google-aip/)
- [Zalando RESTful API and Event Guidelines](https://apis.io/apis/style-guides/zalando/)
- [PayPal API Design Guidelines](https://apis.io/apis/style-guides/paypal/)
- [adidas API Guidelines](https://apis.io/apis/style-guides/adidas/)
- [Cisco REST API Design Guide](https://apis.io/apis/style-guides/cisco/)
- [Atlassian REST API Design Guidelines](https://apis.io/apis/style-guides/atlassian/)
- [Heroku Platform API Design Conventions](https://apis.io/apis/style-guides/heroku/)
- [GitLab API Style Guide](https://apis.io/apis/style-guides/gitlab/)
- [Kubernetes API Conventions](https://apis.io/apis/style-guides/kubernetes/)
- [IETF HTTPAPI Working Group Drafts and RFCs](https://apis.io/apis/style-guides/ietf-httpapi/)

## Tags

REST, Microsoft, Azure, Microsoft Graph, OData

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/style-guides/microsoft/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/style-guides/.