#Arazzo Editor is live! Build #API workflows with form-based editing + live diagrams. No YAML required (unless you want it).

Below, I cover why tooling matters for standards, and how Arazzo fits in the agent-ready orchestration picture.

jentic.com/blog/arazzo-editor

#OpenAPI @jentic.bsky.social

#ArazzoUI now supports local file upload and drag & drop.

Remote URL loading was there from day one, but this was the most requested community feature since launch.

Try it out: arazzo-ui.jentic.com
Learn more: jentic.com/product/araz...

#arazzo #openapi #apiworkflows #jentic

Released: 𝗔𝗿𝗮𝘇𝘇𝗼 𝗨𝗜: 𝗮𝗻 𝗼𝗽𝗲𝗻-𝘀𝗼𝘂𝗿𝗰𝗲 𝘁𝗼𝗼𝗹 𝗳𝗼𝗿 𝘃𝗶𝘀𝘂𝗮𝗹𝗶𝘇𝗶𝗻𝗴 𝗔𝗣𝗜 𝘄𝗼𝗿𝗸𝗳𝗹𝗼𝘄𝘀

Renders #Arazzo YAML/JSON as diagrams & docs. No setup required.

Review multi-step orchestration logic at a glance. Share workflows without asking teammates to parse raw YAML. See execution paths, not nested objects.

#OpenAPI

Picture of arazzo2openapi playground UI

Here's a little tool called 𝗮𝗿𝗮𝘇𝘇𝗼𝟮𝗼𝗽𝗲𝗻𝗮𝗽𝗶 that converts #Arazzo workflows into #OpenAPI

Lets your workflows become deployable to existing #API mgmt tooling

𝘾𝙝𝙚𝙘𝙠 𝙞𝙩 𝙤𝙪𝙩:
Playground: frankkilcommins.github.io/arazzo2openapi
NPM: www.npmjs.com/package/araz...
GitHub: github.com/frankkilcomm...

If you're still using the Serverless Framework and you're generation OpenAPI Documents form it, then you should also start creating Arazzo Workflows so you can test your API's.

Now you can with my new plugin: www.npmjs.com/package/serv...

#Arazzo #OpenAPI #Serverless #AWS

The “Agentic Sandbox” - A simulated environment that mirrors internal APIs and data systems, letting teams test agents safely, identify high-value use cases, and promote only validated workflows (as #Arazzo) to production capability registry.

jentic.com/blog/the-age...

𝙉𝙤 𝘼𝙄 𝙬𝙞𝙩𝙝𝙤𝙪𝙩 𝘼𝙋𝙄𝙨
I’ll speak at APIDays London (Sep 24) in the OpenAPI track; exploring how to capture intent and ensure we build the right APIs! I'll show how to use Example Mapping and pair AI with #OpenAPI/ #Arazzo to accelerate with purpose

Comp Tickets: ticket.apidays.global/event/apiday...

Why Do We Run the OAI Track? – OpenAPI Initiative

We are looking forward to the OAI Track - this time the OpenAPI Summit! - at API:World next week! Read our thoughts on what makes the OAI Track so important in bringing the #OpenAPI, #Arazzo, and #Overlay Specifications to the community.

www.openapis.org/blog/2025/08...

#api

API:World Santa Clara 2025 – OpenAPI Initiative

The agenda is out for the API World OAI Track, running Sept. 3 to 5, 2025.

Checkout the details on our events page: www.openapis.org/events/apiwo...

#api #openapi #arazzo #overlay

From Endpoints to Intent: Designing AI Agent Workflows with Arazzo and MCP AI agents are reshaping how software gets built and used. Learn how Arazzo and the Model Context Protocol (MCP) define scalable, deterministic, and interoperable API workflows that go beyond raw tool ...

MCP is changing how we expose #APIs to AI agents but mapping tools 1:1 to endpoints is fragile.

Context gets bloated.
Orchestration gets baked-in.
Interoperability gets lost.

In my latest blog, I suggest pairing #Arazzo + #MCP to counteract the challenges above!

👉 smartbear.com/blog/from-en...

Interested in OpenAPI and want to talk to experts who work on the specifications? Free at 1000 CEST Wednesday 13th August?

Come along to OpenAPI Office Hours, hosted by @lornajane.net!

zoom-lfx.platform.linuxfoundation.org/meetings/ope...

#api #openapi #arazzo #overlay

GitHub - Pakisan/arazzo-idea-plugin: arazzo-idea-plugin is a IDEA plugin for Arazzo specification arazzo-idea-plugin is a IDEA plugin for Arazzo specification - Pakisan/arazzo-idea-plugin

Great news for Async & OpenAPI spec devs!

Support for the Arazzo Spec is coming to @jetbrains.com IDEs! I'm building a dedicated plugin with:
✅File recognition
✅Real-time validation
✅Smart autocompletion

First release in the next few weeks!
github.com/Pakisan/araz...

#asyncapi #arazzo #jetbrains

Why API-First Matters in an AI-Driven World As AI applications expand, an API-first approach ensures robust, scalable, and consumer-friendly systems.

AI is evolving fast and structured, deterministic interfaces still matter.

For agents to reason and act reliably, they need more than endpoints. They need well-designed API capabilities.

I covered more on the topic below👇
smartbear.com/blog/why-api...

#OpenAPI #AgenticWorkflows #MCP #Arazzo

I’ll be speaking at #apidaysHelsinki on June 4th!

Talks/Panels
➊ 𝗔𝗜 𝗠𝗮𝘆 𝗗𝗲𝗰𝗶𝗱𝗲 𝘆𝗼𝘂𝗿 𝗔𝗣𝗜’𝘀 𝗙𝗮𝘁𝗲
➋ 𝗚𝗲𝘁𝘁𝗶𝗻𝗴 𝘁𝗵𝗲 𝗥𝗶𝗴𝗵𝘁 𝗔𝗣𝗜 𝗙𝗮𝘀𝘁𝗲𝗿 using Example Mapping, OpenAPI, & #Arazzo
➌ Building Communities with @openapis.org

Free guest tickets: ticket.apidays.global/event/apiday...

Hope to see you there! 🚀

Oh yeah, widening hashtag spread #PyCon #PyConUS #OpenAPI #Arazzo #OAI

OpenAPI Initiative Newsletter - April 2025 - OpenAPI Initiative April 2025 OpenAPI update: push for v3.1 adoption, Arazzo roadmap, upcoming events, and the OAK Repository’s role in AI-focused API workflows.

Please read our April 2025 newsletter! Packed with our v3.1 adoption call to action, events news, and Ecosystem Spotlight feature on the Open Agentic Knowlege Repository that brings together OpenAPI and Arazzo with #AI agent knowledge #api #openapi #arazzo #overlay www.openapis.org/blog/2025/05...

The 𝗢𝗽𝗲𝗻 𝗔𝗴𝗲𝗻𝘁𝗶𝗰 𝗞𝗻𝗼𝘄𝗹𝗲𝗱𝗴𝗲 (𝗢𝗔𝗞) manifesto published by @jentic.bsky.social has 10 principles for how #ai-agents and #APIs should act together.

Focus is on:
- Better API Docs
- Leveraging #OpenAPI + #Arazzo to compliment #MCP
- Vendor agnostic interop

The manifesto: github.com/jentic/oak/b...

apidays New York 2025 - OpenAPI Initiative API Management for Surfing the Next Innovation Waves: GenAI and Open Banking

Great to be on Bluesky!

Our OAI Track at apidays New York, May 14 -15. The track will be led by @dret.bsky.social and cover our a range of topics including specs, governance, and AI.

Please see event details: www.openapis.org/events/apida...

#api #openapi #arazzo #overlay

We are ready for launch 🚀! Here at Jentic, we are creating the #OpenSource platform for building workflows with #AgenticAI and #MCP... learn more at jentic.com and join the conversation on our Discord server discord.gg/J22TNGqe #Arazzo #OpenAPI #AIagents

The Rise of AI Agents: How Arazzo Is Defining the Future of API Workflows AI agents are revolutionizing software interactions — structured API workflows ensure they operate efficiently.

Are your #APIs and API-based capabilities ready for #AIAgents? Can #Arazzo bring control, discoverability, and improve the outcomes for the new wave of API consumers?

I penned my opinions for the @thenewstack.io

thenewstack.io/the-rise-of-...

Enjoyed speaking at @iata.org Open API Working Group @ WDS ✈️ Great discussions on #OpenAPI, #Arazzo & #AsyncAPI! 🚀 Nice to see the role #Stoplight & #Spectral play in airline API standardization. Excited to keep supporting from SmartBear & drive API interoperability forward! #APIs #IATA

Always a pleasure chatting with the incredibly knowledgeable @kinlane.bsky.social (aka @apievangelist.com). This time we focused on #Arazzo and the maturing of the #OpenAPI Initiative into a multi-specification project under the @linuxfoundation.org

#apis #apiworkflows

The Arazzo Specification – A Deep Dive

Curious about the #Arazzo Specification from the #OpenAPI Initiative?

My deep dive breaks it down—in plain English!

🔹 What is Arazzo?
🔹 Where it adds value
🔹 The structure (simplified)
🔹 Real-world example
🔹 Fast-tracking with ArazzoGPT

👉 swagger.io/blog/the-ara...

#apis #apiworkflows #aiagents

5 potential use cases for Arazzo Discover how Arazzo simplifies API workflows, enhances AI accuracy, and streamlines development, security, and testing.

#Arazzo is a new OpenAPI spec for documenting complex #API workflows. Check out my roundup of five key use cases on the @speakeasy.com blog!👇
www.speakeasy.com/post/5-poten...

Announcing Arazzo Specification version 1.0.1 - OpenAPI Initiative The Arazzo Specification version 1.0.1 is now available, providing corrections, clarifications, and examples for Arazzo implementers.

#OpenAPI has launched v1.0.1 of the #Arazzo Specification!

Arazzo is a description language that can reference multiple #APIs, each described with an OpenAPI description or another Arazzo doc, providing consumers with a rich view of complex, multistep workflows

www.openapis.org/blog/2025/01...

Meaning of #arazzo ARAZZO: woven for the cladding of walls, made by looms, in where is combines the work of a painter or cartoonist and it of several expert weavers... arazzo

1.0.1 patch version by frankkilcommins · Pull Request #318 · OAI/Arazzo-Specification Arazzo – 1.0.1 release PR (to main) Fixes #282 Fixes #281 Fixes #268 Fixes #247 Fixes #244 Fixes #245 Fixes #233 Fixes #241 Fixes #242 Fixes #231 Fixes #220

The release of 1.0.1 of the #Arazzo Specification from #OpenAPI is ready to go.
github.com/OAI/Arazzo-S...

It improves clarity, resolves bugs, and we’ve bundled a formal #JSONSchema for Arazzo too. We’ll follow up in the coming days with the formal publishing and release blog with full details.

Significado de #arazzo ARAZZO: Tejido para el revestimiento de paredes, confeccionado mediante telares, en donde se conjuga la obra de un pintor o dibujante y la de varios expertos tejedores... arazzo

Significado de #arazzo LOUNGES: tecidos para revestimento de paredes, feitas por teares, onde combina o trabalho de um pintor ou cartunista e seja de vários tecelões especializados... arazzo

#APIDaysParis kicks off tomorrow! I’ll be speaking on the #OpenAPI track at 4:45 PM about 𝗗𝗲𝘀𝗰𝗿𝗶𝗯𝗶𝗻𝗴 𝗔𝗣𝗜 𝗪𝗼𝗿𝗸𝗳𝗹𝗼𝘄𝘀 𝘄𝗶𝘁𝗵 𝗔𝗿𝗮𝘇𝘇𝗼, demoing new tools for the #Arazzo Spec!

If the "demo gods" are kind, we'll go from zero to deployed workflow-enabled product in a Developer Portal!

Hope to see you there!