update description for update endpoints to better explains use

Author: Leopold-Cramer

doc/Apis/RunnerApi.md

@@ -391,7 +391,7 @@ Update a runner
 | **organization\_id** | **String**| the Organization identifier | [default to null] |
 | **workspace\_id** | **String**| the Workspace identifier | [default to null] |
 | **runner\_id** | **String**| the Runner identifier | [default to null] |
-| **Runner** | [**Runner**](../Models/Runner.md)| the new Runner details. This endpoint can't be used to update security | |
+| **Runner** | [**Runner**](../Models/Runner.md)| the new Runner details. This endpoint can't be used to update ':' - id - ownerId - organizationId - workspaceId - creationDate - security | |
 
 ### Return type
 

doc/Apis/ScenarioApi.md

@@ -590,7 +590,7 @@ Update a scenario
 | **organization\_id** | **String**| the Organization identifier | [default to null] |
 | **workspace\_id** | **String**| the Workspace identifier | [default to null] |
 | **scenario\_id** | **String**| the Scenario identifier | [default to null] |
-| **Scenario** | [**Scenario**](../Models/Scenario.md)| the new Scenario details. This endpoint can't be used to update security | |
+| **Scenario** | [**Scenario**](../Models/Scenario.md)| the new Scenario details. This endpoint can't be used to update ':' - id - ownerId - datasetList - solutionId - runTemplateId - parametersValues - security | |
 
 ### Return type
 

doc/Apis/SolutionApi.md

@@ -519,7 +519,7 @@ Update a solution
 |------------- | ------------- | ------------- | -------------|
 | **organization\_id** | **String**| the Organization identifier | [default to null] |
 | **solution\_id** | **String**| the Solution identifier | [default to null] |
-| **Solution** | [**Solution**](../Models/Solution.md)| the new Solution details. This endpoint can't be used to update security | |
+| **Solution** | [**Solution**](../Models/Solution.md)| the new Solution details. This endpoint can't be used to update ':' - id - runTemplates - security | |
 
 ### Return type
 

doc/Apis/WorkspaceApi.md

@@ -518,7 +518,7 @@ Update a workspace
 |------------- | ------------- | ------------- | -------------|
 | **organization\_id** | **String**| the Organization identifier | [default to null] |
 | **workspace\_id** | **String**| the Workspace identifier | [default to null] |
-| **Workspace** | [**Workspace**](../Models/Workspace.md)| The new Workspace details. This endpoint can't be used to update security | |
+| **Workspace** | [**Workspace**](../Models/Workspace.md)| The new Workspace details. This endpoint can't be used to update ':' - id - ownerId - security | |
 
 ### Return type
 

runner/src/main/openapi/runner.yaml

@@ -2,15 +2,26 @@ openapi: 3.0.3
 
 info:
   title: Cosmo Tech Runner Manager API
-  description: Cosmo Tech Runner Manager API
+  description: |
+    Cosmo Tech Runner Manager API
+    
+    This API provides endpoints to manage runners for simulations and analyses.
   version: 0.0.8-SNAPSHOT
+  contact:
+    name: Cosmo Tech Support
+    url: https://support.cosmotech.com
+    email: [email protected]
 
 servers:
 - url: 'https://api.azure.cosmo-platform.com'
+  description: Production server
 - url: 'http://localhost:4010'
+  description: Local development server
 
 security:
-- oAuth2AuthCode: [ ]
+- oAuth2AuthCode: 
+  - platform.runner.read
+  - platform.runner.write
 
 tags:
 - name: runner
@@ -143,7 +154,14 @@ paths:
         - runner
       summary: Update a runner
       requestBody:
-        description: the new Runner details. This endpoint can't be used to update security
+        description: the new Runner details.
+          This endpoint can't be used to update ':'
+            - id 
+            - ownerId
+            - organizationId
+            - workspaceId
+            - creationDate
+            - security
         required: true
         content:
           application/json:

scenario/src/main/openapi/scenario.yaml

@@ -240,7 +240,15 @@ paths:
         - scenario
       summary: Update a scenario
       requestBody:
-        description: the new Scenario details. This endpoint can't be used to update security
+        description: the new Scenario details.
+          This endpoint can't be used to update ':'
+            - id
+            - ownerId
+            - datasetList
+            - solutionId
+            - runTemplateId
+            - parametersValues
+            - security
         required: true
         content:
           application/json:

solution/src/main/openapi/solution.yaml

@@ -127,7 +127,11 @@ paths:
         - solution
       summary: Update a solution
       requestBody:
-        description: the new Solution details. This endpoint can't be used to update security
+        description: the new Solution details.
+          This endpoint can't be used to update ':'
+            - id
+            - runTemplates
+            - security
         required: true
         content:
           application/json:

workspace/src/main/openapi/workspace.yaml

@@ -126,7 +126,11 @@ paths:
         - workspace
       summary: Update a workspace
       requestBody:
-        description: The new Workspace details. This endpoint can't be used to update security
+        description: The new Workspace details.
+          This endpoint can't be used to update ':'
+            - id
+            - ownerId
+            - security
         required: true
         content:
           application/json: