From 69db7fed3821cbdb90c46caaaadc539dee628bd1 Mon Sep 17 00:00:00 2001 From: Cristian Date: Thu, 12 Nov 2026 15:43:54 -0300 Subject: [PATCH 1/2] W-24890306-Add-OAS-3-2-to-the-ACB-docs-CP --- .../modules/ROOT/pages/_partials/acb-api-design.adoc | 2 ++ .../modules/ROOT/pages/des-create-api-fragments.adoc | 2 +- .../modules/ROOT/pages/des-designing-api-specs.adoc | 4 +++- .../modules/ROOT/pages/imp-implement-api-specs.adoc | 2 +- 4 files changed, 7 insertions(+), 3 deletions(-) diff --git a/code-builder-home/modules/ROOT/pages/_partials/acb-api-design.adoc b/code-builder-home/modules/ROOT/pages/_partials/acb-api-design.adoc index 753f60945..8233d2595 100644 --- a/code-builder-home/modules/ROOT/pages/_partials/acb-api-design.adoc +++ b/code-builder-home/modules/ROOT/pages/_partials/acb-api-design.adoc @@ -10,6 +10,8 @@ * OAS 3.0 (YAML) * OAS 3.1 (JSON) * OAS 3.1 (YAML) +* OAS 3.2 (JSON) +* OAS 3.2 (YAML) // end::api-spec-versions[] // diff --git a/code-builder-home/modules/ROOT/pages/des-create-api-fragments.adoc b/code-builder-home/modules/ROOT/pages/des-create-api-fragments.adoc index 7539ced75..409884f6f 100644 --- a/code-builder-home/modules/ROOT/pages/des-create-api-fragments.adoc +++ b/code-builder-home/modules/ROOT/pages/des-create-api-fragments.adoc @@ -171,7 +171,7 @@ To add an API spec fragment to a spec: ** RAML specs: Use the `!include` directive. -- + -For OAS 3.0 and 3.1 APIs, scaffolding supports `$ref` API fragments from Exchange, including fragments with transitive dependencies. OAS 3.1 requires Mule runtime 4.13 or later and APIkit for Mule 4 1.13.2 or later. DataSense resolves types defined in fragment files when you scaffold into a Mule project that uses a supported Mule runtime version (currently Mule 4.9.19, Mule 4.11.6, and Mule 4.13). +For OAS 3.0, 3.1, and 3.2 APIs, scaffolding supports `$ref` API fragments from Exchange, including fragments with transitive dependencies. OAS 3.1 and OAS 3.2 require Mule runtime 4.13 or later and APIkit for Mule 4 1.13.2 or later. DataSense resolves types defined in fragment files when you scaffold into a Mule project that uses a supported Mule runtime version (currently Mule 4.9.19, Mule 4.11.6, and Mule 4.13). + [tabs] ==== diff --git a/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc b/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc index 80ee0d579..dc55c4c08 100644 --- a/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc +++ b/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc @@ -22,6 +22,8 @@ Supported OAS and RAML versions are: * OAS 3.0 (YAML) * OAS 3.1 (JSON) * OAS 3.1 (YAML) +* OAS 3.2 (JSON) +* OAS 3.2 (YAML) * RAML 1.0 * RAML 0.8 @@ -39,7 +41,7 @@ Create, include, or reference API fragments within your API specification. Supported API specification languages and syntaxes for API fragments are: -* OAS 3.0 and 3.1 +* OAS 3.0, 3.1, and 3.2 ** YAML ** JSON * RAML 1.0 diff --git a/code-builder-home/modules/ROOT/pages/imp-implement-api-specs.adoc b/code-builder-home/modules/ROOT/pages/imp-implement-api-specs.adoc index 98cbefd32..35854b818 100644 --- a/code-builder-home/modules/ROOT/pages/imp-implement-api-specs.adoc +++ b/code-builder-home/modules/ROOT/pages/imp-implement-api-specs.adoc @@ -30,7 +30,7 @@ the spec to Exchange, see xref:imp-implement-local-apis.adoc[]. //shared implementation prereqs include::partial$acb-reusable-steps.adoc[tags="prereqs-implementation"] -* If your API spec is OAS 3.1, make sure your project uses Mule runtime 4.13 or later and APIkit for Mule 4 1.13.2 or later. +* If your API spec is OAS 3.1 or OAS 3.2, make sure your project uses Mule runtime 4.13 or later and APIkit for Mule 4 1.13.2 or later. [[scaffold-new-integration]] == Scaffold an API into a New Project From 0fecb3056cefc8459ab668e9d564b8d1993f6d25 Mon Sep 17 00:00:00 2001 From: Cristian Date: Thu, 12 Nov 2026 21:17:25 -0300 Subject: [PATCH 2/2] W-24890306-Document OAS 3.2 inline validation and autocomplete Readers creating or editing an OAS 3.2 specification need to know that Anypoint Code Builder validates it inline and autocompletes JSON Schema 2020-12 keywords. --- .../modules/ROOT/pages/des-designing-api-specs.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc b/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc index dc55c4c08..cd814a9d4 100644 --- a/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc +++ b/code-builder-home/modules/ROOT/pages/des-designing-api-specs.adoc @@ -27,6 +27,8 @@ Supported OAS and RAML versions are: * RAML 1.0 * RAML 0.8 +NOTE: When you create or edit an OAS 3.2 API specification in JSON or YAML, Anypoint Code Builder validates the specification inline and autocompletes JSON Schema 2020-12 keywords. + Supported AsyncAPI versions are: * AsyncAPI 2.6 (JSON)