DeveloperWeek 2025

Frank Kilcommins, SmartBear, Principal API Technical Evangelist

Take a hands-on approach to mastering Arazzo, the API workflow specification from the OpenAPI Initiative, designed to streamline how to describe, validate, and share multi-step API interactions. This session cuts through the noise, giving you the tools and techniques needed to create high-quality workflow documents for real-world applications. We start with a breakdown of the Arazzo Specification structure and how it simplifies API workflows into reusable, programmatically readable formats. See Arazzo Specification GPT in action, accelerating the creation of Arazzo Documents and workflows with AI-driven precision. Dive into VSCode for hands-on editing, and how to validate and lint Arazzo Documents using Spectral. Learn how to create custom Spectral rules to enforce your team’s style guide, ensuring your documents are consistent and maintainable. You get tools, tips, and confidence to start your Arazzo journey, enabling you to weave together the use cases that enhance both human understanding and machine usability of your APIs.