Arazzo Specification 1.1 Release
Blog post from Redocly
Arazzo Specification 1.1 enhances the way API workflows are described by incorporating real-world complexities they often entail, such as multiple APIs, events, retries, and shared data. This version introduces support for AsyncAPI descriptions alongside OpenAPI, enabling developers to describe workflows involving asynchronous behaviors like event publishing and message waiting. It also brings new features like the correlationId and timeout to manage event-driven workflows and allows for more efficient workflow composition through Action Objects, which enable workflow reuse. Additionally, the Selector Object is introduced for precise data extraction, and cross-document references are stabilized with the root-level $self URI. The update aligns with OpenAPI 3.2 by adding support for complex query strings and refines various technical aspects to improve predictability and reduce ambiguity for tool builders and users, ensuring that Arazzo remains focused on effectively describing how APIs collaborate to complete tasks.