Learn about the philosophy of Azure versioning and the process and tools we use to avoid breaking changes.

Learn how Cadl and Kiota were used together to model the Mastodon API and generate a working Mastodon client.

This blog post describes the new Cadl API design language and its benefits for API authoring.

Developers hate waiting, but sometimes it's necessary. When we know something is going to take time in Azure, it's modeled as a long-running operation (LRO). We've recently updated our guidance on LROs in our REST API guidelines.

APIs are our contracts with developers. This post will introduce you to how we approach defining and managing API definitions in Azure.

Providing APIs that are easy to use, fit to purpose, scalable, maintainable, and consistent make the difference between success and failure for your software. The guidelines help Microsoft engineering teams, and others building REST services, create APIs that are approachable, sustainable, and consistent.