api specs

Author: prkhrkat

specs/app_create_api.yaml

@@ -3,7 +3,7 @@ info:
   version: 1.0.0
   title: Create App Api
 paths:
-  /orchestrator/core/v1beta1/application/{appId}:
+  /core/v1beta1/application/{appId}:
     get:
       description: Get all details of an app by appId. These details include - metadata(appName, projectNamr, labels), gitMaterials, docker config, templates, workflows, configMaps, secrets, environment override configurations.
       operationId: GetAppAllDetail
@@ -108,7 +108,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
-  /orchestrator/core/v1beta1/application:
+  /core/v1beta1/application:
     post:
       description: Creates a new app for the configurations provided. The input json object is the same we get in response of GET method for fetching all details of an app
       operationId: CreateApp
@@ -121,11 +121,21 @@ paths:
               $ref: '#/components/schemas/AppDetail'
       responses:
         '200':
-          description: Successfully return a message stating the operation is successful.
+          description: Successfully created the application
           content:
             application/json:
               schema:
-                type: string
+                type: object
+                properties:
+                  code:
+                    type: integer
+                    description: HTTP status code
+                  status:
+                    type: string
+                    description: Status message
+                  result:
+                    type: string
+                    description: Success message
         '400':
           description: Bad Request. Validation error/wrong request body.
           content:

specs/applisting.yaml

@@ -3,7 +3,7 @@ info:
   version: 1.0.0
   title: Devtron Labs
 paths:
-  /orchestrator/app/autocomplete:
+  /app/autocomplete:
     get:
       description: list of namespaces group by clusters
       parameters:
@@ -60,6 +60,69 @@ components:
         name:
           type: string
           description: app name
+        teamId:
+          type: integer
+          description: project id
+        teamName:
+          type: string
+          description: project name
+        active:
+          type: boolean
+          description: whether app is active
+        createdOn:
+          type: string
+          format: date-time
+          description: creation timestamp
+        createdBy:
+          type: string
+          description: creator's name
+        updatedOn:
+          type: string
+          format: date-time
+          description: last update timestamp
+        material:
+          type: array
+          description: git materials
+          items:
+            $ref: '#/components/schemas/GitMaterial'
+        labels:
+          type: array
+          description: app labels
+          items:
+            $ref: '#/components/schemas/AppLabel'
+    AppLabel:
+      type: object
+      properties:
+        key:
+          type: string
+          description: label key
+        value:
+          type: string
+          description: label value
+        propagate:
+          type: boolean
+          description: whether to propagate to kubernetes resources
+    GitMaterial:
+      type: object
+      properties:
+        id:
+          type: integer
+          description: material id
+        gitProviderId:
+          type: integer
+          description: git provider id
+        gitProviderUrl:
+          type: string
+          description: git provider url
+        gitRepoUrl:
+          type: string
+          description: git repository url
+        checkoutPath:
+          type: string
+          description: checkout path
+        fetchSubmodules:
+          type: boolean
+          description: whether to fetch submodules
     ErrorResponse:
       required:
         - code

specs/cluster_api_spec.yaml

@@ -12,7 +12,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
 servers:
-  - url: http://localhost:8080/orchestrator
+  - url: http://localhost:8080
 paths:
   /cluster:
     put:
@@ -155,6 +155,25 @@ components:
         agentInstallationStage:
           type: integer
           description: agent installation stage
+        createdOn:
+          type: string
+          format: date-time
+          description: creation timestamp
+        updatedOn:
+          type: string
+          format: date-time
+          description: last update timestamp
+        createdBy:
+          type: string
+          description: creator's name
+        updatedBy:
+          type: string
+          description: last updater's name
+        defaultClusterComponent:
+          type: array
+          description: default cluster components
+          items:
+            $ref: '#/components/schemas/DefaultClusterComponent'
     PrometheusAuth:
       type: object
       properties:
@@ -196,6 +215,26 @@ components:
         errorInConnecting:
           type: string
           description: error message if cluster failed to connect
+        isVirtualCluster:
+          type: boolean
+          description: whether cluster is virtual
+        serverUrl:
+          type: string
+          description: cluster server URL
+        config:
+          type: object
+          description: cluster configuration
+          properties:
+            bearerToken:
+              type: string
+              description: bearer token for cluster access
+            tlsConfig:
+              type: object
+              description: TLS configuration
+              properties:
+                insecureSkipTLSVerify:
+                  type: boolean
+                  description: whether to skip TLS verification
 
     ErrorResponse:
       required: