From 9394fc033654056ce054898550da508875a8ee5d Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 08:47:35 +0200 Subject: [PATCH 1/3] Fix response contracts in Discovery OpenAPI files Remove status codes 404 and 409 for POST /lookup/shells/{aasIdentifier} to align with create-or-replace and replace/update semantics. --- DiscoveryServiceSpecification/V3.2_SSP-001.yaml | 6 +----- Entire-API-Collection/V3.2.yaml | 6 +----- .../IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 13 +++++++++++++ 3 files changed, 15 insertions(+), 10 deletions(-) diff --git a/DiscoveryServiceSpecification/V3.2_SSP-001.yaml b/DiscoveryServiceSpecification/V3.2_SSP-001.yaml index 202e409c..3653f40e 100644 --- a/DiscoveryServiceSpecification/V3.2_SSP-001.yaml +++ b/DiscoveryServiceSpecification/V3.2_SSP-001.yaml @@ -134,11 +134,7 @@ paths: items: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/SpecificAssetId' '400': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found' - '409': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/conflict' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' default: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default' delete: diff --git a/Entire-API-Collection/V3.2.yaml b/Entire-API-Collection/V3.2.yaml index 420f80bb..258dea58 100644 --- a/Entire-API-Collection/V3.2.yaml +++ b/Entire-API-Collection/V3.2.yaml @@ -7417,11 +7417,7 @@ paths: items: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/SpecificAssetId' '400': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found' - '409': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/conflict' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' default: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default' delete: diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index f3a04ced..60df4320 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,6 +9,19 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they have an impact on the payload of many operations. ==== +== Changes w.r.t. V3.1.2 to V3.1.3 + +Major Changes: + +* ... + + +Minor Changes: + +* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) + == Changes w.r.t. V3.1.2 to V3.2 From 98c16fd3db7394a82bd2c2db2737a418c0395d91 Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 18:07:31 +0200 Subject: [PATCH 2/3] Corrects changelog --- .../modules/ROOT/pages/changelog.adoc | 25 +++++++++---------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index 60df4320..63767e29 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,19 +9,6 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they have an impact on the payload of many operations. ==== -== Changes w.r.t. V3.1.2 to V3.1.3 - -Major Changes: - -* ... - - -Minor Changes: - -* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) -* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) -* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) - == Changes w.r.t. V3.1.2 to V3.2 @@ -75,6 +62,18 @@ h|Operation h|Kind of Change h|Comment |=== +== Changes w.r.t. V3.1.2 to V3.1.3 + +Major Changes: + +* ... + + +Minor Changes: + +* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) == Changes w.r.t. V3.1.1 to V3.1.2 From 0d5741f3b70a3c051e780f5b85c1818cfd0f96f7 Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 19:08:53 +0200 Subject: [PATCH 3/3] Adds missing empty line in changelog --- documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index 63767e29..574dcbe3 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -75,6 +75,7 @@ Minor Changes: * Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) * Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) + == Changes w.r.t. V3.1.1 to V3.1.2 Major Changes: