@meshery/schemas 1.2.15 → 1.2.16

package/dist/constructs/v1beta3/connection/Connection.d.ts

@@ -0,0 +1,1414 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+  "/api/integrations/connections": {
+    /** Returns a paginated list of connections for the authenticated user with filtering, sorting and pagination support */
+    get: operations["getConnections"];
+    /** Register a new connection with credentials */
+    post: operations["registerConnection"];
+  };
+  "/api/integrations/connections/{connectionId}": {
+    /** Returns a specific connection by its ID */
+    get: operations["getConnectionById"];
+    /** Update an existing connection */
+    put: operations["updateConnection"];
+    /** Delete a specific connection */
+    delete: operations["deleteConnection"];
+  };
+  "/api/integrations/connections/meshery/{mesheryServerId}": {
+    /** Delete a Meshery server connection by server ID */
+    delete: operations["deleteMesheryConnection"];
+  };
+  "/api/integrations/connections/kubernetes/{connectionId}/context": {
+    /** Get Kubernetes context for a specific connection */
+    get: operations["getKubernetesContext"];
+  };
+  "/api/environments/{environmentId}/connections/{connectionId}": {
+    /** Associate a connection with an environment */
+    post: operations["addConnectionToEnvironment"];
+    /** Disassociate a connection from an environment */
+    delete: operations["removeConnectionFromEnvironment"];
+  };
+}
+
+export interface components {
+  schemas: {
+    /** @description Meshery Connections are managed and unmanaged resources that either through discovery or manual entry are tracked by Meshery. Learn more at https://docs.meshery.io/concepts/logical/connections */
+    Connection: {
+      /**
+       * Format: uuid
+       * @description Connection ID
+       */
+      id: string;
+      /** @description Connection Name */
+      name: string;
+      /** @description Human-readable description of the connection and its purpose. */
+      description?: string;
+      /**
+       * Format: uri
+       * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+       */
+      url?: string;
+      /**
+       * Format: uuid
+       * @description Associated Credential ID
+       */
+      credentialId?: string;
+      /** @description Connection Type (platform, telemetry, collaboration) */
+      type: string;
+      /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+      subType: string;
+      /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+      kind: string;
+      /** @description Additional connection metadata */
+      metadata?: { [key: string]: unknown };
+      /**
+       * @description Connection Status
+       * @enum {string}
+       */
+      status:
+        | "discovered"
+        | "registered"
+        | "connected"
+        | "ignored"
+        | "maintenance"
+        | "disconnected"
+        | "deleted"
+        | "not found";
+      /**
+       * Format: uuid
+       * @description User ID who owns this connection
+       */
+      userId?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the connection was created.
+       */
+      createdAt?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the connection was last updated.
+       */
+      updatedAt?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the connection was soft-deleted, if applicable.
+       */
+      deletedAt?: string;
+      /** @description Associated environments for this connection */
+      environments?: {
+        /**
+         * Format: uuid
+         * @description ID
+         */
+        id: string;
+        /**
+         * @description Specifies the version of the schema to which the environment conforms.
+         * @default environments.meshery.io/v1beta3
+         * @example [
+         *   "v1",
+         *   "v1alpha1",
+         *   "v2beta3",
+         *   "v1.custom-suffix",
+         *   "models.meshery.io/v1beta1",
+         *   "capability.meshery.io/v1alpha1"
+         * ]
+         */
+        schemaVersion: string;
+        /** @description Environment name */
+        name: string;
+        /** @description Environment description */
+        description: string;
+        /**
+         * Format: uuid
+         * @description Environment organization ID
+         */
+        organizationId: string;
+        /**
+         * Format: uuid
+         * @description Environment owner
+         */
+        owner?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the environment was created.
+         */
+        createdAt?: string;
+        /** @description Additional metadata associated with the environment. */
+        metadata?: { [key: string]: unknown };
+        /**
+         * Format: date-time
+         * @description Timestamp when the environment was last updated.
+         */
+        updatedAt?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+         */
+        deletedAt?: string | null;
+      }[];
+      /**
+       * @description Specifies the version of the schema used for the definition.
+       * @default connections.meshery.io/v1beta3
+       * @example [
+       *   "v1",
+       *   "v1alpha1",
+       *   "v2beta3",
+       *   "v1.custom-suffix",
+       *   "models.meshery.io/v1beta1",
+       *   "capability.meshery.io/v1alpha1"
+       * ]
+       */
+      schemaVersion: string;
+    };
+    /** @description Represents a page of connections with meta information about connections count */
+    ConnectionPage: {
+      /** @description List of connections on this page */
+      connections: {
+        /**
+         * Format: uuid
+         * @description Connection ID
+         */
+        id: string;
+        /** @description Connection Name */
+        name: string;
+        /** @description Human-readable description of the connection and its purpose. */
+        description?: string;
+        /**
+         * Format: uri
+         * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+         */
+        url?: string;
+        /**
+         * Format: uuid
+         * @description Associated Credential ID
+         */
+        credentialId?: string;
+        /** @description Connection Type (platform, telemetry, collaboration) */
+        type: string;
+        /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+        subType: string;
+        /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+        kind: string;
+        /** @description Additional connection metadata */
+        metadata?: { [key: string]: unknown };
+        /**
+         * @description Connection Status
+         * @enum {string}
+         */
+        status:
+          | "discovered"
+          | "registered"
+          | "connected"
+          | "ignored"
+          | "maintenance"
+          | "disconnected"
+          | "deleted"
+          | "not found";
+        /**
+         * Format: uuid
+         * @description User ID who owns this connection
+         */
+        userId?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the connection was created.
+         */
+        createdAt?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the connection was last updated.
+         */
+        updatedAt?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the connection was soft-deleted, if applicable.
+         */
+        deletedAt?: string;
+        /** @description Associated environments for this connection */
+        environments?: {
+          /**
+           * Format: uuid
+           * @description ID
+           */
+          id: string;
+          /**
+           * @description Specifies the version of the schema to which the environment conforms.
+           * @default environments.meshery.io/v1beta3
+           * @example [
+           *   "v1",
+           *   "v1alpha1",
+           *   "v2beta3",
+           *   "v1.custom-suffix",
+           *   "models.meshery.io/v1beta1",
+           *   "capability.meshery.io/v1alpha1"
+           * ]
+           */
+          schemaVersion: string;
+          /** @description Environment name */
+          name: string;
+          /** @description Environment description */
+          description: string;
+          /**
+           * Format: uuid
+           * @description Environment organization ID
+           */
+          organizationId: string;
+          /**
+           * Format: uuid
+           * @description Environment owner
+           */
+          owner?: string;
+          /**
+           * Format: date-time
+           * @description Timestamp when the environment was created.
+           */
+          createdAt?: string;
+          /** @description Additional metadata associated with the environment. */
+          metadata?: { [key: string]: unknown };
+          /**
+           * Format: date-time
+           * @description Timestamp when the environment was last updated.
+           */
+          updatedAt?: string;
+          /**
+           * Format: date-time
+           * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+           */
+          deletedAt?: string | null;
+        }[];
+        /**
+         * @description Specifies the version of the schema used for the definition.
+         * @default connections.meshery.io/v1beta3
+         * @example [
+         *   "v1",
+         *   "v1alpha1",
+         *   "v2beta3",
+         *   "v1.custom-suffix",
+         *   "models.meshery.io/v1beta1",
+         *   "capability.meshery.io/v1alpha1"
+         * ]
+         */
+        schemaVersion: string;
+      }[];
+      /** @description Total number of connections on all pages */
+      totalCount: number;
+      /** @description Current page number */
+      page: number;
+      /** @description Number of elements per page */
+      pageSize: number;
+      /** @description Aggregate count of connections grouped by status */
+      statusSummary?: { [key: string]: number };
+    };
+    /**
+     * @description Connection Status Value
+     * @enum {string}
+     */
+    ConnectionStatusValue:
+      | "discovered"
+      | "registered"
+      | "connected"
+      | "ignored"
+      | "maintenance"
+      | "disconnected"
+      | "deleted"
+      | "not found";
+    /** @description Payload for creating or updating a connection */
+    ConnectionPayload: {
+      /**
+       * Format: uuid
+       * @description Connection ID
+       */
+      id?: string;
+      /** @description Connection name */
+      name: string;
+      /** @description Connection kind */
+      kind: string;
+      /** @description Connection type */
+      type: string;
+      /** @description Connection sub-type */
+      subType: string;
+      /** @description Credential secret data */
+      credentialSecret?: { [key: string]: unknown };
+      /** @description Connection metadata */
+      metadata?: { [key: string]: unknown };
+      /** @description Connection status */
+      status: string;
+      /**
+       * Format: uuid
+       * @description Associated credential ID
+       */
+      credentialId?: string;
+    };
+    /** @description Status count information for connections */
+    ConnectionStatusInfo: {
+      /** @description Status value */
+      status: string;
+      /** @description Number of connections with this status */
+      count: number;
+    };
+    /** @description Paginated list of connection status counts */
+    ConnectionsStatusPage: {
+      /** @description Total number of status entries */
+      totalCount: number;
+      /** @description Current page number */
+      page: number;
+      /** @description Number of items per page */
+      pageSize: number;
+      /** @description List of status counts */
+      connectionsStatus: {
+        /** @description Status value */
+        status: string;
+        /** @description Number of connections with this status */
+        count: number;
+      }[];
+    };
+    /** @description Meshery server instance information */
+    MesheryInstance: {
+      /**
+       * Format: uuid
+       * @description Instance ID
+       */
+      id?: string;
+      /** @description Instance name */
+      name?: string;
+      /**
+       * Format: uuid
+       * @description Server ID
+       */
+      serverId?: string;
+      /** @description Meshery server version */
+      serverVersion?: string;
+      /** @description Server location URL */
+      serverLocation?: string;
+      /** @description Server build SHA */
+      serverBuildSha?: string;
+      /**
+       * Format: date-time
+       * @description Creation timestamp
+       */
+      createdAt?: string;
+      /**
+       * Format: date-time
+       * @description Last update timestamp
+       */
+      updatedAt?: string;
+      /**
+       * Format: date-time
+       * @description Deletion timestamp
+       */
+      deletedAt?: string;
+    };
+    /** @description Paginated list of Meshery instances */
+    MesheryInstancePage: {
+      /** @description List of Meshery instances */
+      mesheryInstances: {
+        /**
+         * Format: uuid
+         * @description Instance ID
+         */
+        id?: string;
+        /** @description Instance name */
+        name?: string;
+        /**
+         * Format: uuid
+         * @description Server ID
+         */
+        serverId?: string;
+        /** @description Meshery server version */
+        serverVersion?: string;
+        /** @description Server location URL */
+        serverLocation?: string;
+        /** @description Server build SHA */
+        serverBuildSha?: string;
+        /**
+         * Format: date-time
+         * @description Creation timestamp
+         */
+        createdAt?: string;
+        /**
+         * Format: date-time
+         * @description Last update timestamp
+         */
+        updatedAt?: string;
+        /**
+         * Format: date-time
+         * @description Deletion timestamp
+         */
+        deletedAt?: string;
+      }[];
+      /** @description Current page number */
+      page: number;
+      /** @description Number of items per page */
+      pageSize: number;
+      /** @description Total number of instances */
+      totalCount: number;
+    };
+    /** @description Meshery version compatibility check */
+    MesheryCompatibility: {
+      /** @description Meshery version string */
+      mesheryVersion?: string;
+      /** @description Whether to check compatibility */
+      checkCompatibility?: boolean;
+    };
+  };
+  responses: {
+    /** Invalid request body or request param */
+    400: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Expired JWT token used or insufficient privilege */
+    401: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Result not found */
+    404: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Internal server error */
+    500: {
+      content: {
+        "text/plain": string;
+      };
+    };
+  };
+  parameters: {
+    /** @description Connection ID */
+    connectionId: string;
+    /** @description Connection kind (meshery, kubernetes, prometheus, grafana, etc.) */
+    connectionKind: string;
+    /** @description Environment ID */
+    environmentId: string;
+    /** @description Meshery server ID */
+    mesheryServerId: string;
+    /** @description Page number */
+    page: number;
+    /** @description Number of items per page */
+    pageSize: number;
+    /** @description Search term */
+    search: string;
+    /** @description Sort order */
+    order: string;
+    /** @description Organization ID to scope the request. */
+    orgIdQuery: string;
+  };
+}
+
+export interface operations {
+  /** Returns a paginated list of connections for the authenticated user with filtering, sorting and pagination support */
+  getConnections: {
+    parameters: {
+      query: {
+        /** Page number */
+        page?: number;
+        /** Number of items per page */
+        pageSize?: number;
+        /** Search term */
+        search?: string;
+        /** Sort order */
+        order?: string;
+        /** Organization ID to scope the request. */
+        orgId?: string;
+        /** Filter connections (general filter string) */
+        filter?: string;
+        /** Filter by connection kind (e.g., kubernetes, prometheus, grafana) */
+        kind?: string[];
+        /** Filter by connection status */
+        status?: (
+          | "discovered"
+          | "registered"
+          | "connected"
+          | "ignored"
+          | "maintenance"
+          | "disconnected"
+          | "deleted"
+          | "not found"
+        )[];
+        /** Filter by connection type */
+        type?: string[];
+        /** Filter by connection name (partial match supported) */
+        name?: string;
+      };
+    };
+    responses: {
+      /** Paginated list of connections with summary information */
+      200: {
+        content: {
+          "application/json": {
+            /** @description List of connections on this page */
+            connections: {
+              /**
+               * Format: uuid
+               * @description Connection ID
+               */
+              id: string;
+              /** @description Connection Name */
+              name: string;
+              /** @description Human-readable description of the connection and its purpose. */
+              description?: string;
+              /**
+               * Format: uri
+               * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+               */
+              url?: string;
+              /**
+               * Format: uuid
+               * @description Associated Credential ID
+               */
+              credentialId?: string;
+              /** @description Connection Type (platform, telemetry, collaboration) */
+              type: string;
+              /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+              subType: string;
+              /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+              kind: string;
+              /** @description Additional connection metadata */
+              metadata?: { [key: string]: unknown };
+              /**
+               * @description Connection Status
+               * @enum {string}
+               */
+              status:
+                | "discovered"
+                | "registered"
+                | "connected"
+                | "ignored"
+                | "maintenance"
+                | "disconnected"
+                | "deleted"
+                | "not found";
+              /**
+               * Format: uuid
+               * @description User ID who owns this connection
+               */
+              userId?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the connection was created.
+               */
+              createdAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the connection was last updated.
+               */
+              updatedAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the connection was soft-deleted, if applicable.
+               */
+              deletedAt?: string;
+              /** @description Associated environments for this connection */
+              environments?: {
+                /**
+                 * Format: uuid
+                 * @description ID
+                 */
+                id: string;
+                /**
+                 * @description Specifies the version of the schema to which the environment conforms.
+                 * @default environments.meshery.io/v1beta3
+                 * @example [
+                 *   "v1",
+                 *   "v1alpha1",
+                 *   "v2beta3",
+                 *   "v1.custom-suffix",
+                 *   "models.meshery.io/v1beta1",
+                 *   "capability.meshery.io/v1alpha1"
+                 * ]
+                 */
+                schemaVersion: string;
+                /** @description Environment name */
+                name: string;
+                /** @description Environment description */
+                description: string;
+                /**
+                 * Format: uuid
+                 * @description Environment organization ID
+                 */
+                organizationId: string;
+                /**
+                 * Format: uuid
+                 * @description Environment owner
+                 */
+                owner?: string;
+                /**
+                 * Format: date-time
+                 * @description Timestamp when the environment was created.
+                 */
+                createdAt?: string;
+                /** @description Additional metadata associated with the environment. */
+                metadata?: { [key: string]: unknown };
+                /**
+                 * Format: date-time
+                 * @description Timestamp when the environment was last updated.
+                 */
+                updatedAt?: string;
+                /**
+                 * Format: date-time
+                 * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+                 */
+                deletedAt?: string | null;
+              }[];
+              /**
+               * @description Specifies the version of the schema used for the definition.
+               * @default connections.meshery.io/v1beta3
+               * @example [
+               *   "v1",
+               *   "v1alpha1",
+               *   "v2beta3",
+               *   "v1.custom-suffix",
+               *   "models.meshery.io/v1beta1",
+               *   "capability.meshery.io/v1alpha1"
+               * ]
+               */
+              schemaVersion: string;
+            }[];
+            /** @description Total number of connections on all pages */
+            totalCount: number;
+            /** @description Current page number */
+            page: number;
+            /** @description Number of elements per page */
+            pageSize: number;
+            /** @description Aggregate count of connections grouped by status */
+            statusSummary?: { [key: string]: number };
+          };
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Register a new connection with credentials */
+  registerConnection: {
+    responses: {
+      /** Connection registered */
+      201: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Connection ID
+             */
+            id: string;
+            /** @description Connection Name */
+            name: string;
+            /** @description Human-readable description of the connection and its purpose. */
+            description?: string;
+            /**
+             * Format: uri
+             * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+             */
+            url?: string;
+            /**
+             * Format: uuid
+             * @description Associated Credential ID
+             */
+            credentialId?: string;
+            /** @description Connection Type (platform, telemetry, collaboration) */
+            type: string;
+            /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+            subType: string;
+            /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+            kind: string;
+            /** @description Additional connection metadata */
+            metadata?: { [key: string]: unknown };
+            /**
+             * @description Connection Status
+             * @enum {string}
+             */
+            status:
+              | "discovered"
+              | "registered"
+              | "connected"
+              | "ignored"
+              | "maintenance"
+              | "disconnected"
+              | "deleted"
+              | "not found";
+            /**
+             * Format: uuid
+             * @description User ID who owns this connection
+             */
+            userId?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was created.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was last updated.
+             */
+            updatedAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+            /** @description Associated environments for this connection */
+            environments?: {
+              /**
+               * Format: uuid
+               * @description ID
+               */
+              id: string;
+              /**
+               * @description Specifies the version of the schema to which the environment conforms.
+               * @default environments.meshery.io/v1beta3
+               * @example [
+               *   "v1",
+               *   "v1alpha1",
+               *   "v2beta3",
+               *   "v1.custom-suffix",
+               *   "models.meshery.io/v1beta1",
+               *   "capability.meshery.io/v1alpha1"
+               * ]
+               */
+              schemaVersion: string;
+              /** @description Environment name */
+              name: string;
+              /** @description Environment description */
+              description: string;
+              /**
+               * Format: uuid
+               * @description Environment organization ID
+               */
+              organizationId: string;
+              /**
+               * Format: uuid
+               * @description Environment owner
+               */
+              owner?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was created.
+               */
+              createdAt?: string;
+              /** @description Additional metadata associated with the environment. */
+              metadata?: { [key: string]: unknown };
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was last updated.
+               */
+              updatedAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+               */
+              deletedAt?: string | null;
+            }[];
+            /**
+             * @description Specifies the version of the schema used for the definition.
+             * @default connections.meshery.io/v1beta3
+             * @example [
+             *   "v1",
+             *   "v1alpha1",
+             *   "v2beta3",
+             *   "v1.custom-suffix",
+             *   "models.meshery.io/v1beta1",
+             *   "capability.meshery.io/v1alpha1"
+             * ]
+             */
+            schemaVersion: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /**
+           * Format: uuid
+           * @description Connection ID
+           */
+          id?: string;
+          /** @description Connection name */
+          name: string;
+          /** @description Connection kind */
+          kind: string;
+          /** @description Connection type */
+          type: string;
+          /** @description Connection sub-type */
+          subType: string;
+          /** @description Credential secret data */
+          credentialSecret?: { [key: string]: unknown };
+          /** @description Connection metadata */
+          metadata?: { [key: string]: unknown };
+          /** @description Connection status */
+          status: string;
+          /**
+           * Format: uuid
+           * @description Associated credential ID
+           */
+          credentialId?: string;
+        };
+      };
+    };
+  };
+  /** Returns a specific connection by its ID */
+  getConnectionById: {
+    parameters: {
+      path: {
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Connection details */
+      200: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Connection ID
+             */
+            id: string;
+            /** @description Connection Name */
+            name: string;
+            /** @description Human-readable description of the connection and its purpose. */
+            description?: string;
+            /**
+             * Format: uri
+             * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+             */
+            url?: string;
+            /**
+             * Format: uuid
+             * @description Associated Credential ID
+             */
+            credentialId?: string;
+            /** @description Connection Type (platform, telemetry, collaboration) */
+            type: string;
+            /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+            subType: string;
+            /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+            kind: string;
+            /** @description Additional connection metadata */
+            metadata?: { [key: string]: unknown };
+            /**
+             * @description Connection Status
+             * @enum {string}
+             */
+            status:
+              | "discovered"
+              | "registered"
+              | "connected"
+              | "ignored"
+              | "maintenance"
+              | "disconnected"
+              | "deleted"
+              | "not found";
+            /**
+             * Format: uuid
+             * @description User ID who owns this connection
+             */
+            userId?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was created.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was last updated.
+             */
+            updatedAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+            /** @description Associated environments for this connection */
+            environments?: {
+              /**
+               * Format: uuid
+               * @description ID
+               */
+              id: string;
+              /**
+               * @description Specifies the version of the schema to which the environment conforms.
+               * @default environments.meshery.io/v1beta3
+               * @example [
+               *   "v1",
+               *   "v1alpha1",
+               *   "v2beta3",
+               *   "v1.custom-suffix",
+               *   "models.meshery.io/v1beta1",
+               *   "capability.meshery.io/v1alpha1"
+               * ]
+               */
+              schemaVersion: string;
+              /** @description Environment name */
+              name: string;
+              /** @description Environment description */
+              description: string;
+              /**
+               * Format: uuid
+               * @description Environment organization ID
+               */
+              organizationId: string;
+              /**
+               * Format: uuid
+               * @description Environment owner
+               */
+              owner?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was created.
+               */
+              createdAt?: string;
+              /** @description Additional metadata associated with the environment. */
+              metadata?: { [key: string]: unknown };
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was last updated.
+               */
+              updatedAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+               */
+              deletedAt?: string | null;
+            }[];
+            /**
+             * @description Specifies the version of the schema used for the definition.
+             * @default connections.meshery.io/v1beta3
+             * @example [
+             *   "v1",
+             *   "v1alpha1",
+             *   "v2beta3",
+             *   "v1.custom-suffix",
+             *   "models.meshery.io/v1beta1",
+             *   "capability.meshery.io/v1alpha1"
+             * ]
+             */
+            schemaVersion: string;
+          };
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Update an existing connection */
+  updateConnection: {
+    parameters: {
+      path: {
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Connection updated */
+      200: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Connection ID
+             */
+            id: string;
+            /** @description Connection Name */
+            name: string;
+            /** @description Human-readable description of the connection and its purpose. */
+            description?: string;
+            /**
+             * Format: uri
+             * @description URL of the remote resource this connection points to (e.g. the Helm repository URL, the Kubernetes API server endpoint, the Grafana instance URL).
+             */
+            url?: string;
+            /**
+             * Format: uuid
+             * @description Associated Credential ID
+             */
+            credentialId?: string;
+            /** @description Connection Type (platform, telemetry, collaboration) */
+            type: string;
+            /** @description Connection Subtype (cloud, identity, metrics, chat, git, orchestration) */
+            subType: string;
+            /** @description Connection Kind (meshery, kubernetes, prometheus, grafana, gke, aws, azure, slack, github) */
+            kind: string;
+            /** @description Additional connection metadata */
+            metadata?: { [key: string]: unknown };
+            /**
+             * @description Connection Status
+             * @enum {string}
+             */
+            status:
+              | "discovered"
+              | "registered"
+              | "connected"
+              | "ignored"
+              | "maintenance"
+              | "disconnected"
+              | "deleted"
+              | "not found";
+            /**
+             * Format: uuid
+             * @description User ID who owns this connection
+             */
+            userId?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was created.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was last updated.
+             */
+            updatedAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the connection was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+            /** @description Associated environments for this connection */
+            environments?: {
+              /**
+               * Format: uuid
+               * @description ID
+               */
+              id: string;
+              /**
+               * @description Specifies the version of the schema to which the environment conforms.
+               * @default environments.meshery.io/v1beta3
+               * @example [
+               *   "v1",
+               *   "v1alpha1",
+               *   "v2beta3",
+               *   "v1.custom-suffix",
+               *   "models.meshery.io/v1beta1",
+               *   "capability.meshery.io/v1alpha1"
+               * ]
+               */
+              schemaVersion: string;
+              /** @description Environment name */
+              name: string;
+              /** @description Environment description */
+              description: string;
+              /**
+               * Format: uuid
+               * @description Environment organization ID
+               */
+              organizationId: string;
+              /**
+               * Format: uuid
+               * @description Environment owner
+               */
+              owner?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was created.
+               */
+              createdAt?: string;
+              /** @description Additional metadata associated with the environment. */
+              metadata?: { [key: string]: unknown };
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was last updated.
+               */
+              updatedAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the environment was soft deleted. Null while the environment remains active.
+               */
+              deletedAt?: string | null;
+            }[];
+            /**
+             * @description Specifies the version of the schema used for the definition.
+             * @default connections.meshery.io/v1beta3
+             * @example [
+             *   "v1",
+             *   "v1alpha1",
+             *   "v2beta3",
+             *   "v1.custom-suffix",
+             *   "models.meshery.io/v1beta1",
+             *   "capability.meshery.io/v1alpha1"
+             * ]
+             */
+            schemaVersion: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /**
+           * Format: uuid
+           * @description Connection ID
+           */
+          id?: string;
+          /** @description Connection name */
+          name: string;
+          /** @description Connection kind */
+          kind: string;
+          /** @description Connection type */
+          type: string;
+          /** @description Connection sub-type */
+          subType: string;
+          /** @description Credential secret data */
+          credentialSecret?: { [key: string]: unknown };
+          /** @description Connection metadata */
+          metadata?: { [key: string]: unknown };
+          /** @description Connection status */
+          status: string;
+          /**
+           * Format: uuid
+           * @description Associated credential ID
+           */
+          credentialId?: string;
+        };
+      };
+    };
+  };
+  /** Delete a specific connection */
+  deleteConnection: {
+    parameters: {
+      path: {
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Connection deleted */
+      204: never;
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Delete a Meshery server connection by server ID */
+  deleteMesheryConnection: {
+    parameters: {
+      path: {
+        /** Meshery server ID */
+        mesheryServerId: string;
+      };
+    };
+    responses: {
+      /** Meshery connection deleted */
+      204: never;
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Get Kubernetes context for a specific connection */
+  getKubernetesContext: {
+    parameters: {
+      path: {
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Kubernetes context */
+      200: {
+        content: {
+          "application/json": { [key: string]: unknown };
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Associate a connection with an environment */
+  addConnectionToEnvironment: {
+    parameters: {
+      path: {
+        /** Environment ID */
+        environmentId: string;
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Connection added to environment */
+      201: unknown;
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Disassociate a connection from an environment */
+  removeConnectionFromEnvironment: {
+    parameters: {
+      path: {
+        /** Environment ID */
+        environmentId: string;
+        /** Connection ID */
+        connectionId: string;
+      };
+    };
+    responses: {
+      /** Connection removed from environment */
+      204: never;
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+}
+
+export interface external {}