From d32a4160ac55d94fe0d0323ca892fe05e6afc6b4 Mon Sep 17 00:00:00 2001
From: Sebastian Bader <s.bader@sap.com>
Date: Mon, 19 Feb 2024 18:04:48 +0100
Subject: [PATCH 01/25] revert Discovery Service Specification v3.0_SSP-001

---
 .../V3.0_SSP-001.yaml                         | 105 +++++++-----------
 1 file changed, 42 insertions(+), 63 deletions(-)

diff --git a/DiscoveryServiceSpecification/V3.0_SSP-001.yaml b/DiscoveryServiceSpecification/V3.0_SSP-001.yaml
index ed0f7d61..db22ce49 100644
--- a/DiscoveryServiceSpecification/V3.0_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.0_SSP-001.yaml
@@ -11,16 +11,33 @@ info:
   license: 
     name: CC BY 4.0
     url: https://creativecommons.org/licenses/by/4.0/
-  version: V3.1.0_SSP-001
-  x-profile-identifier: https://admin-shell.io/aas/API/3/1/DiscoveryServiceSpecification/SSP-001
+  version: V3.0.1_SSP-001
+  x-profile-identifier: https://admin-shell.io/aas/API/3/0/DiscoveryServiceSpecification/SSP-001
 servers:
-- url: 'https://admin-shell.io/api/v3.1'
-- url: 'https://example.com/'
-
+- url: '{protocol}://{host_name}:{port}/api/{version_prefix}'
+  variables:
+    protocol:
+      description: 'Allows access through http and https (recommended)'
+      enum:
+        - 'http'   
+        - 'https'
+      default: 'https'
+    host_name:
+      default: admin-shell.io
+      description: 'Hostname of server hosting the api'
+    port:
+      enum:
+        - '80'
+        - '443'
+      default: '443'
+      description: '80 is default for http, 443 for https'
+    version_prefix:
+      enum:
+        - 'v3.0'
+      default: v3.0
 paths:
   /lookup/shells:
     get:
-      deprecated: true
       tags:
         - Asset Administration Shell Basic Discovery API
       summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
@@ -28,9 +45,9 @@ paths:
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/0
       parameters:
-        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetIds'
-        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
-        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/parameters/AssetIds'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/parameters/Limit'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/parameters/Cursor'
       responses:
         '200':
           description: Requested Asset Administration Shell ids
@@ -38,7 +55,7 @@ paths:
             application/json:
               schema:
                 allOf:
-                - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/PagedResult'
+                - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/schemas/PagedResult'
                 - type: object
                   properties:
                     result:
@@ -46,48 +63,10 @@ paths:
                       items:
                         type: string
         default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
-  /lookup/shellsByAssetLink:
-    post:
-      tags:
-        - Asset Administration Shell Basic Discovery API
-      summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
-      operationId: SearchAllAssetAdministrationShellIdsByAssetLink
-      x-semanticIds:
-        - https://admin-shell.io/aas/API/SearchAllAssetAdministrationShellIdsByAssetLink/3/1
-      parameters:
-        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
-        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
-      requestBody:
-        description: A list of specific Asset identifiers
-        content:
-          application/json:
-            schema:
-              type: array
-              items:
-                '$ref': 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/AssetLink'
-      responses:
-        '200':
-          description: Requested Asset Administration Shell ids
-          content:
-            application/json:
-              schema:
-                allOf:
-                - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/PagedResult'
-                - type: object
-                  properties:
-                    result:
-                      type: array
-                      items:
-                        type: string
-        '400':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/bad-request'
-        default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
-
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/default'
   /lookup/shells/{aasIdentifier}:
     parameters:
-      - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetAdministrationShellIdentifier'
+      - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/parameters/AssetAdministrationShellIdentifier'
     get:
       tags:
         - Asset Administration Shell Basic Discovery API
@@ -103,11 +82,11 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
+                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
         '404':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/not-found'
         default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/default'
     post:
       tags:
         - Asset Administration Shell Basic Discovery API
@@ -122,7 +101,7 @@ paths:
             schema:
               type: array
               items:
-                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
         required: true
       responses:
         '201':
@@ -132,15 +111,15 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
+                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
         '400':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/bad-request'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/bad-request'
         '404':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/not-found'
         '409':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/conflict'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/conflict'
         default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/default'
     delete:
       tags:
         - Asset Administration Shell Basic Discovery API
@@ -152,9 +131,9 @@ paths:
         '204':
           description: Specific Asset identifiers deleted successfully
         '404':
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/not-found'
         default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/default'
   /description:
     get:
       tags:
@@ -169,6 +148,6 @@ paths:
           content:
             application/json:
               schema:
-                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/ServiceDescription'
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/schemas/ServiceDescription'
         default:
-          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/responses/default'
\ No newline at end of file

From 8c20ccc9a48b4d6f198dc6b4a4ae8c8f73bdf9b9 Mon Sep 17 00:00:00 2001
From: Sebastian Bader <s.bader@sap.com>
Date: Mon, 19 Feb 2024 18:05:11 +0100
Subject: [PATCH 02/25] add Discovery Service Specification V3.1_SSP-001 as own
 YAML file

---
 .../V3.1_SSP-001.yaml                         | 174 ++++++++++++++++++
 1 file changed, 174 insertions(+)
 create mode 100644 DiscoveryServiceSpecification/V3.1_SSP-001.yaml

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
new file mode 100644
index 00000000..3f250077
--- /dev/null
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -0,0 +1,174 @@
+openapi: 3.0.3
+info:
+  title: DotAAS Part 2 | HTTP/REST | Discovery Service Specification (V3.1 Draft, not released)
+  description: >-
+    The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell: Part 2](http://industrialdigitaltwin.org/en/content-hub).  
+    
+    Publisher: Industrial Digital Twin Association (IDTA) April 2023
+  contact:
+    name: Industrial Digital Twin Association (IDTA)
+    email: info@idtwin.org
+  license: 
+    name: CC BY 4.0
+    url: https://creativecommons.org/licenses/by/4.0/
+  version: V3.1.0_SSP-001
+  x-profile-identifier: https://admin-shell.io/aas/API/3/1/DiscoveryServiceSpecification/SSP-001
+servers:
+- url: 'https://admin-shell.io/api/v3.1'
+- url: 'https://example.com/'
+
+paths:
+  /lookup/shells:
+    get:
+      deprecated: true
+      tags:
+        - Asset Administration Shell Basic Discovery API
+      summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
+      operationId: GetAllAssetAdministrationShellIdsByAssetLink
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/0
+      parameters:
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetIds'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
+      responses:
+        '200':
+          description: Requested Asset Administration Shell ids
+          content:
+            application/json:
+              schema:
+                allOf:
+                - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/PagedResult'
+                - type: object
+                  properties:
+                    result:
+                      type: array
+                      items:
+                        type: string
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+  /lookup/shellsByAssetLink:
+    post:
+      tags:
+        - Asset Administration Shell Basic Discovery API
+      summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
+      operationId: SearchAllAssetAdministrationShellIdsByAssetLink
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/SearchAllAssetAdministrationShellIdsByAssetLink/3/1
+      parameters:
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
+        - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
+      requestBody:
+        description: A list of specific Asset identifiers
+        content:
+          application/json:
+            schema:
+              type: array
+              items:
+                '$ref': 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/AssetLink'
+      responses:
+        '200':
+          description: Requested Asset Administration Shell ids
+          content:
+            application/json:
+              schema:
+                allOf:
+                - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/PagedResult'
+                - type: object
+                  properties:
+                    result:
+                      type: array
+                      items:
+                        type: string
+        '400':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/bad-request'
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+
+  /lookup/shells/{aasIdentifier}:
+    parameters:
+      - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetAdministrationShellIdentifier'
+    get:
+      tags:
+        - Asset Administration Shell Basic Discovery API
+      summary: Returns a list of specific Asset identifiers based on an Asset Administration Shell id to edit discoverable content
+      operationId: GetAllAssetLinksById
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0
+      responses:
+        '200':
+          description: Requested specific Asset identifiers
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
+        '404':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+    post:
+      tags:
+        - Asset Administration Shell Basic Discovery API
+      summary: Creates specific Asset identifiers linked to an Asset Administration Shell to edit discoverable content
+      operationId: PostAllAssetLinksById
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0
+      requestBody:
+        description: A list of specific Asset identifiers
+        content:
+          application/json:
+            schema:
+              type: array
+              items:
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
+        required: true
+      responses:
+        '201':
+          description: Specific Asset identifiers created successfully
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
+        '400':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/bad-request'
+        '404':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+        '409':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/conflict'
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+    delete:
+      tags:
+        - Asset Administration Shell Basic Discovery API
+      summary: Deletes all specific Asset identifiers linked to an Asset Administration Shell to edit discoverable content
+      operationId: DeleteAllAssetLinksById
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/DeleteAllAssetLinksById/3/0
+      responses:
+        '204':
+          description: Specific Asset identifiers deleted successfully
+        '404':
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
+  /description:
+    get:
+      tags:
+        - Description API
+      summary: Returns the self-describing information of a network resource (ServiceDescription)
+      operationId: GetDescription
+      x-semanticIds:
+        - https://admin-shell.io/aas/API/Descriptor/GetDescription/3/0
+      responses:
+        '200':
+          description: Requested Description
+          content:
+            application/json:
+              schema:
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/ServiceDescription'
+        default:
+          $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/default'
\ No newline at end of file

From 75fb204531c52a5779e5801888920184063a7cc5 Mon Sep 17 00:00:00 2001
From: Sebastian Bader <s.bader@sap.com>
Date: Mon, 19 Feb 2024 18:07:53 +0100
Subject: [PATCH 03/25] adjust name of Discovery Service Specification SSP-002

---
 .../{V3.0_SSP-002.yaml => V3.1_SSP-002.yaml}                      | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename DiscoveryServiceSpecification/{V3.0_SSP-002.yaml => V3.1_SSP-002.yaml} (100%)

diff --git a/DiscoveryServiceSpecification/V3.0_SSP-002.yaml b/DiscoveryServiceSpecification/V3.1_SSP-002.yaml
similarity index 100%
rename from DiscoveryServiceSpecification/V3.0_SSP-002.yaml
rename to DiscoveryServiceSpecification/V3.1_SSP-002.yaml

From 98ea35d264923b913e8e129b522278a647086966 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Mon, 26 Feb 2024 17:35:57 +0100
Subject: [PATCH 04/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 3f250077..c8851a1a 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -33,7 +33,7 @@ paths:
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
       responses:
         '200':
-          description: Requested Asset Administration Shell ids
+          description: Requested Asset Administration Shell IDs
           content:
             application/json:
               schema:

From accd0ebcdc6bd3a08c1438c9e26db8880cc75963 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:51:59 +0100
Subject: [PATCH 05/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index c8851a1a..30146157 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: DotAAS Part 2 | HTTP/REST | Discovery Service Specification (V3.1 Draft, not released)
   description: >-
-    The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell: Part 2](http://industrialdigitaltwin.org/en/content-hub).  
+    The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell: Part 2](https://industrialdigitaltwin.org/en/content-hub/aasspecifications).  
     
     Publisher: Industrial Digital Twin Association (IDTA) April 2023
   contact:

From 156411a75f8647e53e68d0197ec8b0d2a849af2b Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:57:49 +0100
Subject: [PATCH 06/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 30146157..e29967ef 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -68,7 +68,7 @@ paths:
                 '$ref': 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/schemas/AssetLink'
       responses:
         '200':
-          description: Requested Asset Administration Shell ids
+          description: Requested Asset Administration Shell IDs
           content:
             application/json:
               schema:

From af275b7e6632f4b2e1c8f02974c5444ba2519edf Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:58:09 +0100
Subject: [PATCH 07/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index e29967ef..f6936ef4 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -59,7 +59,7 @@ paths:
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
       requestBody:
-        description: A list of specific Asset identifiers
+        description: A list of specific asset identifiers. Search for the global asset ID is supported by setting "name"  to "globalAssetId" (see Constraint AASd-077).
         content:
           application/json:
             schema:

From 14a256a8c464f31ac782c95fb8cb9a930e15f4fd Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:58:29 +0100
Subject: [PATCH 08/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index f6936ef4..c649fa24 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -91,7 +91,7 @@ paths:
     get:
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Returns a list of specific Asset identifiers based on an Asset Administration Shell id to edit discoverable content
+      summary: Returns a list of specific asset identifiers based on an Asset Administration Shell ID to edit discoverable content. The global asset ID is returned as specific asset ID with "name" equal to "globalAssetId" (see Constraint AASd-077).
       operationId: GetAllAssetLinksById
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0

From 3d10064b20d174d8bd67444dbdfda35466721d60 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:58:42 +0100
Subject: [PATCH 09/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index c649fa24..3f838e8a 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -111,7 +111,7 @@ paths:
     post:
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Creates specific Asset identifiers linked to an Asset Administration Shell to edit discoverable content
+      summary: Creates specific asset identifiers linked to an Asset Administration Shell to edit discoverable content
       operationId: PostAllAssetLinksById
       x-semanticIds:
         - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0

From 2fb64fc9de78653fa99570bb1100e666d9b85406 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:58:53 +0100
Subject: [PATCH 10/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 3f838e8a..637d56e0 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -116,7 +116,7 @@ paths:
       x-semanticIds:
         - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0
       requestBody:
-        description: A list of specific Asset identifiers
+        description: A list of specific asset identifiers
         content:
           application/json:
             schema:

From 1881ad1a75d756808bef9d66ba5d4883c032aa93 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Fri, 20 Dec 2024 17:59:03 +0100
Subject: [PATCH 11/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 637d56e0..a94bb5ee 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -126,7 +126,7 @@ paths:
         required: true
       responses:
         '201':
-          description: Specific Asset identifiers created successfully
+          description: Specific asset identifiers created successfully
           content:
             application/json:
               schema:

From 8c2d0066ae059be1e37dc7788cef65c403f4238d Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:26:51 +0100
Subject: [PATCH 12/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index a94bb5ee..69c255af 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -23,7 +23,7 @@ paths:
       deprecated: true
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
+      summary: Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID
       operationId: GetAllAssetAdministrationShellIdsByAssetLink
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/0

From bcbf3ed42e26ef24b644b8fc7137f530d20b8080 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:27:08 +0100
Subject: [PATCH 13/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 69c255af..366e95e4 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -51,7 +51,7 @@ paths:
     post:
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Returns a list of Asset Administration Shell ids linked to specific Asset identifiers 
+      summary: Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID
       operationId: SearchAllAssetAdministrationShellIdsByAssetLink
       x-semanticIds:
         - https://admin-shell.io/aas/API/SearchAllAssetAdministrationShellIdsByAssetLink/3/1

From 515fba20dae63a4c53f82cbb80d35ed0433f4501 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:27:45 +0100
Subject: [PATCH 14/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 366e95e4..8b2ef752 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -59,7 +59,7 @@ paths:
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor'
       requestBody:
-        description: A list of specific asset identifiers. Search for the global asset ID is supported by setting "name"  to "globalAssetId" (see Constraint AASd-077).
+        description: A list of specific asset identifiers. Search for the global asset ID is supported by setting "name"  to "globalAssetId" (see Constraint AASd-116).
         content:
           application/json:
             schema:

From 427eaa915edcbf374850293b93ac984baa8cfb60 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:27:56 +0100
Subject: [PATCH 15/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 8b2ef752..5f338e6f 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -91,7 +91,7 @@ paths:
     get:
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Returns a list of specific asset identifiers based on an Asset Administration Shell ID to edit discoverable content. The global asset ID is returned as specific asset ID with "name" equal to "globalAssetId" (see Constraint AASd-077).
+      summary: Returns a list of specific asset identifiers based on an Asset Administration Shell ID to edit discoverable content. The global asset ID is returned as specific asset ID with "name" equal to "globalAssetId" (see Constraint AASd-116).
       operationId: GetAllAssetLinksById
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0

From a760420edd4206516ba3e0cc9454d661975aec50 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:30:30 +0100
Subject: [PATCH 16/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 5f338e6f..4f8a1398 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -97,7 +97,7 @@ paths:
         - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0
       responses:
         '200':
-          description: Requested specific Asset identifiers
+          description: Requested specific Asset identifiers (including the global asset ID represented by a specific asset ID)
           content:
             application/json:
               schema:

From 101dd017793d7300502832c5753071c8a008c4ab Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:37:29 +0100
Subject: [PATCH 17/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 4f8a1398..236e418b 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: DotAAS Part 2 | HTTP/REST | Discovery Service Specification (V3.1 Draft, not released)
   description: >-
-    The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell: Part 2](https://industrialdigitaltwin.org/en/content-hub/aasspecifications).  
+    The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell - Part 2: API](https://industrialdigitaltwin.org/en/content-hub/aasspecifications).  
     
     Publisher: Industrial Digital Twin Association (IDTA) April 2023
   contact:

From 3c6f1d09a36d6712aee685a4923bb94335b1a3f5 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:37:41 +0100
Subject: [PATCH 18/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 236e418b..2477b88a 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -4,7 +4,7 @@ info:
   description: >-
     The entire Full Profile of the Discovery Service Specification as part of the [Specification of the Asset Administration Shell - Part 2: API](https://industrialdigitaltwin.org/en/content-hub/aasspecifications).  
     
-    Publisher: Industrial Digital Twin Association (IDTA) April 2023
+    Publisher: Industrial Digital Twin Association (IDTA) January 2025
   contact:
     name: Industrial Digital Twin Association (IDTA)
     email: info@idtwin.org

From 2ba6224448c95d0e775abd7240446020edd6fe95 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:37:57 +0100
Subject: [PATCH 19/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 2477b88a..c1a1eed6 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -26,7 +26,7 @@ paths:
       summary: Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID
       operationId: GetAllAssetAdministrationShellIdsByAssetLink
       x-semanticIds:
-        - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/0
+        - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/1
       parameters:
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetIds'
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'

From 8e3fa32508ca1aba388296c07d794c323b7bf693 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:38:14 +0100
Subject: [PATCH 20/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index c1a1eed6..0809ce3e 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -94,7 +94,7 @@ paths:
       summary: Returns a list of specific asset identifiers based on an Asset Administration Shell ID to edit discoverable content. The global asset ID is returned as specific asset ID with "name" equal to "globalAssetId" (see Constraint AASd-116).
       operationId: GetAllAssetLinksById
       x-semanticIds:
-        - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0
+        - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/1
       responses:
         '200':
           description: Requested specific Asset identifiers (including the global asset ID represented by a specific asset ID)

From 23cc02ba82fbf6ff9a35932ec0bed1503db797e2 Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:40:11 +0100
Subject: [PATCH 21/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 0809ce3e..aef15450 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -116,7 +116,7 @@ paths:
       x-semanticIds:
         - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0
       requestBody:
-        description: A list of specific asset identifiers
+        description: A set of specific asset identifiers
         content:
           application/json:
             schema:

From 50ed1ff251d3d475a741f1d4fdbb32234ae67013 Mon Sep 17 00:00:00 2001
From: Sebastian Bader <s.bader@sap.com>
Date: Thu, 2 Jan 2025 15:46:53 +0100
Subject: [PATCH 22/25] correct links from v3.0.1 to v3.1.0

---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 5f338e6f..2ed58e85 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -122,7 +122,7 @@ paths:
             schema:
               type: array
               items:
-                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
+                $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
         required: true
       responses:
         '201':
@@ -132,7 +132,7 @@ paths:
               schema:
                 type: array
                 items:
-                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.0.1#/components/schemas/SpecificAssetId'
+                  $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/SpecificAssetId'
         '400':
           $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/bad-request'
         '404':

From c828a24c1d279519759535a32874f797d7f75ebe Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:51:41 +0100
Subject: [PATCH 23/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index aef15450..22b4fe77 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -144,7 +144,7 @@ paths:
     delete:
       tags:
         - Asset Administration Shell Basic Discovery API
-      summary: Deletes all specific Asset identifiers linked to an Asset Administration Shell to edit discoverable content
+      summary: Deletes specified specific asset identifiers linked to an Asset Administration Shell: discovery via these specific asset IDs shall not be supported any longer
       operationId: DeleteAllAssetLinksById
       x-semanticIds:
         - https://admin-shell.io/aas/API/DeleteAllAssetLinksById/3/0

From d80bfeef70aceabfa14ffbda733fc866b185241b Mon Sep 17 00:00:00 2001
From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com>
Date: Thu, 2 Jan 2025 15:52:10 +0100
Subject: [PATCH 24/25] Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml

Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index 22b4fe77..fe6bc86b 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -150,7 +150,7 @@ paths:
         - https://admin-shell.io/aas/API/DeleteAllAssetLinksById/3/0
       responses:
         '204':
-          description: Specific Asset identifiers deleted successfully
+          description: Specific asset identifiers deleted successfully
         '404':
           $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/responses/not-found'
         default:

From 39c6a4f2f9b7ad6cf644760ffe69f9ea89051ae1 Mon Sep 17 00:00:00 2001
From: Sebastian Bader <s.bader@sap.com>
Date: Thu, 2 Jan 2025 16:00:05 +0100
Subject: [PATCH 25/25] undo x-semanticId change for unchanged api operations

---
 DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
index d986aa12..21bffcf2 100644
--- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
+++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml
@@ -26,7 +26,7 @@ paths:
       summary: Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID
       operationId: GetAllAssetAdministrationShellIdsByAssetLink
       x-semanticIds:
-        - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/1
+        - https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/0
       parameters:
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetIds'
         - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit'
@@ -94,7 +94,7 @@ paths:
       summary: Returns a list of specific asset identifiers based on an Asset Administration Shell ID to edit discoverable content. The global asset ID is returned as specific asset ID with "name" equal to "globalAssetId" (see Constraint AASd-116).
       operationId: GetAllAssetLinksById
       x-semanticIds:
-        - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/1
+        - https://admin-shell.io/aas/API/GetAllAssetLinksById/3/0
       responses:
         '200':
           description: Requested specific Asset identifiers (including the global asset ID represented by a specific asset ID)