sealos-cli 0.1.0

package/src/generated/template.ts

@@ -0,0 +1,1007 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/templates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all templates
+         * @description Returns metadata only (no resource calculation). Response headers: `Cache-Control` (public, max-age=300, s-maxage=600), `ETag`. When categories exist, top category keys are returned in `X-Menu-Keys` (comma-separated). For full details including resource requirements, use `/templates/{name}`.
+         */
+        get: operations["listTemplates"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/templates/{name}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get template details
+         * @description Returns complete template metadata with dynamically calculated resource requirements (CPU, memory, storage, NodePort count) derived from the template YAML. Falls back to static configuration if calculation fails. Response headers: `Cache-Control` (public, max-age=300, s-maxage=600), `ETag`.
+         */
+        get: operations["getTemplate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/templates/raw": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Deploy template from raw YAML
+         * @description Deploy an arbitrary or custom template by supplying its raw YAML directly in the request body. The instance name is auto-generated from `${{ random(8) }}` inside `spec.defaults.app_name`. Use `dryRun: true` to validate the resources against the Kubernetes API without creating anything.
+         *
+         *     **Example — dry-run a custom template:**
+         *     ```json
+         *     {
+         *       "yaml": "apiVersion: app.sealos.io/v1\nkind: Template\n...",
+         *       "dryRun": true
+         *     }
+         *     ```
+         */
+        post: operations["deployRawTemplate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/templates/instances": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create template instance
+         * @description Deploy a named instance of a template into the user's Kubernetes namespace. User-provided `args` are merged with the template's declared defaults — only args with no default value are required. The `args` field in the response reflects the fully resolved values after applying defaults.
+         *
+         *     **Example — create a Perplexica instance:**
+         *     ```json
+         *     {
+         *       "name": "my-app-instance",
+         *       "template": "perplexica",
+         *       "args": {
+         *         "OPENAI_API_KEY": "<your-api-key>",
+         *         "OPENAI_MODEL_NAME": "gpt-4o"
+         *       }
+         *     }
+         *     ```
+         */
+        post: operations["createInstance"];
+        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 {
+    listTemplates: {
+        parameters: {
+            query?: {
+                /** @description Language code for internationalization (e.g., "en", "zh"). Defaults to "en" */
+                language?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successfully retrieved template list */
+            200: {
+                headers: {
+                    /** @description Caching directive: public, max-age=300, s-maxage=600 */
+                    "Cache-Control"?: string;
+                    /** @description Entity tag for caching, format: "template-list-{language}" */
+                    ETag?: string;
+                    /** @description Top category keys (comma-separated). Present only when categories exist. */
+                    "X-Menu-Keys"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Unique template identifier */
+                        name: string;
+                        /**
+                         * @description Resource type, always "template"
+                         * @constant
+                         */
+                        resourceType: "template";
+                        /** @description URL to README documentation. Empty string when not available. */
+                        readme: string;
+                        /** @description URL to template icon image. Empty string when not available. */
+                        icon: string;
+                        /** @description Brief description of the template */
+                        description: string;
+                        /** @description Git repository URL. Empty string when not available. */
+                        gitRepo: string;
+                        /** @description Template categories (e.g., ["ai", "database"]) */
+                        category: string[];
+                        /** @description Arguments required for template deployment */
+                        args: {
+                            [key: string]: {
+                                /** @description Human-readable explanation of the argument */
+                                description: string;
+                                /** @description Argument type (e.g. "string", "number", "boolean", "password") */
+                                type: string;
+                                /** @description Default value used during deployment */
+                                default: string;
+                                /** @description Whether this argument is mandatory */
+                                required: boolean;
+                            };
+                        };
+                        /** @description Number of deployments (includes multiplier for display) */
+                        deployCount: number;
+                    }[];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getTemplate: {
+        parameters: {
+            query?: {
+                /** @description Language code for internationalization (e.g., "en", "zh"). Defaults to "en" */
+                language?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Template name identifier (e.g., "perplexica", "yourls") */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successfully retrieved template details */
+            200: {
+                headers: {
+                    /** @description Caching directive: public, max-age=300, s-maxage=600 */
+                    "Cache-Control"?: string;
+                    /** @description Entity tag for caching, format: "{name}-{language}" */
+                    ETag?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Unique template identifier */
+                        name: string;
+                        /**
+                         * @description Resource type, always "template"
+                         * @constant
+                         */
+                        resourceType: "template";
+                        /** @description URL to README documentation. Empty string when not available. */
+                        readme: string;
+                        /** @description URL to template icon image. Empty string when not available. */
+                        icon: string;
+                        /** @description Brief description of the template */
+                        description: string;
+                        /** @description Git repository URL. Empty string when not available. */
+                        gitRepo: string;
+                        /** @description Template categories (e.g., ["ai", "database"]) */
+                        category: string[];
+                        /** @description Arguments required for template deployment */
+                        args: {
+                            [key: string]: {
+                                /** @description Human-readable explanation of the argument */
+                                description: string;
+                                /** @description Argument type (e.g. "string", "number", "boolean", "password") */
+                                type: string;
+                                /** @description Default value used during deployment */
+                                default: string;
+                                /** @description Whether this argument is mandatory */
+                                required: boolean;
+                            };
+                        };
+                        /** @description Number of deployments (includes multiplier for display) */
+                        deployCount: number;
+                        /** @description Calculated resource requirements */
+                        quota: {
+                            /** @description Required CPU cores in vCPU */
+                            cpu: number;
+                            /** @description Required memory in GiB */
+                            memory: number;
+                            /** @description Required storage in GiB */
+                            storage: number;
+                            /** @description Number of NodePort services required */
+                            nodeport: number;
+                        };
+                    };
+                };
+            };
+            /** @description Bad request - template name is required */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "ports[0].number" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Template not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deployRawTemplate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Template deployment configuration */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Full template YAML string. Must start with a `kind: Template` document, followed by one or more `---`-separated Kubernetes resource documents.
+                     * @example apiVersion: app.sealos.io/v1
+                     *     kind: Template
+                     *     metadata:
+                     *       name: my-app
+                     *     spec:
+                     *       defaults:
+                     *         app_name:
+                     *           type: string
+                     *           value: my-app-${{ random(8) }}
+                     *     ---
+                     *     apiVersion: apps/v1
+                     *     kind: Deployment
+                     *     metadata:
+                     *       name: ${{ defaults.app_name }}
+                     *     spec:
+                     *       replicas: 1
+                     *       selector:
+                     *         matchLabels:
+                     *           app: ${{ defaults.app_name }}
+                     *       template:
+                     *         metadata:
+                     *           labels:
+                     *             app: ${{ defaults.app_name }}
+                     *         spec:
+                     *           containers:
+                     *             - name: app
+                     *               image: nginx:latest
+                     *               resources:
+                     *                 limits:
+                     *                   cpu: 100m
+                     *                   memory: 256Mi
+                     */
+                    yaml: string;
+                    /**
+                     * @description Template variable key-value pairs that override or supply `spec.inputs` fields. Only args without a non-empty default are required.
+                     * @example {
+                     *       "MY_SECRET": "my-secret-value"
+                     *     }
+                     */
+                    args?: {
+                        [key: string]: string;
+                    };
+                    /**
+                     * @description If true, validates the resources against the Kubernetes API but does not create anything. Returns 200 with a preview. Default: false.
+                     * @example true
+                     */
+                    dryRun?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Dry-run preview — resources validated but not created */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Auto-generated instance name from ${{ random(8) }} in spec.defaults */
+                        name: string;
+                        /**
+                         * @description Always "instance"
+                         * @constant
+                         */
+                        resourceType: "instance";
+                        /**
+                         * @description Always true for dry-run responses
+                         * @constant
+                         */
+                        dryRun: true;
+                        /** @description Resolved template arguments after merging user-provided values with defaults */
+                        args: {
+                            [key: string]: string;
+                        };
+                        /** @description Preview of sub-resources that would be created (Instance resource excluded) */
+                        resources?: {
+                            /** @description Resource name */
+                            name: string;
+                            /** @description Kubernetes UID */
+                            uid: string;
+                            /** @description Resource type (lowercase k8s kind) */
+                            resourceType: string;
+                            /** @description Resource quota (for Deployment/StatefulSet/Cluster) */
+                            quota?: {
+                                /** @description CPU cores */
+                                cpu?: number;
+                                /** @description Memory in GiB */
+                                memory?: number;
+                                /** @description Storage in GiB */
+                                storage?: number;
+                                /** @description Number of replicas */
+                                replicas?: number;
+                            };
+                        }[];
+                    };
+                };
+            };
+            /** @description Template deployed successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Instance name (matches the name specified in the request) */
+                        name: string;
+                        /** @description Kubernetes UID of the Instance resource */
+                        uid: string;
+                        /**
+                         * @description Always "instance"
+                         * @constant
+                         */
+                        resourceType: "instance";
+                        /** @description Display name */
+                        displayName: string;
+                        /** @description ISO 8601 creation timestamp */
+                        createdAt: string;
+                        /** @description Resolved template arguments after merging user-provided values with defaults */
+                        args: {
+                            [key: string]: string;
+                        };
+                        /** @description Sub-resources created for this instance */
+                        resources?: {
+                            /** @description Resource name */
+                            name: string;
+                            /** @description Kubernetes UID */
+                            uid: string;
+                            /** @description Resource type (lowercase k8s kind) */
+                            resourceType: string;
+                            /** @description Resource quota (for Deployment/StatefulSet/Cluster) */
+                            quota?: {
+                                /** @description CPU cores */
+                                cpu?: number;
+                                /** @description Memory in GiB */
+                                memory?: number;
+                                /** @description Storage in GiB */
+                                storage?: number;
+                                /** @description Number of replicas */
+                                replicas?: number;
+                            };
+                        }[];
+                    };
+                };
+            };
+            /** @description Bad request — missing or invalid YAML / missing required args */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "ports[0].number" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — missing or invalid kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — instance already exists */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Unprocessable Entity — K8s rejected the resource spec */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "operation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "INVALID_RESOURCE_SPEC";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw K8s rejection reason (admission webhook message, invalid field error, quota exceeded message). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service Unavailable — Kubernetes cluster temporarily unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createInstance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Instance creation configuration */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Instance name. 1–63 lowercase alphanumeric characters or hyphens, must start and end with alphanumeric (Kubernetes DNS subdomain rules). e.g. "my-perplexica-instance"
+                     * @example my-perplexica-instance
+                     */
+                    name: string;
+                    /**
+                     * @description Template name from the catalog. Use GET /templates to list available templates. e.g. "perplexica"
+                     * @example perplexica
+                     */
+                    template: string;
+                    /**
+                     * @description Template variable key-value pairs. Only args without a default value are required. Use GET /templates/{name} to see which args are required and their defaults.
+                     * @example {
+                     *       "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx",
+                     *       "OPENAI_MODEL_NAME": "gpt-4o"
+                     *     }
+                     */
+                    args?: {
+                        [key: string]: string;
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description Instance created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Instance name (matches the name specified in the request) */
+                        name: string;
+                        /** @description Kubernetes UID of the Instance resource */
+                        uid: string;
+                        /**
+                         * @description Always "instance"
+                         * @constant
+                         */
+                        resourceType: "instance";
+                        /** @description Display name */
+                        displayName: string;
+                        /** @description ISO 8601 creation timestamp */
+                        createdAt: string;
+                        /** @description Resolved template arguments after merging user-provided values with defaults */
+                        args: {
+                            [key: string]: string;
+                        };
+                        /** @description Sub-resources created for this instance */
+                        resources?: {
+                            /** @description Resource name */
+                            name: string;
+                            /** @description Kubernetes UID */
+                            uid: string;
+                            /** @description Resource type (lowercase k8s kind) */
+                            resourceType: string;
+                            /** @description Resource quota (for Deployment/StatefulSet/Cluster) */
+                            quota?: {
+                                /** @description CPU cores */
+                                cpu?: number;
+                                /** @description Memory in GiB */
+                                memory?: number;
+                                /** @description Storage in GiB */
+                                storage?: number;
+                                /** @description Number of replicas */
+                                replicas?: number;
+                            };
+                        }[];
+                    };
+                };
+            };
+            /** @description Bad request - missing or invalid parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "ports[0].number" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized - Missing or invalid kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden - Insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not Found - Template not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict - Instance already exists */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Unprocessable Entity - K8s rejected the resource (admission webhook, invalid field, quota exceeded) */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "operation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "INVALID_RESOURCE_SPEC";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw K8s rejection reason (admission webhook message, invalid field error, quota exceeded message). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal Server Error - Kubernetes API error or unexpected failure */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service Unavailable - Kubernetes cluster temporarily unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}