diff --git a/docs/api/administration-service.yaml b/docs/api/administration-service.yaml
index c276a3a652..7f194b93e6 100644
--- a/docs/api/administration-service.yaml
+++ b/docs/api/administration-service.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.1
 info:
   title: Org.Eclipse.TractusX.Portal.Backend.Administration.Service
-  version: v2.3.0-alpha.1
+  version: v2.3.0-alpha.2
 paths:
   /api/administration/companydata/ownCompanyDetails:
     get:
@@ -7788,6 +7788,7 @@ components:
         roleType:
           $ref: '#/components/schemas/UserRoleType'
       additionalProperties: false
+      description: Basic model for user role data needed to display user roles with description.
     UserRoleWithId:
       type: object
       properties:
diff --git a/docs/api/apps-service.yaml b/docs/api/apps-service.yaml
index 58800a0118..492cab72f8 100644
--- a/docs/api/apps-service.yaml
+++ b/docs/api/apps-service.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.1
 info:
   title: Org.Eclipse.TractusX.Portal.Backend.Apps.Service
-  version: v2.3.0-alpha.1
+  version: v2.3.0-alpha.2
 paths:
   '/api/apps/AppChange/{appId}/role/activeapp':
     post:
@@ -3762,7 +3762,14 @@ components:
           format: uuid
         roleName:
           type: string
+        type:
+          $ref: '#/components/schemas/UserRoleType'
       additionalProperties: false
+    UserRoleType:
+      enum:
+        - Internal
+        - External
+      type: string
   securitySchemes:
     Bearer:
       type: apiKey
diff --git a/docs/api/notifications-service.yaml b/docs/api/notifications-service.yaml
index f9c40168d2..009d7de7e3 100644
--- a/docs/api/notifications-service.yaml
+++ b/docs/api/notifications-service.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.1
 info:
   title: Org.Eclipse.TractusX.Portal.Backend.Notifications.Service
-  version: v2.3.0-alpha.1
+  version: v2.3.0-alpha.2
 paths:
   /api/notification/errormessage:
     get:
diff --git a/docs/api/registration-service.yaml b/docs/api/registration-service.yaml
index c807004af5..c016075024 100644
--- a/docs/api/registration-service.yaml
+++ b/docs/api/registration-service.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.1
 info:
   title: Org.Eclipse.TractusX.Portal.Backend.Registration.Service
-  version: v2.3.0-alpha.1
+  version: v2.3.0-alpha.2
 paths:
   /api/registration/errormessage:
     get:
diff --git a/docs/api/services-service.yaml b/docs/api/services-service.yaml
index 74f49491de..0a68496699 100644
--- a/docs/api/services-service.yaml
+++ b/docs/api/services-service.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.1
 info:
   title: Org.Eclipse.TractusX.Portal.Backend.Services.Service
-  version: v2.3.0-alpha.1
+  version: v2.3.0-alpha.2
 paths:
   /api/services/errormessage:
     get:
@@ -2824,7 +2824,14 @@ components:
           format: uuid
         roleName:
           type: string
+        type:
+          $ref: '#/components/schemas/UserRoleType'
       additionalProperties: false
+    UserRoleType:
+      enum:
+        - Internal
+        - External
+      type: string
   securitySchemes:
     Bearer:
       type: apiKey