Arazzo API Workflows

Arazzo API 워크플로

Describe a user journey as API steps with outputs feeding later inputs.

···
html
<div class="viz"><h3>WORKFLOW OUTPUTS</h3><div class="row"><div class="box step" id="a">auth<br><small>token</small></div><span class="arrow">→</span><div class="box step" id="b">create<br><small>orderId</small></div><span class="arrow">→</span><div class="box step" id="c">retrieve</div></div><div class="muted" id="carry">token → create</div></div>
css
.viz{width:94%;height:88%;max-width:960px;padding:clamp(10px,2vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);font:600 clamp(12px,1.35vw,16px)/1.35 var(--font-sans,system-ui,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,1.8vmin,13px);overflow:hidden}.viz h3{margin:0;color:var(--accent);font:700 clamp(12px,1.35vw,16px)/1.2 var(--font-sans,system-ui,sans-serif);letter-spacing:.04em}.viz .row{display:flex;align-items:center;justify-content:center;gap:clamp(5px,1.4vmin,12px);flex:1;min-height:0}.viz .box{padding:clamp(5px,1.5vmin,12px);border:1px solid var(--line);border-radius:9px;background:var(--bg);text-align:center}.viz .muted{color:var(--muted)}.viz .accent{color:var(--accent)}.viz .code{font-family:ui-monospace,monospace}.viz .pill{padding:3px 7px;border:1px solid var(--line);border-radius:99px;white-space:nowrap}.viz .active{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 12%,var(--surface))}.viz .arrow{color:var(--accent);font:700 18px ui-monospace,monospace}.step{min-width:22%;transition:background .3s,border-color .3s}.step.on{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 16%,var(--surface))}.step small{font:12px ui-monospace,monospace;color:var(--muted)}
js
let n=0;function draw(){['a','b','c'].forEach((id,i)=>document.getElementById(id).classList.toggle('on',i===n));document.getElementById('carry').textContent=['token → create','orderId → retrieve','result ready'][n];n=(n+1)%3}draw();setInterval(draw,900)

Arazzo is an OpenAPI Initiative specification for multi-step API workflows. Beyond individual endpoints, it describes step order and how earlier outputs become later inputs. It can reference API descriptions as sources.

The demo passes an auth token and then an order ID into later steps. Test the workflow against real authentication and state, and account for failure conditions and retry policies.

When to use

Use it to share a contract for journeys such as authenticate, create, then retrieve.

Open as page ↗