Arazzo Ecosystem
Every external Arazzo resource, in one place: the specification, tools, articles, videos, and examples in the wild.
Arazzo is the OpenAPI Initiative's specification for describing multi-step API workflows, and a real ecosystem is forming around it. This page keeps track: hand-curated, reviewed regularly, and open to submissions from any vendor.
Last reviewed: 28 August 2026 Submit a resource Subscribe to updates
Spec
The Arazzo Specification itself: published versions, JSON Schemas, the official examples, and where its development happens. The latest version is 1.1.0; most tooling still targets 1.0.1.
Specification versions
- Arazzo Specification 1.1.0 OpenAPI Initiative · May 2026 The current version. Adds AsyncAPI source descriptions; most tooling still targets 1.0.1.
- Arazzo Specification 1.0.1 OpenAPI Initiative · Jan 2025 The patch release of 1.0 and the version most tooling targets today.
- Arazzo Specification 1.0.0 OpenAPI Initiative · May 2024 The first release of the specification.
- Arazzo Specification, latest OpenAPI Initiative A permalink that always resolves to the newest published version.
JSON Schemas
- Arazzo 1.1 JSON Schema (iteration 2026-04-15) OpenAPI Initiative · Apr 2026 Structural validation only; the specification's semantic requirements need a validator on top.
- Arazzo 1.0 JSON Schema (iteration 2025-10-15) OpenAPI Initiative · Oct 2025 The newest schema iteration for 1.0.x documents.
Official examples
- Official Arazzo 1.0 examples OpenAPI Initiative · May 2024 Pet adoption, buy-now-pay-later, OAuth, and FAPI-PAR workflows, each alongside its OpenAPI source description.
- Official Arazzo 1.1 examples OpenAPI Initiative · May 2026 Currently one file: the AsyncAPI source description used by the 1.1.0 specification.
Participation
- OAI/Arazzo-Specification repository OpenAPI Initiative Where the specification is developed: issues, pull requests, and the community tooling list.
- Arazzo Special Interest Group OpenAPI Initiative How the SIG behind the specification works and how to take part.
- Getting involved with Arazzo OpenAPI Initiative The bi-weekly call, GitHub Discussions and issues, and the arazzo channel on the OpenAPI Slack, with the invite link.
Tools
Arazzo tooling grouped by the job you are trying to do. UseArazzo's own toolkit is deliberately absent; this page is for everyone else's.
Author & visualise
- Arazzo Editor Jentic Form-based editing with a live diagram of the workflow.
- Arazzo Editor Symplr Visualise, execute, and publish Arazzo workflows in the browser.
- Arazzo UI Jentic Renders workflows as interactive documentation with diagram and text views.
- API Flows Studio API-Flows Web application that loads and displays an Arazzo document.
- apitapviz Lorna Mitchell Renders Arazzo files as Markdown or Mermaid diagrams.
- Tapestry Imminent Technology Visual workflow builder for creating Arazzo API workflows with a drag-and-drop interface.
Lint & validate
- Redocly CLI Redocly Lints, bundles, and documents OpenAPI, AsyncAPI, and Arazzo.
- Spectral Stoplight JSON/YAML linter with an out-of-the-box Arazzo ruleset.
- Speakeasy OpenAPI Speakeasy Go packages and CLI for validating Arazzo, OpenAPI, and Overlay documents.
- Arazzo Validator Jentic JSON Schema validation plus semantic validation and linting.
Run & test
- php-arazzo Mohammed Alama Native Arazzo workflow engine for PHP and Laravel: parse, validate, and execute OpenAPI call sequences.
- Respect CLI Redocly Runs Arazzo workflows and checks schemas, status codes, and success criteria.
- Arazzo Runner Jentic Python engine that executes Arazzo workflows and individual OpenAPI calls.
- arazzo-cli Steve Trefethen Standalone workflow executor with a runtime engine, debugger, and MCP server.
- Itarazzo leidenheit Java library to parse, validate, and execute Arazzo documents.
- Specmatic Specmatic Authoring, generation, mocking, and testing of Arazzo workflows.
- HAPI MCP La Rebelion Labs Turns APIs and Arazzo workflows into MCP tools, avoiding custom MCP server code from scratch.
Generate & convert
- Arazzo Generator Jentic Analyses an OpenAPI description and proposes meaningful workflows.
- Arazzo-Generator JaredCE Generates Arazzo workflows from OpenAPI documents.
- arazzo2openapi Frank Kilcommins Converts Arazzo documents into OpenAPI documents with type inference.
- pyarazzo b-lab-io CLI that renders Arazzo into other formats such as Markdown or PlantUML.
Libraries & SDKs
- SpecLynx SpecLynx Parses, dereferences, resolves, and validates Arazzo alongside OpenAPI, AsyncAPI, Overlay, and JSON Schema.
- Arazzo Parser Jentic TypeScript/JavaScript parser for Arazzo 1.0.0 and 1.0.1 documents.
- Arazzo Resolver Jentic Resolves and dereferences Arazzo and OpenAPI documents.
- Arazzo Criterion SwaggerExpert / Vladimír Gorej (char0n) Parses, validates, and evaluates Arazzo Criterion Objects.
- Arazzo Runtime Expression SwaggerExpert / Vladimír Gorej (char0n) Parses, validates, and extracts Arazzo runtime expressions.
Articles
Blog posts, tutorials, guides, and announcements about Arazzo.
- Actor-in-the-Loop: A Much-Needed Arazzo Capability Frank Kilcommins · Aug 2026 Proposes native actor-in-the-loop support for Arazzo, letting a workflow pause and request input from a human or another agent mid-execution.
- I Counted the Arazzo Runners by Reading READMEs Kin Lane · Aug 2026 Recounts the Arazzo execution tools by digging into project directories instead of trusting README claims alone.
- The Tools That Actually Execute Your Arazzo Workflows Kin Lane · Aug 2026 Surveys the runtime engines that actually execute Arazzo workflows, as opposed to the many tools that only validate or visualize them.
- What is the Arazzo Specification and how does it relate to OpenAPI? Imminent Technology · Aug 2026 Full explanation of the Arazzo specification, with examples of workflow definitions and how it sits alongside OpenAPI.
- The one Arazzo condition no tool can evaluate safely Vladimír Gorej (char0n) · Jul 2026 How arazzo-criterion handles the one simple condition that mixes runtime expressions with its own comparison language, instead of pretending the ambiguity away.
- Arazzo Workflows Are Your New Integration Kin Lane · Jul 2026 Argues that integrations between APIs should be described as portable, machine-readable Arazzo workflows rather than built as one-off code.
- Arazzo as the Next-Layer Specification for Workflow Intent Across APIs Sebastien Andreo, B-Lab.io · Jun 2026 Argues Arazzo is the layer that turns individually documented operations into coherent business workflows.
- The Composability Gap: When Valid APIs Fail Real Workflows Sebastien Andreo, B-Lab.io · Jun 2026 Why individually valid APIs still fail as real workflows, and what OpenAPI alone cannot catch.
- OpenAPI Arazzo & Overlay: Workflows and Spec Management Zuplo · Apr 2026 Where Arazzo and Overlay fit around the core OpenAPI specification.
- Exposing Workflows as API Operations Bruno Pedro · Feb 2026 Uses Arazzo as the definition language for workflows that can be triggered remotely as their own API operations.
- Arazzo Specification, the Compiler of Agentic AI Sebastien Andreo, B-Lab.io · Feb 2026 Positions Arazzo as the compiler between unpredictable AI agents and critical API operations.
- Arazzo: The Missing Piece for AI-Assisted API Consumption Guillaume Pierson, Marmelab · Feb 2026 How describing call sequencing and data dependencies with Arazzo helps AI assistants generate correct client code.
- From Endpoints to Intent: Rethinking Agent API Workflows with Arazzo Frank Kilcommins · Aug 2025 Why structured Arazzo workflow definitions beat exposing individual API endpoints as isolated tools for agents.
- Arazzo and AI Agents: Your Essential Starter Guide Martin Buhr, Tyk · May 2025 Starter guide to how Arazzo lets AI agents execute complex business workflows through standardized, declarative API descriptions.
- The Arazzo Specification: A Deep Dive Frank Kilcommins · Feb 2025 Long-form walkthrough of the specification by one of its editors.
- Arazzo Specification: Revolutionizing API Documentation and Workflows Rafa Granados · Oct 2024 Recaps Frank Kilcommins' introduction to Arazzo and its use-case oriented, programmatically readable workflow documentation.
- Introducing Arazzo: Describe API Workflows with this extension to OpenAPI Phil Sturgeon, Bump.sh · Sep 2024 Introduction to chaining operations into workflows with inputs, outputs, and success criteria.
- Documenting API Workflows with Arazzo Bruno Pedro · Jun 2024 Introductory look at Arazzo as a standardized, machine- and human-readable way to document multi-step workflows, with examples and a presentation video.
- Improving Developer Experience with OpenAPI's Arazzo Workflow Specification Brandon Verzuu · Jun 2024 A tour of Arazzo's key features and how they improve developer experience.
- What is Arazzo? Redocly First chapter of Redocly's multi-part learning guide to Arazzo.
- Learn Arazzo by Example Redocly Walks through a time-travel themed API example to show how to define steps, inputs, parameters, outputs, and success criteria.
- Arazzo in OpenAPI best practices Speakeasy Reference guide to the shape of an Arazzo document, object by object.
- What is Arazzo Workflow Specification? Workflows Guru Tutorial covering the structure and validation of Arazzo documents.
Videos
Conference talks, podcasts, and screencasts about Arazzo.
- Arazzo vs Traditional Chatbots: What Actually Works? GitKraken · Mar 2026 Compares deterministic, Arazzo-driven workflows against typical chatbot-style agent interactions.
- Arazzo Editor: Build, Edit, and Review API Workflows Jentic · Mar 2026 Screencast tour of Jentic's Arazzo Editor for building and reviewing workflow documents.
- Arazzo UI: Visualize Arazzo Workflows Jentic · Mar 2026 Demo of Arazzo UI rendering an Arazzo document as an interactive, readable workflow diagram.
- From Arazzo to OpenAPI: Exposing Workflow APIs for Developers and AI Erik Wilde · Feb 2026 On exposing Arazzo workflows themselves back out as their own OpenAPI-described APIs.
- Apidays Paris 2025: Arazzo, Dress up Your API Ecosystem for the AI Revolution Apidays · Dec 2025 Conference talk positioning Arazzo as the workflow layer APIs need for the AI era.
- Beyond the Agent Hype: Why Arazzo and Workflows Matter for Predictable AI Nordic APIs · Dec 2025 Argues predictable, workflow-defined behavior through Arazzo beats open-ended agent improvisation.
- Using an MCP Tool Alongside OpenAPI Inside the Arazzo Visual Editor Bruno Pedro · Nov 2025 Demo combining an MCP tool with an OpenAPI source description inside the Arazzo Visual Editor.
- Arazzo Visual Editor Bruno Pedro · Nov 2025 Screencast introduction to a visual editor for authoring Arazzo documents.
- Arazzo Definition Editor Bruno Pedro · Nov 2025 Early look at editing an Arazzo document's structure directly in a dedicated definition editor.
- Arazzo and OpenAPI: Applying API First to Arazzo Workflows Erik Wilde · Nov 2025 Erik Wilde and Frank Kilcommins on exposing Arazzo workflows themselves as APIs, and what that would take.
- Accelerating Workflow Orchestration: Automated Code Gen Using Arazzo & MCP Kartik, Apidays India (ConfEngine) · Oct 2025 Apidays India talk on generating code automatically from Arazzo and MCP workflow descriptions.
- Is the Arazzo Engine the Missing Piece in Agentic Workflows? AI Product Engineer · Sep 2025 Asks whether the Arazzo Engine runner fills the missing execution layer for agentic workflows.
- Workflow Testing with OpenAPI and AsyncAPI Using Specmatic's Visual Arazzo Spec Authoring Specmatic · Sep 2025 Demo of authoring Arazzo specs visually in Specmatic to test workflows across OpenAPI and AsyncAPI.
- API Evangelist Conversation With Frank Kilcommins About the OpenAPI Arazzo Specification Kin Lane, The API Evangelist · Feb 2025 Conversation on how the specification came to be and how it keeps evolving inside the OpenAPI Initiative.
- Linting API Workflows: Working with Arazzo Descriptions Erik Wilde · Jan 2025 On linting Arazzo workflow descriptions to catch problems before they run.
- The Arazzo Specification: Unlocking Value for Humans and Machines Frank Kilcommins · Nov 2024 On the value Arazzo's workflow descriptions unlock for both people and tooling.
- The Arazzo Specification: A New Way to Describe API Workflows Nordic APIs · Oct 2024 Introduction to describing multi-step API workflows with Arazzo.
- OpenAPI for workflows? Meet Arazzo with Frank Kilcommins Zuplo · Jun 2024 Walkthrough of how Arazzo builds on OpenAPI to describe the layer above raw REST calls, with an AI angle.
- The Arazzo Specification: A Tapestry for API Workflows Apidays Helsinki & North · Jun 2024 The launch-era conference talk introducing the specification.
- Describing API Workflows: Introducing the Arazzo Specification Erik Wilde · May 2024 Early introduction to the Arazzo Specification and what it lets you describe.
Examples
Real Arazzo documents published in the wild. The specification's own examples live under Spec.
- Arazzo Workflows on APIs.io APIs.io A searchable directory of thousands of example Arazzo workflow documents, both provider-specific and cross-provider.
- jentic-public-apis workflows Jentic Hundreds of Arazzo workflow documents for real public APIs, organised by API provider.
- Petstore Order Workflow Jentic A live Arazzo 1.0.1 document: authenticate, find a pet, place and confirm an order against the Swagger Petstore API. The demo document behind Arazzo UI.
Other
Books, courses, newsletters, slide decks, infographics, and anything else that fits no other section.
- Arazzo 1.1: Required Properties and Workflows Explained (infographic) Kin Lane, The API Evangelist · Aug 2026 A one-page visual of the Arazzo 1.1 document shape, posted on LinkedIn.
- The Arazzo Specification: A Tapestry for API Workflows (slides) Frank Kilcommins · May 2024 Slide deck from the conference talk of the same name.
- openapi.tools, Arazzo collection APIs You Won't Hate The OpenAPI tooling directory filtered to tools with Arazzo support.
