Fix response payload type for PutSubmodelById (3.2 Port) (#602)

* Fixes PUT /shells/{aasIdentifier}/submodels/{submodelIdentifier} return type on 201 status

* Fix response payload type for PutSubmodelById: status code 201 now returns a Submodel instead of a Reference

* Corrects changelog

* Fixes wrong version

Author: aaronzi

AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-001.yaml

@@ -572,7 +572,7 @@ paths:
         required: true
       responses:
         '201':
-          description: Submodel reference created successfully
+          description: Submodel created successfully
           headers:
             Location:
               description: URL of the newly created resource
@@ -581,7 +581,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/Reference'
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2#/components/schemas/Submodel'
         '204':
           description: Submodel updated successfully
         '400':

AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-005.yaml

@@ -409,7 +409,7 @@ paths:
         required: true
       responses:
         '201':
-          description: Submodel reference created successfully
+          description: Submodel created successfully
           headers:
             Location:
               description: URL of the newly created resource
@@ -418,7 +418,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/Reference'
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/Submodel'
         '204':
           description: Submodel updated successfully
         '400':

Entire-API-Collection/V3.2.yaml

@@ -3390,7 +3390,7 @@ paths:
     put:
       tags:
         - Asset Administration Shell Repository API
-      summary: Updates the Submodel
+      summary: Creates or updates the Submodel
       operationId: PutSubmodelById_AasRepository
       x-semanticIds:
         - https://admin-shell.io/aas/API/PutSubmodelById/3/2
@@ -3402,6 +3402,17 @@ paths:
               $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/Submodel'
         required: true
       responses:
+        '201':
+          description: Submodel created successfully
+          headers:
+            Location:
+              description: URL of the newly created resource
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.2.0#/components/schemas/Submodel'
         '204':
           description: Submodel updated successfully
         '400':

documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

@@ -64,6 +64,17 @@ 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])
+
 
 == Changes w.r.t. V3.1.1 to V3.1.2