sealos-cli 0.1.0 → 1.1.0

package/src/generated/devbox.ts

@@ -0,0 +1,2500 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/devbox": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all devboxes
+         * @description Retrieve all Devbox instances in the current namespace with resource and runtime information.
+         */
+        get: operations["listDevboxes"];
+        put?: never;
+        /**
+         * Create a new devbox
+         * @description Create a new Devbox instance with the specified runtime, resources, and network ports. CPU and memory quota must be in the range [0.1, 32].
+         */
+        post: operations["createDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get devbox details
+         * @description Retrieve complete configuration, runtime status, SSH connection information, ports, and pod list for a specific Devbox.
+         */
+        get: operations["getDevbox"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete a devbox
+         * @description Delete a Devbox and all associated resources (services, ingress rules, certificates, persistent volumes).
+         *
+         *     Key points:
+         *     - **Idempotent** — if the Devbox does not exist the request still returns `204`.
+         */
+        delete: operations["deleteDevbox"];
+        options?: never;
+        head?: never;
+        /**
+         * Update devbox configuration
+         * @description Update Devbox resource quota and/or port configuration. CPU and memory quota must be in the range [0.1, 32].
+         *
+         *     Key points:
+         *     - At least one of `quota` or `ports` must be provided.
+         *     - To update an existing port supply its `portName`. To add a new port omit `portName`.
+         *     - Ports not present in the `ports` array are deleted.
+         */
+        patch: operations["updateDevbox"];
+        trace?: never;
+    };
+    "/devbox/{name}/autostart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Configure devbox autostart
+         * @description Configure the command that runs automatically when the Devbox starts. If `execCommand` is omitted the default template entrypoint is used.
+         */
+        post: operations["autostartDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/start": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start a devbox
+         * @description Start a paused or stopped Devbox and restore its network ingress rules to active state.
+         *
+         *     Key points:
+         *     - **Idempotent** — calling start on an already-running Devbox returns `204`.
+         */
+        post: operations["startDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/pause": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Pause a devbox
+         * @description Pause a Devbox to stop its compute resources while preserving port allocations, reducing costs.
+         *
+         *     Key points:
+         *     - **Idempotent** — calling pause on an already-paused Devbox returns `204`.
+         */
+        post: operations["pauseDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/shutdown": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Shutdown a devbox
+         * @description Completely shut down a Devbox, releasing all compute resources and port allocations to minimise costs.
+         */
+        post: operations["shutdownDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/restart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Restart a devbox
+         * @description Trigger a complete restart cycle: stop all pods, wait for termination, restore ingress, then start the Devbox.
+         *
+         *     Key points:
+         *     - **Idempotent** — always triggers a restart regardless of the current state.
+         */
+        post: operations["restartDevbox"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/releases": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List devbox releases
+         * @description Retrieve all release versions for a Devbox, ordered by creation time descending.
+         */
+        get: operations["listDevboxReleases"];
+        put?: never;
+        /**
+         * Create a devbox release
+         * @description Snapshot the current Devbox state and trigger a container image build for the given version tag.
+         *
+         *     Key points:
+         *     - **Asynchronous** — returns `202 Accepted` immediately. The build pipeline (stop devbox → build image → restart devbox) runs in the background; poll `GET /devbox/{name}/releases` to track progress.
+         *     - By default the Devbox is restarted after the build succeeds (`startDevboxAfterRelease: true`). Set to `false` to keep the Devbox stopped after the release.
+         */
+        post: operations["createDevboxRelease"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/deployments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List deployed applications from a devbox
+         * @description Retrieve all AppLaunchpad applications that were deployed from this Devbox's releases.
+         */
+        get: operations["listDevboxDeployments"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/releases/{tag}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a devbox release
+         * @description Delete a specific release version and its associated container image.
+         *
+         *     Key points:
+         *     - **Idempotent** — if the release does not exist the request still returns `204`.
+         */
+        delete: operations["deleteDevboxRelease"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/releases/{tag}/deploy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Deploy a release to AppLaunchpad
+         * @description Deploy a successfully built release version as a production application in AppLaunchpad.
+         *
+         *     Key points:
+         *     - The release must be in `Success` status before deploying.
+         *     - Each call creates a new AppLaunchpad application; prior deployments are not replaced.
+         */
+        post: operations["deployDevboxRelease"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/{name}/monitor": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get devbox monitoring data
+         * @description Retrieve time-series CPU and memory usage metrics for a specific Devbox.
+         */
+        get: operations["getDevboxMonitor"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/devbox/templates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List available devbox templates
+         * @description Retrieve available runtime environments and their default port/command configurations for creating Devboxes.
+         */
+        get: operations["listDevboxTemplates"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: never;
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listDevboxes: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Devbox list retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Devbox name */
+                        name: string;
+                        /** @description Devbox UID */
+                        uid: string;
+                        /**
+                         * @description Resource type
+                         * @default devbox
+                         */
+                        resourceType: string;
+                        /** @description Runtime environment (e.g., go, python, node.js) */
+                        runtime: string;
+                        /**
+                         * @description Devbox status (pending, running, stopped, error)
+                         * @enum {string}
+                         */
+                        status: "pending" | "running" | "stopped" | "error";
+                        /** @description Resource quota allocation */
+                        quota: {
+                            /** @description CPU in cores (e.g., 1.0 = 1 core) */
+                            cpu: number;
+                            /** @description Memory in GB (e.g., 2.0 = 2GB) */
+                            memory: number;
+                        };
+                    }[];
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to retrieve the devbox list. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Devbox creation parameters.
+         *
+         *     **Example — Python devbox with a public HTTP port:**
+         *     ```json
+         *     {
+         *       "name": "my-python-api",
+         *       "runtime": "python",
+         *       "quota": { "cpu": 1, "memory": 2 },
+         *       "ports": [{ "number": 8080, "protocol": "http", "isPublic": true }],
+         *       "env": [],
+         *       "autostart": false
+         *     }
+         *     ```
+         *
+         *     **Example — Go devbox with environment variables and autostart:**
+         *     ```json
+         *     {
+         *       "name": "my-go-service",
+         *       "runtime": "go",
+         *       "quota": { "cpu": 0.5, "memory": 1 },
+         *       "ports": [],
+         *       "env": [{ "name": "GO_ENV", "value": "development" }],
+         *       "autostart": true
+         *     }
+         *     ```
+         *
+         *     **Example — minimal resources (floor values):**
+         *     ```json
+         *     {
+         *       "name": "my-minimal-devbox",
+         *       "runtime": "node.js",
+         *       "quota": { "cpu": 0.1, "memory": 0.1 },
+         *       "ports": [],
+         *       "env": [],
+         *       "autostart": false
+         *     }
+         *     ```
+         */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Devbox name (must be DNS compliant: lowercase, numbers, hyphens, 1-63 chars) */
+                    name: string;
+                    /**
+                     * @description Runtime environment name
+                     * @enum {string}
+                     */
+                    runtime: "nuxt3" | "angular" | "quarkus" | "ubuntu" | "flask" | "java" | "chi" | "net" | "iris" | "hexo" | "python" | "docusaurus" | "vitepress" | "cpp" | "vue" | "nginx" | "rocket" | "debian-ssh" | "vert.x" | "express.js" | "django" | "next.js" | "sealaf" | "go" | "react" | "php" | "svelte" | "c" | "astro" | "umi" | "gin" | "node.js" | "echo" | "claude-code" | "rust";
+                    /** @description Resource allocation for CPU and memory */
+                    quota: {
+                        /**
+                         * @description CPU allocation in cores
+                         * @example 1
+                         */
+                        cpu: number;
+                        /**
+                         * @description Memory allocation in GB
+                         * @example 2
+                         */
+                        memory: number;
+                    };
+                    /**
+                     * @description Port configurations (optional, can be empty)
+                     * @default []
+                     */
+                    ports?: {
+                        /** @description Port number (1-65535) */
+                        number: number;
+                        /**
+                         * @description Protocol type, defaults to HTTP
+                         * @default http
+                         * @enum {string}
+                         */
+                        protocol?: "http" | "grpc" | "ws";
+                        /**
+                         * @description Enable public domain access, defaults to true
+                         * @default true
+                         */
+                        isPublic?: boolean;
+                        /** @description Custom domain (optional) */
+                        customDomain?: string;
+                    }[];
+                    /**
+                     * @description Environment variables (optional, can be empty)
+                     * @default []
+                     */
+                    env?: {
+                        /** @description Environment variable name */
+                        name: string;
+                        /** @description Environment variable value */
+                        value?: string;
+                        /** @description Source for the environment variable value */
+                        valueFrom?: {
+                            secretKeyRef: {
+                                /** @description Secret key */
+                                key: string;
+                                /** @description Secret name */
+                                name: string;
+                            };
+                        };
+                    }[];
+                    /**
+                     * @description Auto start devbox after creation (defaults to false)
+                     * @default false
+                     */
+                    autostart?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Devbox created. SSH connection details (port, private key, domain) are provisioned synchronously and returned in this response. The container pod starts asynchronously — poll `GET /devbox/{name}` until `status` is `running` before establishing an SSH connection. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Devbox name
+                         * @example my-python-api
+                         */
+                        name: string;
+                        /**
+                         * @description SSH node port for connecting to the Devbox
+                         * @example 40001
+                         */
+                        sshPort: number;
+                        /**
+                         * @description Base64-encoded SSH private key. Decode before use.
+                         * @example LS0tLS1CRUdJTi...
+                         */
+                        base64PrivateKey: string;
+                        /**
+                         * @description SSH login username
+                         * @example devbox
+                         */
+                        userName: string;
+                        /**
+                         * @description Default working directory inside the Devbox
+                         * @example /home/devbox/project
+                         */
+                        workingDir: string;
+                        /**
+                         * @description Base domain of the Sealos instance
+                         * @example cloud.sealos.io
+                         */
+                        domain?: string;
+                        /** @description Created port configurations (may be empty) */
+                        ports: {
+                            /** @description Generated port name */
+                            portName: string;
+                            /** @description Port number */
+                            number: number;
+                            /**
+                             * @description Protocol type
+                             * @enum {string}
+                             */
+                            protocol: "http" | "grpc" | "ws";
+                            /** @description Network/Ingress name */
+                            networkName: string;
+                            /** @description Whether public domain is enabled */
+                            isPublic: boolean;
+                            /** @description Generated public domain */
+                            publicDomain: string;
+                            /** @description Custom domain (if provided) */
+                            customDomain: string;
+                            /** @description Service name */
+                            serviceName: string;
+                            /** @description Private address for internal access */
+                            privateAddress: string;
+                            /** @description Error message if port creation failed */
+                            error?: string;
+                        }[];
+                        /** @description Whether the autostart job was triggered (`autostart: true` in request) */
+                        autostarted?: boolean;
+                        /** @description Ports that failed to be created (only present when partial failure occurred) */
+                        portErrors?: {
+                            /** @description Port number that failed */
+                            port: number;
+                            /** @description Error message */
+                            error: string;
+                        }[];
+                        /** @description Aggregate counts for port creation */
+                        summary: {
+                            /** @description Total number of ports */
+                            totalPorts: number;
+                            /** @description Number of successfully created ports */
+                            successfulPorts: number;
+                            /** @description Number of failed ports */
+                            failedPorts: number;
+                        };
+                    };
+                };
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified runtime does not exist or is not available. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description A Devbox with the specified name already exists. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @enum {string} */
+                            code: "ALREADY_EXISTS";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to create the Devbox. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Devbox details retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Devbox name
+                         * @example my-devbox
+                         */
+                        name: string;
+                        /**
+                         * @description Creation time in ISO format
+                         * @example 2023-12-07T10:00:00.000Z
+                         */
+                        createdAt: string;
+                        /**
+                         * @description Running duration since first pod started (human-readable)
+                         * @example 2d3h
+                         */
+                        upTime?: string;
+                        /**
+                         * @description Unique identifier
+                         * @example abc123-def456
+                         */
+                        uid: string;
+                        /**
+                         * @description Resource type
+                         * @default devbox
+                         * @example devbox
+                         */
+                        resourceType: string;
+                        /**
+                         * @description Runtime environment name
+                         * @example node.js
+                         */
+                        runtime: string;
+                        /**
+                         * @description Container image
+                         * @example ghcr.io/labring/sealos-devbox-nodejs:latest
+                         */
+                        image: string;
+                        /**
+                         * @description Devbox status (running, stopped, pending, etc.)
+                         * @example running
+                         */
+                        status: string;
+                        /** @description CPU and memory quota allocation */
+                        quota: {
+                            /**
+                             * @description CPU allocation in cores
+                             * @example 1
+                             */
+                            cpu: number;
+                            /**
+                             * @description Memory allocation in GB
+                             * @example 2
+                             */
+                            memory: number;
+                        };
+                        /** @description SSH connection details */
+                        ssh: {
+                            /**
+                             * @description SSH host address
+                             * @example devbox.cloud.sealos.io
+                             */
+                            host: string;
+                            /**
+                             * @description SSH port number, null if not yet assigned
+                             * @example 40001
+                             */
+                            port: number | null;
+                            /**
+                             * @description SSH username
+                             * @example devbox
+                             */
+                            user: string;
+                            /**
+                             * @description Working directory path
+                             * @example /home/devbox/project
+                             */
+                            workingDir: string;
+                            /** @description Base64 encoded private key (optional) */
+                            privateKey?: string;
+                        };
+                        /** @description Environment variables (optional) */
+                        env?: {
+                            /** @description Environment variable name */
+                            name: string;
+                            /** @description Direct value of the environment variable */
+                            value?: string;
+                            /** @description Reference to a secret value */
+                            valueFrom?: {
+                                secretKeyRef: {
+                                    /** @description Secret name */
+                                    name: string;
+                                    /** @description Secret key */
+                                    key: string;
+                                };
+                            };
+                        }[];
+                        /** @description Port configurations */
+                        ports: {
+                            /**
+                             * @description Port number
+                             * @example 8080
+                             */
+                            number: number;
+                            /** @description Port name identifier */
+                            portName?: string;
+                            /**
+                             * @description Protocol type (http, grpc, ws)
+                             * @example http
+                             */
+                            protocol?: string;
+                            /**
+                             * @description Private access address
+                             * @example http://my-devbox.ns-user123:8080
+                             */
+                            privateAddress?: string;
+                            /**
+                             * @description Public access address
+                             * @example https://xyz789.cloud.sealos.io
+                             */
+                            publicAddress?: string;
+                            /** @description Custom domain (if configured) */
+                            customDomain?: string;
+                        }[];
+                        /** @description Pod information */
+                        pods: {
+                            /** @description Pod name */
+                            name: string;
+                            /**
+                             * @description Pod status (Running, Pending, Failed, etc.)
+                             * @example Running
+                             */
+                            status: string;
+                        }[];
+                        /** @description Operational status details (optional) */
+                        operationalStatus?: unknown;
+                    };
+                };
+            };
+            /** @description Invalid devbox name. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to retrieve devbox details. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deleteDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Devbox deleted successfully, or did not exist (idempotent). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid devbox name. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to delete the Devbox or its associated resources. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    updateDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * @description Fields to update. At least one of `quota` or `ports` is required.
+         *
+         *     **Example — update resources only:**
+         *     ```json
+         *     {
+         *       "quota": { "cpu": 2, "memory": 4 }
+         *     }
+         *     ```
+         *
+         *     **Example — replace all ports with a single new public port:**
+         *     ```json
+         *     {
+         *       "ports": [{ "number": 8080, "protocol": "http", "isPublic": true }]
+         *     }
+         *     ```
+         *
+         *     **Example — update an existing port and add a new one:**
+         *     ```json
+         *     {
+         *       "ports": [
+         *         { "portName": "port-abc123", "number": 8080, "protocol": "http", "isPublic": true },
+         *         { "number": 3000, "protocol": "http", "isPublic": false }
+         *       ]
+         *     }
+         *     ```
+         */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Resource allocation for CPU and memory (optional)
+                     * @example {
+                     *       "cpu": 1,
+                     *       "memory": 2
+                     *     }
+                     */
+                    quota?: {
+                        /**
+                         * @description CPU allocation in cores (optional)
+                         * @example 1
+                         */
+                        cpu?: number;
+                        /**
+                         * @description Memory allocation in GB (optional)
+                         * @example 2
+                         */
+                        memory?: number;
+                    };
+                    /** @description Array of port configurations. Include portName to update existing ports, exclude portName to create new ports. Existing ports not included will be deleted. (optional) */
+                    ports?: ({
+                        /** @description Existing port name to update (include to update specific port) */
+                        portName?: string;
+                        /** @description Port number (1-65535) - optional for updates */
+                        number?: number;
+                        /**
+                         * @description Protocol type - optional for updates
+                         * @enum {string}
+                         */
+                        protocol?: "http" | "grpc" | "ws";
+                        /** @description Enable public domain access - optional for updates */
+                        isPublic?: boolean;
+                        /** @description Custom domain - optional for updates */
+                        customDomain?: string;
+                    } | {
+                        /** @description Port number (1-65535) - required for new ports */
+                        number: number;
+                        /**
+                         * @description Protocol type, defaults to HTTP
+                         * @default http
+                         * @enum {string}
+                         */
+                        protocol?: "http" | "grpc" | "ws";
+                        /**
+                         * @description Enable public domain access, defaults to true
+                         * @default true
+                         */
+                        isPublic?: boolean;
+                        /** @description Custom domain (optional) */
+                        customDomain?: string;
+                    })[];
+                };
+            };
+        };
+        responses: {
+            /** @description Devbox updated successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Devbox not found, or a referenced `portName` does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Port number is already in use by another port. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @enum {string} */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Resource specification rejected by the Kubernetes cluster. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "operation_error";
+                            /** @constant */
+                            code: "INVALID_RESOURCE_SPEC";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to update the Devbox. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    autostartDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * @description Autostart configuration. The body is optional — send `{}` to use the default entrypoint.
+         *
+         *     **Example — custom startup script:**
+         *     ```json
+         *     {
+         *       "execCommand": "/bin/bash /home/devbox/project/startup.sh"
+         *     }
+         *     ```
+         */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Custom command to execute in the devbox (optional)
+                     * @example /bin/bash /home/devbox/project/entrypoint.sh
+                     */
+                    execCommand?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Autostart configured successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid request parameters. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to configure autostart. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    startDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Devbox started successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid devbox name. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to start the Devbox. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    pauseDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": Record<string, never>;
+            };
+        };
+        responses: {
+            /** @description Devbox paused successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to pause the Devbox. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    shutdownDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": Record<string, never>;
+            };
+        };
+        responses: {
+            /** @description Devbox shut down successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to shut down the Devbox. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    restartDevbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": Record<string, never>;
+            };
+        };
+        responses: {
+            /** @description Devbox restarted successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Restart cycle failed. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDevboxReleases: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Release list retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Version ID */
+                        id: string;
+                        /** @description Version name */
+                        name: string;
+                        /** @description Devbox name */
+                        devboxName: string;
+                        /** @description Creation time in YYYY-MM-DD HH:mm format */
+                        createdAt: string;
+                        /** @description Version tag */
+                        tag: string;
+                        /** @description Version description */
+                        description: string;
+                        /** @description Release image address */
+                        image: string;
+                    }[];
+                };
+            };
+            /** @description Invalid devbox name. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to retrieve the release list. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createDevboxRelease: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * @description Release parameters.
+         *
+         *     **Example — minimal (restart after build, no custom startup command):**
+         *     ```json
+         *     {
+         *       "tag": "v1-2-0",
+         *       "releaseDescription": "Added API improvements and bug fixes."
+         *     }
+         *     ```
+         *
+         *     **Example — keep Devbox stopped after release:**
+         *     ```json
+         *     {
+         *       "tag": "v1-0-0",
+         *       "releaseDescription": "Hotfix",
+         *       "startDevboxAfterRelease": false
+         *     }
+         *     ```
+         *
+         *     **Example — restart with autostart command:**
+         *     ```json
+         *     {
+         *       "tag": "v1-3-0",
+         *       "releaseDescription": "Adds startup script",
+         *       "execCommand": "nohup /home/devbox/project/entrypoint.sh > /dev/null 2>&1 &"
+         *     }
+         *     ```
+         */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Release tag */
+                    tag: string;
+                    /**
+                     * @description Release description
+                     * @default
+                     */
+                    releaseDescription?: string;
+                    /**
+                     * @description Command to execute in the devbox after release restart (autostart)
+                     * @example nohup /home/devbox/project/entrypoint.sh > /dev/null 2>&1 &
+                     */
+                    execCommand?: string;
+                    /**
+                     * @description Restart devbox automatically after the release build completes. Defaults to `true`.
+                     * @default true
+                     */
+                    startDevboxAfterRelease?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Release accepted. The container image build pipeline has started in the background. Poll `GET /devbox/{name}/releases` to track progress. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Devbox name
+                         * @example my-python-api
+                         */
+                        name: string;
+                        /**
+                         * @description Always `creating` — the build is running asynchronously.
+                         * @example creating
+                         * @enum {string}
+                         */
+                        status: "creating";
+                    };
+                };
+            };
+            /** @description Request body failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description A release with this tag already exists for this Devbox. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @enum {string} */
+                            code: "ALREADY_EXISTS";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to create the release. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDevboxDeployments: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deployment list retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Deployment or StatefulSet name */
+                        name: string;
+                        /**
+                         * @description Resource type
+                         * @enum {string}
+                         */
+                        resourceType: "deployment" | "statefulset";
+                        /** @description Devbox tag extracted from image name */
+                        tag: string;
+                    }[];
+                };
+            };
+            /** @description Invalid devbox name. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description The specified Devbox does not exist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to query deployments. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deleteDevboxRelease: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+                /** @description Release version tag (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                tag: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Release deleted successfully, or did not exist (idempotent). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid path parameters. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to delete the release. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deployDevboxRelease: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+                /** @description Release version tag (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                tag: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Release deployed successfully. Application is now running in AppLaunchpad. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid path parameters. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Devbox or release tag not found, or release is not in Success status. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "resource_error";
+                            /** @constant */
+                            code: "NOT_FOUND";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Deployment failed. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "operation_error" | "internal_error";
+                            /** @enum {string} */
+                            code: "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getDevboxMonitor: {
+        parameters: {
+            query?: {
+                /** @description Start of the monitoring window. Accepts a Unix timestamp in either **seconds** or **milliseconds** (values > 10¹² are automatically divided by 1000). Defaults to `end − 3 h`. */
+                start?: string;
+                /** @description End of the monitoring window. Accepts a Unix timestamp in either **seconds** or **milliseconds** (values > 10¹² are automatically divided by 1000). Defaults to the current server time. */
+                end?: string;
+                /** @description Sampling interval (e.g. `1m`, `5m`, `1h`). */
+                step?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Devbox name (format: lowercase alphanumeric with hyphens, 1–63 characters) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Monitoring data retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Unix timestamp in seconds
+                         * @example 1760510280
+                         */
+                        timestamp: number;
+                        /**
+                         * @description Formatted timestamp in YYYY/MM/DD HH:mm
+                         * @example 2025/10/15 14:38
+                         */
+                        readableTime: string;
+                        /**
+                         * @description CPU utilisation percentage
+                         * @example 1.08
+                         */
+                        cpu: number;
+                        /**
+                         * @description Memory utilisation percentage
+                         * @example 10.32
+                         */
+                        memory: number;
+                    }[];
+                };
+            };
+            /** @description Invalid devbox name or query parameters. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "validation_error";
+                            /** @enum {string} */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            message: string;
+                            details?: {
+                                field: string;
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to fetch monitoring data. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDevboxTemplates: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Template list retrieved successfully. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Runtime name (from iconId or repository uid) */
+                        runtime: string;
+                        /** @description Parsed template configuration */
+                        config: {
+                            appPorts?: {
+                                name: string;
+                                port: number;
+                                protocol: string;
+                            }[];
+                            ports?: {
+                                containerPort: number;
+                                name: string;
+                                protocol: string;
+                            }[];
+                            releaseArgs?: string[];
+                            releaseCommand?: string[];
+                            user?: string;
+                            workingDir?: string;
+                        };
+                    }[];
+                };
+            };
+            /** @description No valid credentials provided, or credentials have expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @constant */
+                            type: "authentication_error";
+                            /** @constant */
+                            code: "AUTHENTICATION_REQUIRED";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Failed to retrieve the template list. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @enum {string} */
+                            type: "internal_error";
+                            /** @enum {string} */
+                            code: "INTERNAL_ERROR";
+                            message: string;
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}