OAI/Arazzo-Specification

View on GitHub

The Arazzo Specification - A Tapestry for Deterministic API Workflows

Stars: 471
Forks: 69
Open beginner issues: 0
Indexed issues: 59
Avg merge: 17h 58m
Merged PRs (30d): 19

Dominant language: JavaScript
License: Apache-2.0
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

59 open issues indexed

Meeting: Sept 16th, 2026 Open

Housekeeping meetings

Difficulty 1/5 Under an hour Newbie friendliness 15/100

OAI/Arazzo-Specification#579 · 1 comment · Opened Sep 16, 2026
Specify supported AsyncAPI version(s) for `asyncapi` source descriptions (tighten to v3) Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#563 · Opened Sep 1, 2026
1.1 schema: parameter-object.value lost the `object` type present in 1.0 Open

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

OAI/Arazzo-Specification#559 · 2 comments · Opened Aug 30, 2026
1.1 schema: expression-type-object requires `version`, contradicting its own description Open

Difficulty 1/5 Under an hour Newbie friendliness 88/100

OAI/Arazzo-Specification#558 · Opened Aug 30, 2026
Runtime expression grammar: add $workflows.<workflowId>.steps.<stepId> for dependsOn step references (Step Object) Open

Difficulty 3/5 1-2 days Newbie friendliness 66/100

OAI/Arazzo-Specification#557 · Opened Aug 30, 2026
1.2 proposal: Function Object and functionId step target (MCP tools, CLI commands, and other calls with no source description) Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#523 · 5 comments · 2 reactions · Opened Jul 17, 2026
Parameter Object: value type (Any | Runtime Expression | Selector Object) is ambiguous Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

OAI/Arazzo-Specification#519 · 2 comments · Opened Jul 9, 2026
Provide a normative grammar and boundary rules for simple Criterion Object conditions Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#518 · Opened Jul 9, 2026
Define bare-condition truthiness (pass/fail) semantics for simple Criterion Object conditions Open

Difficulty 5/5 Over a week Newbie friendliness 45/100

OAI/Arazzo-Specification#517 · Opened Jul 9, 2026
Criterion Object: regex condition type does not specify a regular expression dialect Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OAI/Arazzo-Specification#515 · Opened Jul 8, 2026
Runtime expression grammar: shared `source` rule over-permits `payload`/`body` across $request/$response/$message Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OAI/Arazzo-Specification#501 · 2 comments · Opened Jul 7, 2026
Handling redirects Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#493 · 6 comments · Opened May 19, 2026
Describe how Arazzo handles API responses that contain files. Open

question

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#492 · 3 comments · Opened May 19, 2026
Arazzo-Specification/examples/1.0.0 /FAPI-PAR.openapi.yaml is invalid or misleading Open

OAI/Arazzo-Specification#490 · 5 comments · 1 assignee · Opened May 13, 2026
Add examples for 1.1.0 Open

documentation Housekeeping

Difficulty 3/5 1-2 days Newbie friendliness 48/100

OAI/Arazzo-Specification#467 · Opened Apr 15, 2026
Selectors (JSON Pointer, JSONPath, Runtime Expressions) should operate on the data model, not on serialized data Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#458 · 1 comment · Opened Apr 1, 2026
Actor-in-the-loop Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#449 · 1 comment · Opened Mar 18, 2026
Conformance Testing Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#448 · Opened Mar 18, 2026
The value for the example reusable object is the wrong type Open

Difficulty 1/5 Under an hour Newbie friendliness 50/100

OAI/Arazzo-Specification#431 · Opened Jan 25, 2026
Inconsistent definition of field name constrains Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

OAI/Arazzo-Specification#429 · Opened Jan 22, 2026
Set up meetings for 2026 Open

Difficulty 1/5 Under an hour Newbie friendliness 10/100

OAI/Arazzo-Specification#414 · 1 comment · Opened Dec 17, 2025
1.2 - start of discussion/ideas/breaking changes Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

OAI/Arazzo-Specification#410 · 4 comments · 1 reaction · Opened Nov 27, 2025
Bi-weekly meeting schedule change Open

Housekeeping

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OAI/Arazzo-Specification#408 · Opened Nov 27, 2025
Clarification: Source Description Object - type parameter Open

documentation question

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#368 · 2 comments · Opened Sep 9, 2025
Update Schema coverage tests to use `@hyperjump/json-schema-coverage/vitest` Open

Infrastructure

OAI/Arazzo-Specification#364 · 1 assignee · Opened Aug 12, 2025
Arazzo Runtime expression escaping Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#363 · 1 comment · Opened Aug 8, 2025
Syntax for mocks Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#361 · 2 comments · Opened Aug 7, 2025
JSON Schema Issue for Criterion Object and Criterion Expression Type Object Open

schema-bug

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OAI/Arazzo-Specification#336 · 4 comments · Opened Mar 21, 2025
Clarification/fixes on example files Open

examples-bug Housekeeping

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

OAI/Arazzo-Specification#332 · 2 comments · Opened Mar 13, 2025
How to filter the output of a get request that return an array of elements ? Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#326 · 3 comments · Opened Feb 25, 2025
Infra Enhancement: Create GitHub action to automatically create the bi-weekly meeting issue Open

Housekeeping Infrastructure

Difficulty 3/5 1-2 days Newbie friendliness 58/100

OAI/Arazzo-Specification#266 · Opened Oct 30, 2024
Add folders to examples to help organize examples Open

Housekeeping

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OAI/Arazzo-Specification#262 · 2 comments · Opened Oct 15, 2024
Expressions to generate Parameter Name Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#256 · Opened Sep 24, 2024
suggestion: allow outputs to be a map of name to expression or value Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#255 · Opened Sep 19, 2024
ABNF $steps does it need to access through outputs? Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#254 · 1 comment · Opened Sep 14, 2024
Improvement request: Support literal values in Criterion object when `type: simple` and context provided Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#246 · Opened Aug 29, 2024
Governance: Create codeowners list for Arazzo for PR reviews into main Open

Housekeeping process

OAI/Arazzo-Specification#228 · 1 assignee · Opened Jul 31, 2024
Schema dialects undefined in Arazzo Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

OAI/Arazzo-Specification#223 · 1 comment · 1 reaction · Opened Jul 30, 2024
runtime expression validation Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#221 · 3 comments · Opened Jul 30, 2024
XPath version identifier feels a bit confusing Open

question

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

OAI/Arazzo-Specification#219 · 3 comments · Opened Jul 30, 2024
Handle `servers` variable params Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/Arazzo-Specification#218 · 8 comments · Opened Jul 26, 2024
Readme's "in action" gif not readable Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

OAI/Arazzo-Specification#206 · Opened Jun 10, 2024
Tighten extension model Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#202 · 12 comments · Opened Jun 10, 2024
Define labels for repo tagging advertising support for the Arazzo Specification Open

Housekeeping

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#191 · Opened May 22, 2024
Governance updates Open

process

OAI/Arazzo-Specification#186 · 1 comment · 1 assignee · Opened Apr 29, 2024
Questions about `sourceDescriptions` references and sructure Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#184 · 3 comments · Opened Apr 26, 2024
Feedback on `operationPath` Open

wontfix

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/Arazzo-Specification#179 · 3 comments · Opened Apr 23, 2024
We need to create rich examples for the Workflow DependsOn capability Open

documentation help wanted

Difficulty 3/5 1-2 days Newbie friendliness 20/100

OAI/Arazzo-Specification#168 · 1 reaction · Opened Mar 27, 2024
need for pseudo code as a step in the workflow Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

OAI/Arazzo-Specification#165 · Opened Mar 25, 2024
Any guidance for tooling to decide which workflows to run from the document Open

question

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OAI/Arazzo-Specification#163 · 3 comments · Opened Mar 15, 2024

OAI/Arazzo-Specification

Get new issues in your inbox