From 30bd9befbb45bf929c420789738718c1fe60b622 Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 16:54:52 +0200 Subject: [PATCH 1/2] Removes wrong 404 status code for getAllSubmodelDescriptors --- Entire-API-Collection/V3.1.yaml | 4 ---- .../V3.1_SSP-001.yaml | 2 -- .../V3.1_SSP-002.yaml | 2 -- .../IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 14 ++++++++++++++ 4 files changed, 14 insertions(+), 8 deletions(-) diff --git a/Entire-API-Collection/V3.1.yaml b/Entire-API-Collection/V3.1.yaml index 383f5c5c..e0f773b2 100644 --- a/Entire-API-Collection/V3.1.yaml +++ b/Entire-API-Collection/V3.1.yaml @@ -6606,8 +6606,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: @@ -6954,8 +6952,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: diff --git a/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml b/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml index 02c7a3ab..b8aa9fb1 100644 --- a/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml +++ b/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml @@ -39,8 +39,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: diff --git a/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml b/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml index d300a487..4c579b58 100644 --- a/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml +++ b/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml @@ -39,8 +39,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index 05f7bfd0..a069d5f8 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,6 +9,20 @@ 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]) +* Updated the response contract of `GetAllSubmodelDescriptors` in Submodel Registry OpenAPI files by removing status code `404` for `GET /submodel-descriptors`, so an empty collection is consistently represented by `200` with an empty result. (https://github.com/admin-shell-io/aas-specs-api/issues/597[#597]) + == Changes w.r.t. V3.1.1 to V3.1.2 From 0d21dcb537ea9f6f45c292ea9b9c107e4d2fc04c Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 17:26:01 +0200 Subject: [PATCH 2/2] Readds incorrectly removed Status Code in entire api collection --- Entire-API-Collection/V3.1.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Entire-API-Collection/V3.1.yaml b/Entire-API-Collection/V3.1.yaml index e0f773b2..88ab7762 100644 --- a/Entire-API-Collection/V3.1.yaml +++ b/Entire-API-Collection/V3.1.yaml @@ -6606,6 +6606,8 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' + '404': + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: