Microsoft REST API Guidelines
The REST API design guidelines Microsoft uses internally, covering URL structure, HTTP methods and status codes, error formats, pagination, filtering, versioning and long-running operations, with companion guides for Azure and Microsoft Graph. They are useful as a concrete, opinionated checklist when designing your first real API. Some rules reflect Microsoft platform needs, so adopt the reasoning rather than every detail.
GitHub repo
Web Development
Microsoft
Intermediate
Free
The REST API design guidelines Microsoft uses internally, covering URL structure, HTTP methods and status codes, error formats, pagination, filtering, versioning and long-running operations, with companion guides for Azure and Microsoft Graph. They are useful as a concrete, opinionated checklist when designing your first real API. Some rules reflect Microsoft platform needs, so adopt the reasoning rather than every detail.
Ready to start?
Opens on Microsoft in a new tab.
Stuck on something specific?
Writing only gets you so far. If you want an answer to your situation rather than the general case, book a session and we will work through it together. Sessions are free for approved Sefism members, and a few slots open each week.
Follow along
New writing, resources and project ideas land here first.