The Arazzo Specification: A Tapestry for API Workflows.
summary
Arazzo defines a machine‑readable YAML/JSON format that strings OpenAPI sources into deterministic recipes of steps with inputs, outputs, success criteria and failure actions, for example retry after 1s up to 5 attempts or “goto” and “end” flows. It maps parameters to operationIDs or JSON Pointers, exposes workflow-level outputs, and stores reusable components. Demo uses pets and adoptions APIs, GPT-assisted generation that is about 80% initial accuracy, produces Markdown, PlantUML/mermaid, Swagger Hub artifacts and usable client code. Research notes 48%/43% confidence gaps.
AI-written summary · about
chapters (8)
- 0:00Arazzo Specification intro
- 1:06Why Arazzo was created
- 3:10API workflow challenges
- 6:20What Arazzo offers
- 8:25Arazzo structure
- 16:11Petco APIs example
- 19:02Arazzo tools demo
- 21:10Get involved with Arazzo
related talks
28mThe Arazzo Specification
18mArazzo: Dress up Your API Ecosystem for the AI Revolution!
24mGetting the Right API Faster
18mEnforcing API Standards for K8s CRDs at Scale using OpenAPI, Arazzo & Overlay
28mAPIs and OpenAPI in the Age of AI
38mZen And The Art Of Automanually Creating API Documentation - An Inquiry Into Process
35mOpensource API Tools to agile your apifirst strategy.
39mAPI Development in 2017