@meshery/schemas 1.0.9 → 1.1.1

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

@@ -0,0 +1,1348 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+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"];
+    };
+}
+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;
+            /**
+             * 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;
+                /**
+                 * 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;
+    };
+}
+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;
+                            /**
+                             * 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;
+                        /**
+                         * 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;
+                        /**
+                         * 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;
+                        /**
+                         * 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;
+                };
+            };
+        };
+    };
+}
+interface external {
+}
+
+export type { components, external, operations, paths };