Skip to content

PR for the 26-01 Part 2 V3.2 Release #575

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 69 commits into
base: main
Choose a base branch
from
Draft

PR for the 26-01 Part 2 V3.2 Release #575

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
69 commits
Select commit Hold shift + click to select a range
1a0d924
Update antora.yml
Rudra-sandeep May 27, 2025
a54ade9
add parameter id and note to PutAssetAdministrationShellById
sebbader-sap Nov 28, 2025
013eb08
add the 'server not implemented' status code
sebbader-sap Nov 28, 2025
292ecee
Merge pull request #514 from admin-shell-io/SeBa/extend-status-codes
BirgitBoss Dec 1, 2025
8d864db
Merge branch 'IDTA-01002-3-2_working' into SeBa/fix-PutAssetAdministr…
BirgitBoss Dec 1, 2025
6f0df40
Merge pull request #513 from admin-shell-io/SeBa/fix-PutAssetAdminist…
BirgitBoss Dec 1, 2025
8835585
Bi bo/editorial changes 3 2 (#498)
BirgitBoss Dec 4, 2025
3b7c559
Merge branch 'IDTA-01002-3-2_Working' into IDTA-01002-3-2_working
sebbader-sap Dec 5, 2025
720463d
use v3.2 in all files
sebbader-sap Dec 5, 2025
07bc78a
Include Note for the Operation GenerateSerializationByIds (#512)
sebbader-sap Dec 12, 2025
b092140
Update AasxFileServerServiceSpecification/V3.2_SSP-001.yaml
sebbader-sap Dec 12, 2025
05f79b4
Update AasxFileServerServiceSpecification/V3.2_SSP-001.yaml
sebbader-sap Dec 12, 2025
43396ec
Update documentation/IDTA-01002-3/modules/ROOT/pages/index.adoc
sebbader-sap Dec 12, 2025
e120aca
Update documentation/IDTA-01002-3/modules/ROOT/pages/index.adoc
sebbader-sap Dec 12, 2025
9130574
Update documentation/IDTA-01002-3/modules/ROOT/pages/index.adoc
sebbader-sap Dec 12, 2025
eaa4cbd
replace the old 3.1 version in semanticIds
sebbader-sap Dec 12, 2025
39aab15
replace the old 3.1 version in semanticIds
sebbader-sap Dec 12, 2025
25b6982
Merge branch 'IDTA-01002-3-2_working' of https://github.com/admin-she…
sebbader-sap Dec 12, 2025
20808b2
Add V3.1.2 Bugfixes into V3.2.0 (#541)
sebbader-sap Feb 27, 2026
e38202f
remove GetAllAssetAdministrationShellDescriptorsByAssetType from open…
sebbader-sap Feb 27, 2026
75bafa9
add new aas repo identifiable profile
sebbader-sap Feb 28, 2026
5513a14
editorial fixes in table 2 query language (#543)
sebbader-sap Mar 29, 2026
14aa2a1
BUGFIX Grammar 3-2 (#548)
Martin187187 Mar 29, 2026
dccb396
remove swaggerhub links (#544)
sebbader-sap Mar 29, 2026
558d65c
Fix ServiceSpecificationProfileEnum for V3.2 (#528)
sebbader-sap Mar 29, 2026
15940ef
change application/asset-administration-shell-package+xml to applicat…
sebbader-sap Mar 29, 2026
257ef8d
Async AASX File Server Profile (#531)
sebbader-sap Mar 29, 2026
fd3fff8
cherry pick bugfix commit + adjusting the changelog (#567)
sebbader-sap Mar 29, 2026
a6963b4
Signing API based on JWS (#527)
sebbader-sap Mar 29, 2026
ed158cb
Add signing of Identifiables (#523)
aorzelskiGH Mar 29, 2026
02642a8
solve conflicts and clean up files
sebbader-sap Mar 29, 2026
9d687ba
Merge branch 'IDTA-01002-3-2_working' into SeBa/496-aas-repo-identifi…
sebbader-sap Mar 29, 2026
27b1517
fix SupplementalSemanticId vs. SupplementalSemanticIds
sebbader-sap Mar 29, 2026
f48ccbe
adding supplemantalSemanticIds to the AAS Query
sebbader-sap Mar 29, 2026
89e3261
Update documentation/IDTA-01002-3/modules/ROOT/pages/json-grammar.txt
sebbader-sap Mar 30, 2026
5d64481
Update documentation/IDTA-01002-3/modules/ROOT/pages/json-grammar.txt
sebbader-sap Mar 30, 2026
17963b7
Update documentation/IDTA-01002-3/modules/ROOT/pages/json-grammar.txt
sebbader-sap Mar 30, 2026
c94085c
Update documentation/IDTA-01002-3/modules/ROOT/pages/json-grammar.txt
sebbader-sap Mar 30, 2026
c772090
bugfix OperationRequestValueOnly and OperationResultValueOnly from Su…
sebbader-sap Apr 4, 2026
2e70ff0
adjust README with v3.2 release information
sebbader-sap Apr 4, 2026
b72ca08
explaining supplementalSemanticIds[0] vs. supplementalSemanticIds[any]
sebbader-sap Apr 4, 2026
a79d353
typo
sebbader-sap Apr 4, 2026
a7d12ff
add JSON schema pattern for new supplementalSemanticIds
sebbader-sap Apr 4, 2026
353ab4c
update index.adoc and bibliography to include Part 3b for V3.2 (#571)
BirgitBoss Apr 16, 2026
5d8a5c7
fix changelog tables to be consistent, add extended interface AASX Fi…
BirgitBoss Apr 16, 2026
3999c00
editorial changes (#559)
BirgitBoss Apr 16, 2026
ec147a3
Merge pull request #545 from admin-shell-io/SeBa/496-aas-repo-identif…
aorzelskiGH Apr 17, 2026
146769f
Merge branch 'IDTA-01002-3-2_working' into SeBa/524-SupplementalSeman…
aorzelskiGH Apr 17, 2026
27201d1
Merge pull request #568 from admin-shell-io/SeBa/524-SupplementalSema…
aorzelskiGH Apr 17, 2026
5c2a4bb
Add GetAssetAdministrationShellVersionByIdAndDate and GetSubmodelVers…
sebbader-sap Apr 20, 2026
2d4ffae
Exemplary Discovery of AAS Objects with LinkSets and ID Link (#536)
sebbader-sap Apr 20, 2026
1a85ed0
new part 1 openapi classes for metamodel version 3.2
sebbader-sap Apr 23, 2026
94c5e63
add missing endpoints and operations for the aas identifiable profile
sebbader-sap Apr 23, 2026
d63ec20
Correct endpointProtocolVersion values in the example
sebbader-sap Apr 29, 2026
6651095
Update changelog.adoc
sebbader-sap Apr 29, 2026
5fad1b4
fix formatting + remove redundant chapter Interface Changes w.r.t. V3…
BirgitBoss May 8, 2026
9817fe2
Chapter 3.1.1 vs. 3.1.2 was there twice: merged
BirgitBoss May 8, 2026
99c46bf
fix structure of interfaces_payload: ServiceDescription is not subcha…
BirgitBoss May 8, 2026
f186add
update changelog w.r.t. structural change + typo
BirgitBoss May 8, 2026
dec7fbc
added subchapter for V3.2 interface changes again + added issue refer…
BirgitBoss May 11, 2026
43fd825
tyo; “asyncronous” should be “asynchronous”
BirgitBoss May 11, 2026
b9d1b52
typo: PostAsyncAASXPackag ==> PostAsyncAASXPackage
BirgitBoss May 11, 2026
0be0bf1
Merge pull request #604 from admin-shell-io/BiBo/Formatting
BirgitBoss May 11, 2026
5446338
Merge pull request #606 from admin-shell-io/BiBo/formatting_Structure
BirgitBoss May 11, 2026
136cd73
Apply suggestion from @BirgitBoss
BirgitBoss May 11, 2026
c25efcb
Merge branch 'IDTA-01002-3-2_working' into sebbader-sap-patch-1
BirgitBoss May 11, 2026
003a849
Merge pull request #598 from admin-shell-io/sebbader-sap-patch-1
BirgitBoss May 11, 2026
78eba29
correct xref IDTA-01001/v3.1 to v3.2 (#605)
BirgitBoss May 11, 2026
88ff00c
fix: correct AsciiDoc table closing tag in Interface Changes section
sebbader-sap May 20, 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
94 changes: 47 additions & 47 deletions ...verServiceSpecification/V3.1_SSP-001.yaml → ...verServiceSpecification/V3.2_SSP-001.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ info:
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
version: V3.1.1_SSP-001
x-profile-identifier: https://admin-shell.io/aas/API/3/1/AasxFileServerServiceSpecification/SSP-001
version: V3.2.0_SSP-001
x-profile-identifier: https://admin-shell.io/aas/API/3/2/AasxFileServerServiceSpecification/SSP-001
termsOfService: https://github.com/admin-shell-io/aas-specs-metamodel
servers:
- url: 'https://admin-shell.io/api/v3'
Expand All @@ -25,7 +25,7 @@ paths:
summary: Returns a list of available AASX packages at the server
operationId: GetAllAASXPackageIds
x-semanticIds:
- https://admin-shell.io/aas/API/GetAllAASXPackageIds/3/1
- https://admin-shell.io/aas/API/GetAllAASXPackageIds/3/2
parameters:
- name: aasId
in: query
Expand All @@ -35,32 +35,32 @@ paths:
explode: true
schema:
type: string
- $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/parameters/Limit'
- $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/parameters/Cursor'
- $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Limit'
- $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Cursor'
responses:
'200':
description: Requested package list
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/schemas/GetPackageDescriptionsResult'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/schemas/GetPackageDescriptionsResult'
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'401':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/unauthorized'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/unauthorized'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
post:
tags:
- AASX File Server API
summary: Stores the AASX package at the server
operationId: PostAASXPackage
x-semanticIds:
- https://admin-shell.io/aas/API/PostAASXPackage/3/1
- https://admin-shell.io/aas/API/PostAASXPackage/3/2
requestBody:
description: AASX package
content:
Expand Down Expand Up @@ -92,19 +92,19 @@ paths:
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/schemas/PackageDescription'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/schemas/PackageDescription'
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'401':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/unauthorized'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/unauthorized'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'409':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/conflict'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/conflict'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
/packages/{packageId}:
parameters:
- name: packageId
Expand All @@ -121,7 +121,7 @@ paths:
summary: Returns a specific AASX package from the server
operationId: GetAASXByPackageId
x-semanticIds:
- https://admin-shell.io/aas/API/GetAASXByPackageId/3/1
- https://admin-shell.io/aas/API/GetAASXByPackageId/3/2
responses:
'200':
description: Requested AASX package
Expand All @@ -136,24 +136,24 @@ paths:
type: string
format: binary
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'401':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/unauthorized'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/unauthorized'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'404':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/not-found'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
put:
tags:
- AASX File Server API
summary: Creates or updates the AASX package at the server
operationId: PutAASXByPackageId
x-semanticIds:
- https://admin-shell.io/aas/API/PutAASXByPackageId/3/1
- https://admin-shell.io/aas/API/PutAASXByPackageId/3/2
requestBody:
description: AASX package
content:
Expand Down Expand Up @@ -185,63 +185,63 @@ paths:
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/schemas/PackageDescription'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/schemas/PackageDescription'
'204':
description: AASX package updated successfully
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'401':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/unauthorized'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/unauthorized'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
delete:
tags:
- AASX File Server API
summary: Deletes a specific AASX package from the server
operationId: DeleteAASXByPackageId
x-semanticIds:
- https://admin-shell.io/aas/API/DeleteAASXByPackageId/3/1
- https://admin-shell.io/aas/API/DeleteAASXByPackageId/3/2
responses:
'204':
description: Deleted successfully
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'401':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/unauthorized'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/unauthorized'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'404':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/not-found'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
/description:
get:
tags:
- Description API
summary: Returns the self-describing information of a network resource (ServiceDescription)
operationId: GetSelfDescription
x-semanticIds:
- https://admin-shell.io/aas/API/GetSelfDescription/3/1
- https://admin-shell.io/aas/API/GetSelfDescription/3/2
responses:
'200':
description: Requested Description
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/schemas/ServiceDescription'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/schemas/ServiceDescription'
'400':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/bad-request'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request'
'403':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/forbidden'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden'
'404':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/not-found'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found'
'500':
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/internal-server-error'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error'
default:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.1#/components/responses/default'
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/default'
Loading