Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 47 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

The Arazzo Specification is a community-driven open specification within the [OpenAPI Initiative](https://www.openapis.org/), a Linux Foundation Collaborative Project.

The Arazzo Specification defines a standard, programming language-agnostic mechanism to express sequences of calls and articulate the dependencies between them to achieve a particular outcome, or set of outcomes, when dealing with API descriptions (such as OpenAPI descriptions).
The Arazzo Specification defines a standard, programming language-agnostic mechanism to express sequences of calls and articulate the dependencies between them to achieve a particular outcome, or set of outcomes, when dealing with API descriptions (such as OpenAPI and AsyncAPI descriptions).

The Arazzo Specification can articulate these workflows in a deterministic human-readable and machine-readable manner, thus improving provider and consumer experiences when working with APIs. Similar to what OpenAPI has done for describing HTTP interfaces, the Arazzo Specification enables the ability to articulate the functional use cases offered by an API (or group of APIs) thus removing the guesswork for both human and machine consumers.

Expand All @@ -21,12 +21,57 @@ The Arazzo Specification does not mandate a specific development process such as

This GitHub project is the starting point for Arazzo. Here you will find the information you need about the Arazzo Specification, simple examples of what it looks like, and some general information regarding the project.

## Current Version - 1.0.1
## Current Version - 1.1.0

The latest version of the Arazzo Specification can be viewed at [Arazzo Specification - latest](https://spec.openapis.org/arazzo/latest.html).

![alt The Arazzo Specification Structure](./images/Arazzo-Specification-Structure.png)

## Tooling

The Arazzo ecosystem is growing with various tools to help you work with Arazzo descriptions:

### Editors, Design Tools, and Renderers

- **[Arazzo Editor (from Jentic)](https://jentic.com/arazzo-editor)** - Build and edit Arazzo workflows with form-based editing and real-time diagrammatic representation.
- **[Arazzo Editor (from Symplr)](https://arazzo-editor.symplr.io/)** - A tool that lets you visualize, execute & publish Arazzo workflows
- **[Arazzo UI](https://arazzo-ui.jentic.com/)** - Visualize Arazzo workflows as interactive documentation with diagram and documentation views.
- **[API Flows Studio](https://github.com/API-Flows/api-flows-studio)** - A web application that loads and displays an Arazzo Workflow Document.
- **[ApiTapVia](https://github.com/lornajane/apitapviz)** - Simple visualisation of OpenAPI Arazzo files as Markdown or mermaidjs.

### Generators

- **[Arazzo Generator (by @jentic)](https://github.com/jentic/arazzo-engine/tree/main/generator)** - A tool for analyzing OpenAPI specifications and generating meaningful Arazzo workflows by identifying logical API sequences and patterns.
- **[Arazzo Generator (by @JaredCE)](https://github.com/JaredCE/Arazzo-Generator)** - Generate Arazzo Workflows from your OpenAPI Documents.
Comment thread
frankkilcommins marked this conversation as resolved.

### Validation and Linting

- **[Arazzo Validator](https://github.com/jentic/jentic-arazzo-tools/tree/main/packages/jentic-arazzo-validator)** - A validator and linter for Arazzo Specification documents. It performs JSON Schema validation, semantic validation, and semantic linting.
- **[Redocly CLI](https://github.com/Redocly/redocly-cli)** - An all-in-one API documentation utility for working with OpenAPI, AsyncAPI, and Arazzo.
- **[Spectral](https://stoplight.io/spectral)** - Flexible OpenAPI/AsyncAPI/Arazzo linter for API governance and style guides.
- **[Speakeasy OpenAPI](https://github.com/speakeasy-api/openapi)** - OSS packages and CLI tools for validation, bundling, and working with Arazzo, OpenAPI, and Overlay documents.

### Parsers and Resolvers

- **[Arazzo Parser](https://github.com/jentic/jentic-arazzo-tools/tree/main/packages/jentic-arazzo-parser)** - TypeScript/JavaScript parser for Arazzo 1.0.0 and 1.0.1 documents.
- **[Arazzo Resolver](https://github.com/jentic/jentic-arazzo-tools/tree/main/packages/jentic-arazzo-resolver)** - TypeScript/JavaScript resolver and dereferencer for Arazzo and OpenAPI documents.
- **[Arazzo Runtime Expression](https://github.com/swaggerexpert/arazzo-runtime-expression)** - Arazzo Runtime Expressions parser, validator and extractor.
- **[Itarazzo](https://github.com/leidenheit/itarazzo-library)** - Library to parse, validate and execute an Arazzo specification.

### Workflow Execution and Testing

- **[arazzo-cli](https://strefethen.github.io/arazzo-cli/)** - Standalone Arazzo 1.0 workflow executor with runtime engine, debugger, and MCP server for AI agent integration.
- **[Arazzo Runner](https://github.com/jentic/arazzo-engine/tree/main/runner)** - A workflow execution engine that processes and executes API workflows defined in the Arazzo format and individual API calls defined in OpenAPI specifications.
- **[Respect CLI](https://redocly.com/respect-cli)** - A tool to run OpenAPI Arazzo workflows, identify gaps in schemas, status codes, and content types, and evaluate success criteria—all in one simple command
- **[Specmatic](https://specmatic.io/)** - Simplified Arazzo Authoring & API Workflow Testing.

### Converters

- **[arazzo2openapi](https://frankkilcommins.github.io/arazzo2openapi)** - Convert Arazzo workflow documents into OpenAPI documents with intelligent type inference.
- **[pyarazzo](https://github.com/b-lab-io/pyarazzo)** - A CLI to transform Arazzo specification into some other formats (e.g., Markdown, PlantUML).

For another comprehensive and up-to-date listing of Arazzo tooling, visit [openapi.tools](https://openapi.tools/?arazzo=true) and filter by Arazzo support.

Comment thread
frankkilcommins marked this conversation as resolved.
## See Arazzo in Action

If you just want to see it work, check out the [list of current examples](./examples/1.0.0/).
Expand Down
5 changes: 3 additions & 2 deletions SPECIAL_INTEREST_GROUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,15 +34,16 @@ The initial Workflows SIG was made up of the following individuals.

- David O'Neill ([COO, APIContext](https://www.linkedin.com/in/davidon/))
- Kin Lane ([API Governance Lead, Bloomberg](https://www.linkedin.com/in/kinlane/))
- Frank Kilcommins ([API Evangelist, SmartBear](https://www.linkedin.com/in/frank-kilcommins))
- Frank Kilcommins ([Head of Architecture, Jentic](https://www.linkedin.com/in/frank-kilcommins))

### Contributors

- Nick Denny ([Chief Engineer, APIContext](https://www.linkedin.com/in/nickdenny/))
- Frank Kilcommins ([API Evangelist, SmartBear](https://www.linkedin.com/in/frank-kilcommins))
- Frank Kilcommins ([Head of Architecture, Jentic](https://www.linkedin.com/in/frank-kilcommins))
- Mike Ralphson ([OpenAPI Specification Lead, Postman](https://www.linkedin.com/in/mikeralphson/))
- Alessandro Duminuco ([Senior Technical Leader, Cisco](https://www.linkedin.com/in/alessandroduminuco/))
- Mark Haine ([Founder, Considrd Consulting](https://www.linkedin.com/in/mark-haine/))
- Phil Sturgeon ([API Consultant](https://www.linkedin.com/in/philipsturgeon/))
- Kevin Duffey ([Tech Lead](https://www.linkedin.com/in/kmd/))
- Shai Sachs ([Staff Engineer, Chewy](https://linkedin.com/in/shaisachs/))
- Naresh Jain ([Founder/CEO, Specmatic](https://www.linkedin.com/in/nareshjain/))
Loading
Loading