Skip to content

Bugfix: v3.1.3 #622

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
sebbader-sap wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Bugfix: v3.1.3 #622

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b5283fa
Fix response payload type for PutSubmodelById: status code 201 now re…
aaronzi Jun 5, 2026
e706ebe
Fix response contracts in Discovery OpenAPI files (#616)
aaronzi Jun 5, 2026
e9cd582
Remove wrong 404 status code for getAllSubmodelDescriptors (#617)
aaronzi Jun 5, 2026
e58adea
fixing Submodel Service Specification – Read Profile identifier (#623)
sebbader-sap Jun 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions AssetAdministrationShellRepositoryServiceSpecification/V3.1_SSP-001.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -540,7 +540,7 @@ paths:
required: true
responses:
'201':
description: Submodel reference created successfully
description: Submodel created successfully
headers:
Location:
description: URL of the newly created resource
Expand All @@ -549,7 +549,7 @@ paths:
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/Reference'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/Submodel'
'204':
description: Submodel updated successfully
'400':
Expand Down
4 changes: 0 additions & 4 deletions DiscoveryServiceSpecification/V3.1_SSP-001.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,10 +135,6 @@ paths:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/SpecificAssetId'
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request'
'404':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found'
'409':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/conflict'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/default'
delete:
Expand Down
6 changes: 0 additions & 6 deletions Entire-API-Collection/V3.1.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6954,8 +6954,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:
Expand Down Expand Up @@ -7313,10 +7311,6 @@ paths:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/SpecificAssetId'
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request'
'404':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found'
'409':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/conflict'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/default'
delete:
Expand Down
2 changes: 0 additions & 2 deletions SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 0 additions & 2 deletions SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
15 changes: 15 additions & 0 deletions documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,21 @@
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])

Check warning on line 22 in documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

View workflow job for this annotation

GitHub Actions / qodana

Attribute not defined within project 

Attribute should be defined
* 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])

Check warning on line 23 in documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

View workflow job for this annotation

GitHub Actions / qodana

Attribute not defined within project 

Attribute should be defined
* 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])
* Submodel Service Specification – Read Profile had the wrong identifier `https://admin-shell.io/aas/API/3/1/AssetAdministrationShellServiceSpecification/SSP-002` instead of https://admin-shell.io/aas/API/3/1/SubmodelServiceSpecification/SSP-002`


== Changes w.r.t. V3.1.1 to V3.1.2

Expand Down
2 changes: 1 addition & 1 deletion ...002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@ The submodel service specification with its minimal feature set is represented t
[%autowidth,width="100%",cols="36%,64%",options="header",]
|===
h|Name: h|Submodel Read Profile
h|Profile Identifier: |`\https://admin-shell.io/aas/API/3/1/AssetAdministrationShellServiceSpecification/SSP-002`
h|Profile Identifier: |`\https://admin-shell.io/aas/API/3/1/SubmodelServiceSpecification/SSP-002`
h|Feature h|Appearance
|API and API Operations a|
_Submodel API:_ +
Expand Down
Loading