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: 2 October 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 Builder Mark Randall Local-first workspace for exploring and editing Arazzo documents, with graph, sequence, and YAML views.
- 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.
- API Flows Viewer Beppe Catanese Browser viewer for Arazzo workflows: paste a document or enter its URL to check its steps, parameters, and outputs.
- 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.
- WSO2 Arazzo Tools WSO2 VS Code extension with a visual designer, plus utilities for executing, visualising, and validating workflows.
- Arazzo plugin for JetBrains IDEs Pavel Bodiachevskii Arazzo support for IntelliJ IDEA, Android Studio, and other JetBrains IDEs: live JSON Schema validation, autocompletion, and an interactive preview.
- Arazzo for VS Code ConnEthics Author, visualise, and validate Arazzo workflows in VS Code, with live preview, flowchart diagrams, and real-time validation.
- Arazzo Playground ConnEthics Browser playground for editing Arazzo workflows in a Monaco editor, with interactive diagrams and Mermaid export.
- Arazzo Tools Apidog Browser tool for visualising and analysing Arazzo documents, with an editor, a diagram generator, and a table viewer.
- arazzo2mermaid Haine Lightweight Rust CLI that converts Arazzo workflows into Mermaid diagrams.
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.
- Spectral Arazzo Rules Stoplight Reference for every rule in the built-in spectral: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.
- arazzo-maestro Emmanuel Peru Lints, views, and tests Arazzo workflows from a single Go binary.
- ROAS GitHub Action Sergey Vilgelm GitHub Action that validates Arazzo, OpenAPI, Overlay, and AsyncAPI documents in CI with the ROAS crates.
Run & test
- arazzo-exec llotosl SDK and CLI that parses, validates, inspects, and runs Arazzo workflows, with custom extension points.
- 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.
- Bump.sh CLI Bump.sh Deploys an Arazzo workflow document to a Bump.sh hosted MCP server from the command line or CI.
- arazzo (Rust) Alireza Ghias Rust implementation of the specification: parse, validate, plan, and execute API workflows.
- Arazzo-Runner JaredCE Runs Arazzo workflows from Node.js; published on npm as arazzo-runner.
- Loom Imminent Technology Workflow engine and CLI for Arazzo 1.1 documents that resolves step dependencies into a DAG and runs independent steps in parallel.
- restish-plugin-arazzo Natalie Perret Adds a workflow run command to Restish that executes Arazzo 1.0.x documents across existing Restish API profiles.
- absolutejs/arazzo absolutejs Arazzo 1.1 workflow discovery, validation, dependency planning, and policy-aware execution for AI agents.
- Context Mesh Engine Mevan Samaratunga Go engine that turns governed Arazzo workflow plans into MCP tools for agents and a REST API for everyone else.
- cuerdo Ignacio Goldchluk Property-based testing for Arazzo workflows in Elixir. Alpha.
- arazzo-go Interface 7 Command-line runner for Arazzo 1.0.1 workflows in Go, with a cookie jar so sessions persist across steps.
- Arazzo Proof Runner Bine Divyesh Runs a multi-step workflow against a chosen environment and writes a redacted proof bundle with JSON and HTML reports.
- Itarazzo Client leidenheit Container-based execution of Arazzo workflow tests with the Itarazzo library.
- ROAS Sergey Vilgelm Rust libraries and a CLI for OpenAPI, AsyncAPI, Overlay, and Arazzo: parsed into typed Rust, validated, converted between versions, and, for Arazzo, executed.
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.
- Arazzo MCP Generator WSO2 Generates a Dockerised MCP server from an Arazzo document, with validation, inspection, and visualisation utilities built in.
- arazzo-to-flower Bump.sh Ruby gem that transforms Arazzo workflow files into Bump.sh's Flower workflow format.
- arazzo-codegen Pushkar Sinha CLI that reads an Arazzo document and generates a fully wired Spring Boot orchestration project.
- serverless-arazzo-workflows JaredCE Serverless Framework plugin that documents your API workflows with Arazzo; published on npm.
Libraries & SDKs
- arazzo-rs Pactflow Rust crates with models for the objects described in the Arazzo specification.
- 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.
- libopenapi pb33f Go parser, validator, and toolkit for OpenAPI, Overlay, and Arazzo documents.
- OpenAPI Arazzo for .NET BinkyLabs Arazzo implementation for .NET, compatible with Microsoft.OpenAPI, for parsing and building documents.
- OpenAPI Workflow Parser API Flows Java library that parses Arazzo documents in JSON or YAML into an object model.
- JArazzo Pavel Bodiachevskii Code-first Java models for Arazzo 1.0.1, with Jackson serialisation and deserialisation.
- arazzo (Go) OpenUdon Go library for parsing, validating, and generating Arazzo 1.0 documents.
- arazzo-parser (PHP) Hunter Skrasek Parses Arazzo documents into plain PHP objects.
Articles
Blog posts, tutorials, guides, and announcements about Arazzo.
- The Architectural Limits of Agentic iPaaS Bruno Pedro · Sep 2026 Argues AI-driven integrations need deterministic workflow engines, with Arazzo documents defined and validated before the first run.
- Arazzo Is Adding SOAP, and the Pull Request Needs Two Approvals Kin Lane · Sep 2026 Walks through the pull request that adds a WSDL source description type and an operationName field so Arazzo 1.2 steps can call SOAP operations.
-
Generate Arazzo Workflows with AI
Dmytro Ananskyi, Redocly · Sep 2026
Covers the
--with-aioption of Redocly CLI'sgenerate-arazzo, which turns a mechanical skeleton into workflows that read like real API usage. - The Deterministic Integration Layer Is Being Built From Both Ends Kin Lane · Sep 2026 Argues multi-provider integrations should be generated Arazzo artifacts rather than sequences an agent improvises at run time.
- 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 MCP Layer Is Being Built Outside the Contract Kin Lane · Aug 2026 Shows that a single-step Arazzo workflow with inputs is already an MCP saved query, and that the two layers are being built apart.
- 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.
- Stedi and EDI as Modern API Workflows Kin Lane · Jul 2026 Maps Stedi's clearinghouse API as Arazzo workflows, including the professional claim lifecycle from 837 submission through 277 status to 835 remittance.
- Availity and the X12 Administrative Workflows Kin Lane · Jul 2026 Describes Availity's eligibility, claim, and remittance transactions as Arazzo workflows over its X12-backed API.
- Ribbon Health and the Provider Directory Workflow Kin Lane · Jul 2026 Turns Ribbon Health's provider directory lookups into a multi-step Arazzo workflow.
- DrChrono and the Clinical Day as Workflows Kin Lane · Jul 2026 Follows a clinical day through DrChrono's API, scheduling to charting, as a set of Arazzo workflows.
- Medplum and FHIR as a Developer Backend Kin Lane · Jul 2026 Maps Medplum's FHIR-native backend as Arazzo workflows a developer would actually run.
- Metriport and the Asynchronous Document Query Kin Lane · Jul 2026 Shows how Arazzo makes Metriport's asynchronous document query explicit where endpoint-by-endpoint docs hide it, with real operationIds throughout.
- Health Gorilla and the Lab Order to Result Loop Kin Lane · Jul 2026 Describes Health Gorilla's lab order to result round trip as an Arazzo workflow.
- Cerner Oracle Health and the SMART on FHIR Sequence Kin Lane · Jul 2026 Writes the SMART on FHIR launch and data sequence against Oracle Health as an Arazzo workflow.
- 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.
- Canvas Medical and the Shape of an EHR FHIR Workflow Kin Lane · Jun 2026 Maps a Canvas Medical EHR session as Arazzo workflows over its FHIR API.
- Mapping Particle Health Record Retrieval as Arazzo Workflows Kin Lane · Jun 2026 Opens a ten-post series that maps one healthcare API a day as Arazzo workflows, each built from real operationIds in the provider's OpenAPI.
- 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.
- Arazzo 1.1 Release Dmytro Ananskyi, Redocly · May 2026 What 1.1 adds: AsyncAPI support, workflow composition, selectors, identity-based references, and clearer runtime behavior.
- OpenAPI Arazzo & Overlay: Workflows and Spec Management Zuplo · Apr 2026 Where Arazzo and Overlay fit around the core OpenAPI specification.
- Announcing Arazzo Editor Frank Kilcommins, Jentic · Apr 2026 Introduces the browser-based editor: form-based editing with a live diagram, and a code editor that stays in sync.
- Arazzo 1.0: Multi-Step API Workflows Spec APIScout · Mar 2026 General-audience explainer of what Arazzo adds on top of OpenAPI for sequencing multi-step calls.
- 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.
- Arazzo: The Cheat Sheet Yoan Gross, Bump.sh · Jan 2026 One-page reference to the objects and fields of Arazzo 1.0.1.
- Mastering API Workflows in Go: A Deep Dive into Arazzo Peter Bi · Dec 2025 Walks through parsing, validating, and generating Arazzo documents from Go.
- How Arazzo Could Help MCP Servers Orchestrate APIs for AI Consumers Janet Wagner, Nordic APIs · Nov 2025 Argues Arazzo gives MCP servers a deterministic way to sequence the API calls behind a tool, and names the adoption challenges.
- Building Reliable API Workflows with Arazzo Rod Rivera, Jentic · Sep 2025 Recap of an AMA on how Arazzo handles multi-step workflows that OpenAPI alone cannot, with implementation examples and migration strategies.
- 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 Rise of AI Agents: How Arazzo Is Defining the Future of API Workflows Frank Kilcommins, The New Stack · Feb 2025 Makes the case that structured Arazzo workflows are what let AI agents use APIs efficiently and predictably.
- The Arazzo Specification: A Deep Dive Frank Kilcommins · Feb 2025 Long-form walkthrough of the specification by one of its editors.
- 5 Potential Use Cases for Arazzo Bill Doerrfeld, Speakeasy · Jan 2025 Five places Arazzo could earn its keep: deterministic AI, multi-endpoint SDKs, authorization flows, end-to-end testing, and unified APIs.
- We Need FHIR API Arazzo Workflows to Deliver Real-World Healthcare Experiences Kin Lane · Nov 2024 Makes the case for describing FHIR interactions as Arazzo workflows instead of leaving the sequencing to every integrator.
- Supercharge Your API Testing with Arazzo and Itarazzo-Client leidenheit · Nov 2024 Sets up Itarazzo with Docker Compose and runs an Arazzo workflow as an automated API test, by the tool's author.
- End-to-end API testing with Arazzo, TypeScript, and Deno Brian Flad, Speakeasy · Oct 2024 Builds a generator that turns an Arazzo document into executable end-to-end tests. The companion repository is under Examples.
- 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.
- The JSON Schema for the Arazzo Specification Kin Lane · Oct 2024 A look at the specification's JSON Schema and what it does and does not let you check about a document.
- Spectral Governance for Arazzo and API Workflows Frank Kilcommins, Stoplight · Sep 2024 Announces the built-in Arazzo ruleset in Spectral for linting workflow documents alongside OpenAPI and AsyncAPI.
- 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.
- What is the Arazzo Specification? J Simpson, Nordic APIs · Jul 2024 Early explainer of how Arazzo describes API workflows, and what that means for developer experience and AI interoperability.
- 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.
- Meeting Orchestration Needs with Arazzo OpenAPI Initiative · May 2024 The OpenAPI Initiative's announcement of Arazzo 1.0.0.
- What is Arazzo? Redocly Start of Redocly's eleven-part learning guide to Arazzo: basics, workflows and steps, source descriptions, success criteria, linting, and testing.
- 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.
- Arazzo Specification Complete Guide Phil Sturgeon, Bump.sh Step-by-step guide to the Arazzo 1.0 specification, from what it is to runtime expressions, with a cheat sheet.
- SDK Workflows liblab Tutorial on writing an Arazzo file and generating SDK methods for multi-step use cases with the liblab CLI.
Videos
Conference talks, podcasts, and screencasts about Arazzo.
- Making AI Agents Reliable Event-Driven API Consumers with Arazzo AsyncAPI · Sep 2026 AsyncAPI live stream on Arazzo 1.1's AsyncAPI source descriptions: workflows where an agent publishes to a queue, waits on a webhook, and correlates the async response.
- Beyond OpenAPI: API Workflows That AI Agents Can Actually Execute Apidays India 2026 (ConfEngine) · Sep 2026 Conference talk on why agents struggle with multi-step API calls and how Arazzo, including the 1.1 AsyncAPI support, gives them workflows to execute directly.
- 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.
- Arazzo Visual Editor MCP Registry Bruno Pedro · Nov 2025 Short demo of querying the official MCP registry from inside the Arazzo Visual Editor.
- 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.
- From REST to Events: API Workflow Testing & Mocking with a Single Arazzo Spec Naresh, Apidays India (ConfEngine) · Oct 2025 Apidays India talk on driving both mocks and tests across REST and event-driven steps from one Arazzo document.
- 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.
- Visual API Workflow Mocking and Testing with Specmatic and Arazzo API Specifications Specmatic · Aug 2025 Turns Arazzo documents into living contracts that drive Specmatic mocks and automated workflow tests.
- Test Drive Your Arazzo Workflows with Symplr.io Symplr Studio · Jul 2025 Two-minute tour of building, testing, and deploying Arazzo workflows in Symplr.
- 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.
- Slashfriday: Conectando Puntos, Arazzo y la Evolución de las APIs Rafa Granados and Alex Ortega, Slashmobility · Dec 2024 Hour-long introduction to the specification and how to define multi-step workflows with it. In Spanish.
- 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.
- Arazzo Specification GPT Frank Kilcommins, SmartBear · Nov 2024 Introduces a custom GPT trained on the Arazzo Specification for drafting and explaining workflow documents.
- The Arazzo Specification: A New Way to Describe API Workflows Nordic APIs · Oct 2024 Introduction to describing multi-step API workflows with Arazzo.
- Apidays London 2024: The Arazzo Specification Frank Kilcommins, Apidays · Oct 2024 Conference talk introducing the specification, from one of its editors.
- OpenAPI Initiative Hangout: Introducing the Arazzo Specification OpenAPI Initiative · Aug 2024 Hour-long community hangout walking through the newly released specification.
- 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.
- Stedi healthcare workflows Kin Lane, The API Evangelist Five Arazzo documents for Stedi's clearinghouse API: eligibility check, insurance discovery, claim status inquiry, provider enrollment, and the professional claim lifecycle from 837 submission to 835 remittance.
- Describing API Workflows with Arazzo Frank Kilcommins Sample solution that crafts use-case workflows from existing APIs and publishes them to a developer portal, using the Arazzo GPT, Spectral, VS Code, and Itarazzo.
- Arazzo examples spanning OpenAPI and AsyncAPI Frank Kilcommins The working examples behind the design of AsyncAPI support in Arazzo 1.1, mixing synchronous and asynchronous steps.
- Agent Skills, MCP, and Workflows demo Frank Kilcommins Three-act demo that moves from raw MCP tools to guided skills to deterministic Arazzo workflows.
- Open Payments Arazzo workflows Dekun Lab Arazzo 1.0.1 documents for the Open Payments API flows, from the Interledger Foundation SDK grant programme.
- Specmatic REST-to-events Arazzo sample Specmatic Companion repository to the Apidays India talk: one Arazzo document driving mocks and tests across REST calls and asynchronous events.
- Specmatic Arazzo sample Specmatic Three FastAPI microservices (Order API, BFF, and UUID API) tested as an Arazzo workflow with Specmatic.
- End-to-end testing with Arazzo Speakeasy Demo that generates end-to-end API tests from an Arazzo document with Deno.
- 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.
- API Management in Practice: Delivering at Scale with OpenAPI and Arazzo (workshop) Erik Wilde · Sep 2025 Exercises and materials from the API World 2025 workshop in Santa Clara.

