fix(openapi): update connector-mgmt/v1 OpenAPI document (#153)

Co-authored-by: app-services-ci <app-services-ci@users.noreply.github.com>

Author: app-services-ci

.openapi/connector_mgmt.yaml

@@ -86,6 +86,8 @@ paths:
       parameters:
         - $ref: "#/components/parameters/page"
         - $ref: "#/components/parameters/size"
+        - $ref: "#/components/parameters/orderBy"
+        - $ref: "#/components/parameters/search"
       responses:
         "200":
           content:
@@ -176,6 +178,7 @@ paths:
       security:
         - Bearer: [ ]
       summary: Create a new connector
+
     get:
       tags:
         - Connectors
@@ -599,6 +602,7 @@ paths:
         - Bearer: [ ]
       operationId: deleteConnectorCluster
       summary: Delete a connector cluster
+
   /api/connector_mgmt/v1/kafka_connector_clusters/{connector_cluster_id}/addon_parameters:
     parameters:
       - name: connector_cluster_id
@@ -654,10 +658,15 @@ components:
     ConnectorType:
       description: >-
         Represents a connector type supported by the API
-      required:
-        - name
-        - version
-        - json_schema
+      oneOf:
+        - required:
+          - name
+          - version
+          - schema
+        - required:
+            - name
+            - version
+            - json_schema
       allOf:
         - $ref: "#/components/schemas/ObjectReference"
         - type: object
@@ -685,6 +694,11 @@ components:
               items:
                 type: string
                 enum: [ sink, source ]
+            schema:
+              description: >-
+                A json schema that can be used to validate a connectors
+                connector_spec field.
+              type: object # todo: replace with better type
             json_schema:
               description: >-
                 A json schema that can be used to validate a connectors
@@ -759,38 +773,34 @@ components:
             `GET /api/connector_mgmt/v1/kafka_connector_types/{connector_type_id}`.
 
     ClusterTarget:
-      required:
-        - kind
-      properties:
-        kind:
-          type: string
-      type: object
       discriminator:
         propertyName: kind
         mapping:
           addon: "#/components/schemas/AddonClusterTarget"
           cloud_provider: "#/components/schemas/CloudProviderClusterTarget"
+      oneOf:
+        - $ref: "#/components/schemas/AddonClusterTarget"
+        - $ref: "#/components/schemas/CloudProviderClusterTarget"
 
     AddonClusterTarget:
-      allOf:
-        - $ref: "#/components/schemas/ClusterTarget"
-        - $ref: "#/components/schemas/AddonClusterTarget_allOf"
-
-    AddonClusterTarget_allOf:
       description: "Targets workloads to an addon cluster"
       type: object
+      required:
+        - kind
       properties:
+        kind:
+          type: string
         cluster_id:
           type: string
 
     CloudProviderClusterTarget:
-      allOf:
-        - $ref: "#/components/schemas/ClusterTarget"
-        - $ref: "#/components/schemas/CloudProviderClusterTarget_allOf"
-    CloudProviderClusterTarget_allOf:
       description: "Targets workloads to a cloud provider"
       type: object
+      required:
+        - kind
       properties:
+        kind:
+          type: string
         cloud_provider:
           type: string
         region: