A study of 85 open-source projects publishing OpenAPI specs found 95% lack breaking-change detection tools, yet 67% of projects that shipped consumer-visible breaking changes disclosed them clearly in release notes. The research discovered that most API maintainers communicate breaking changes responsibly despite the absence of automated compatibility gates.
Arazzo is a specification for documenting API workflows designed to make AI tools more reliable, but the spec lacks maturity. The article discusses how Arazzo addresses the need for orchestrated API chains in AI-driven systems and why the author's company developed an internal data model called Flower to bridge gaps in the current specification.