@keboola/api-client 20.0.0 → 23.0.0

package/dist/{utils-DDERw8dM.d.cts → utils-CuiDsDxz.d.cts}

@@ -1,4 +1,4 @@
-import { d as OpenapiPathType, c as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { d as OpenapiPathType, c as OpenapiQueryType, O as OpenapiBodyType, b as OpenapiReturnType } from './types-BbM5WDSR.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -6,20 +6,41 @@ import { d as OpenapiPathType, c as OpenapiQueryType, b as OpenapiBodyType, a as
  */
 
 type paths = {
-  '/health-check': {
+  '/': {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
-    get?: never;
+    /**
+     * Service metadata
+     * @description Returns the service name, version and a link to this API specification.
+     *     No authentication required.
+     */
+    get: operations['index'];
     put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/health-check': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
     /**
      * Health-check endpoint
-     * @description Checks the service is up & running.
+     * @description Checks the service is up & running. No authentication required.
      */
-    post: operations['healthCheck'];
+    get: operations['healthCheck'];
+    put?: never;
+    post?: never;
     delete?: never;
     options?: never;
     head?: never;
@@ -114,6 +135,7 @@ type paths = {
     /**
      * Update app state
      * @description Update app state.
+     *     Accepts a Storage API token, or a Manage API application token with the `apps:proxy` scope.
      */
     patch: operations['patchApp'];
     trace?: never;
@@ -127,7 +149,8 @@ type paths = {
     };
     /**
      * Get proxy config for the app
-     * @description Get proxy config for the app
+     * @description Get proxy config for the app.
+     *     Requires a Manage API application token with the `apps:proxy` scope (or an equivalent ServiceAccount token).
      */
     get: operations['getAppProxyConfig'];
     put?: never;
@@ -203,51 +226,6 @@ type paths = {
     patch?: never;
     trace?: never;
   };
-  '/apps/{appId}/git-repo/branches': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /**
-     * List branches of the app's configured Git repository
-     * @description Returns the remote branches of the Git repository configured in the app's
-     *     config (`parameters.dataApp.git`). Works for any configured repository,
-     *     not only managed Git repositories.
-     */
-    get: operations['listAppGitRepoBranches'];
-    put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/apps/{appId}/git-repo/entrypoints': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /**
-     * List entrypoint files in the app's configured Git repository
-     * @description Returns the root-level entrypoint files of the Git repository configured
-     *     in the app's config (`parameters.dataApp.git`). Uses the configured
-     *     branch (or the repo's default branch if none is set). Works for any
-     *     configured repository, not only managed Git repositories.
-     */
-    get: operations['listAppGitRepoEntrypoints'];
-    put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
   '/apps/{appId}/git-repo/credentials': {
     parameters: {
       query?: never;
@@ -429,6 +407,26 @@ type paths = {
     patch: operations['patchSandbox'];
     trace?: never;
   };
+  '/sandboxes/project': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get current project
+     * @description Get the project resolved from the Storage API token, including its persistent storage status.
+     */
+    get: operations['getCurrentProject'];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/runtimes': {
     parameters: {
       query?: never;
@@ -438,7 +436,7 @@ type paths = {
     };
     /**
      * List Runtimes
-     * @description List of registered runtimes
+     * @description List of registered runtimes. No authentication required.
      */
     get: operations['listRuntimes'];
     put?: never;
@@ -449,6 +447,227 @@ type paths = {
     patch?: never;
     trace?: never;
   };
+  '/v2/apps': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * [v2, EXPERIMENTAL] List apps
+     * @description **Stub — returns `501`.** Once implemented: lists apps for the project, each
+     *     including `production {desired, actual}` and `undeployedChanges` (whether the
+     *     production deployment's inputs differ from the current config version / branch
+     *     HEAD).
+     */
+    get: operations['listAppsV2'];
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Create app
+     * @description **Stub — returns `501`.** Once implemented: creates the app row plus its AppGroup
+     *     CR (the product's Kubernetes object); the app starts with `production: null` —
+     *     its URL is reserved but publicly 404s until a deployment is promoted.
+     */
+    post: operations['createAppV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * [v2, EXPERIMENTAL] Get app detail
+     * @description **Stub — returns `501`.** Once implemented: same shape as the list entry, incl.
+     *     `production {desired, actual}` and `undeployedChanges`.
+     */
+    get: operations['getAppV2'];
+    put?: never;
+    post?: never;
+    /**
+     * [v2, EXPERIMENTAL] Delete app
+     * @description **Stub — returns `501`.** Once implemented: deletes the AppGroup CR, cascading to
+     *     every deployment, Secret and pod owned by it; rows are soft-deleted.
+     */
+    delete: operations['deleteAppV2'];
+    options?: never;
+    head?: never;
+    /**
+     * [v2, EXPERIMENTAL] Update app settings
+     * @description **Stub — returns `501`.** Once implemented: updates plain product settings only
+     *     (e.g. `name`). Per the `/v2` design rule (see API description), operations with
+     *     side effects beyond a plain attribute write — promote, unpublish, suspend, resume
+     *     — are separate action-verb endpoints, not part of this `PATCH`.
+     */
+    patch: operations['patchAppV2'];
+    trace?: never;
+  };
+  '/v2/apps/{appId}/unpublish': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Unpublish app
+     * @description **Stub — returns `501`.** Once implemented: sets `production` to none — routing
+     *     is dropped and the app's URL 404s. Idempotent: unpublishing an already-unpublished
+     *     app is a no-op.
+     */
+    post: operations['unpublishAppV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}/suspend': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Suspend app
+     * @description **Stub — returns `501`.** Once implemented: sleeps the app's currently serving
+     *     member now, instead of waiting for the idle timer. Not sticky — wake-on-request
+     *     stays armed, so the next visitor resumes it. Idempotent: suspending an
+     *     already-suspended app is a no-op; returns `409` if the app has no serving member
+     *     to suspend.
+     */
+    post: operations['suspendAppV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}/resume': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Resume app
+     * @description **Stub — returns `501`.** Once implemented: wakes the app's currently serving
+     *     member now (a warm-up), instead of waiting for a visitor to trigger it.
+     *     Idempotent: resuming an already-running app is a no-op; returns `409` if the app
+     *     has no serving member to resume.
+     */
+    post: operations['resumeAppV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}/deployments': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * [v2, EXPERIMENTAL] List deployments
+     * @description **Stub — returns `501`.** Once implemented: full deployment history including
+     *     retired (`archived: true`) deployments — rows outlive their Kubernetes CRs.
+     */
+    get: operations['listDeploymentsV2'];
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Create deployment (deploy)
+     * @description **Stub — returns `501`.** Once implemented: deploys the current config version /
+     *     branch HEAD as a new immutable deployment. `promote: true` by default — deploying
+     *     also promotes to production unless explicitly disabled. The deployment id is
+     *     minted synchronously (deterministic Kubernetes CR name); the display `number` is
+     *     allocated from a per-app DB sequence, also returned synchronously — an optional
+     *     `Idempotency-Key` header makes a retried deploy return the same row instead of a
+     *     duplicate.
+     */
+    post: operations['createDeploymentV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}/deployments/{deploymentId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * [v2, EXPERIMENTAL] Get deployment detail
+     * @description **Stub — returns `501`.** Once implemented: deployment detail; served from the DB
+     *     projection, falling through to the Kubernetes CR during the brief sync window
+     *     right after creation (read-your-writes).
+     */
+    get: operations['getDeploymentV2'];
+    put?: never;
+    post?: never;
+    /**
+     * [v2, EXPERIMENTAL] Retire deployment
+     * @description **Stub — returns `501`.** Once implemented: **retires, does not erase** — deletes
+     *     the member CR and its rendered-config Secret immediately (credential hygiene);
+     *     the row stays in history marked `archived: true` and is re-materializable.
+     *     Deployments have no `PATCH`/`PUT` — they are immutable; retirement is a lifecycle
+     *     transition, not a mutation. `409` if this is the current production deployment
+     *     (promote or roll back to another deployment, or unpublish, before retiring it).
+     *     Row hard-deletion happens only via app deletion.
+     */
+    delete: operations['deleteDeploymentV2'];
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/v2/apps/{appId}/deployments/{deploymentId}/promote': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * [v2, EXPERIMENTAL] Promote deployment (promote / rollback)
+     * @description **Stub — returns `501`.** Once implemented: makes this deployment production.
+     *     Rollback is the same action applied to an older deployment — every repoint is
+     *     audited. Valid only when the target is `READY`; promoting an `archived`
+     *     deployment is allowed (it is re-materialized first). Promotion always validates
+     *     by starting the deployment even when the app is suspended — if that fails, the
+     *     app is left `PromotionBlocked` and production keeps serving the deployment it
+     *     was already serving. Idempotent: promoting the deployment that is already
+     *     production is a no-op. Authorized separately from plain app settings.
+     */
+    post: operations['promoteDeploymentV2'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
 };
 type components = {
   schemas: {
@@ -625,8 +844,6 @@ type components = {
       autoRestartEnabled?: boolean;
       /** @description App size (e.g. micro, tiny, small, medium, large, external) */
       size?: string | null;
-      /** @enum {string} */
-      provisioningStrategy: 'jobQueue' | 'operator';
       /** @description Whether the app has a managed Git repository provisioned by the service. Apps with a managed repository expose additional endpoints under `/apps/{appId}/git-repo/credentials`. */
       hasManagedGitRepo?: boolean;
     };
@@ -783,6 +1000,57 @@ type components = {
        */
       mode: 'prod' | 'dev';
     };
+    /** @description Flat error shape used by every v2 endpoint, matching the v1 convention (e.g. 404 → `{"error": "App \"123\" not found"}`). Every stub endpoint currently returns this shape with HTTP 501 — see each operation's `501` response example for its exact message. */
+    V2ErrorResponse: {
+      error?: string;
+    };
+    V2App: {
+      id: string;
+      /**
+       * Format: url
+       * @description Production URL — stable, unchanged by promote/rollback.
+       */
+      url: string;
+      name?: string;
+      /** @description `null` on both fields means the app has never been deployed (URL reserved, publicly 404s). */
+      production: {
+        /** @description Deployment number most recently asked to be production. */
+        desired?: number | null;
+        /** @description Deployment number actually serving production traffic right now, per the AppGroup controller's convergence status. */
+        actual?: number | null;
+      } | null;
+      /** @description Whether the production deployment's inputs differ from the current config version / branch HEAD. */
+      undeployedChanges?: boolean;
+    };
+    /** @description Minimal shape — not yet finalized; additional fields may be added before this endpoint is implemented. */
+    V2AppCreateRequest: {
+      name: string;
+      description?: string | null;
+    };
+    /** @description Plain product settings only — not yet finalized, additional fields may be added before this endpoint is implemented. Promotion, unpublishing, suspend, and resume are separate action-verb endpoints, not part of this shape. */
+    V2AppPatchRequest: {
+      name?: string;
+    };
+    V2Deployment: {
+      /** @description Deployment id — also the deterministic Kubernetes CR name. */
+      id: string;
+      /** @description Display/sort number, allocated from a per-app DB sequence. */
+      number: number;
+      /**
+       * @description `BUILDING` is a reserved value for a future build-status distinction; not emitted yet.
+       * @enum {string}
+       */
+      state: 'QUEUED' | 'READY' | 'FAILED';
+      /** @description `true` once retired (member CR + rendered-config Secret deleted); the row remains in history and is re-materializable. */
+      archived: boolean;
+    };
+    V2DeploymentCreateRequest: {
+      /**
+       * @description If true (the default), this deployment is also promoted to production.
+       * @default true
+       */
+      promote: boolean;
+    };
   };
   responses: never;
   parameters: never;
@@ -791,6 +1059,38 @@ type components = {
   pathItems: never;
 };
 type operations = {
+  index: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Service metadata */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "appName": "sandboxes-service",
+           *       "appVersion": "1.2.3",
+           *       "apiDocs": "http://localhost/docs/swagger.yaml"
+           *     }
+           */
+          'application/json': {
+            appName?: string;
+            appVersion?: string;
+            /** Format: url */
+            apiDocs?: string;
+          };
+        };
+      };
+    };
+  };
   healthCheck: {
     parameters: {
       query?: never;
@@ -1436,7 +1736,7 @@ type operations = {
       };
     };
   };
-  listAppGitRepoBranches: {
+  listAppGitRepoCredentials: {
     parameters: {
       query?: never;
       header?: never;
@@ -1453,17 +1753,7 @@ type operations = {
           [name: string]: unknown;
         };
         content: {
-          'application/json': {
-            branch: string;
-            comment: string;
-            sha: string;
-            author: {
-              name: string;
-              email: string;
-            };
-            /** Format: date-time */
-            date: string;
-          }[];
+          'application/json': components['schemas']['CredentialList'];
         };
       };
       /** @description Unauthorized */
@@ -1473,114 +1763,14 @@ type operations = {
         };
         content?: never;
       };
-      /** @description Forbidden */
+      /** @description Forbidden — token lacks admin context or CanManageApp fails */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Not Found */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description App has no Git repository configured */
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  listAppGitRepoEntrypoints: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path: {
-        appId: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description OK */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': string[];
-        };
-      };
-      /** @description Unauthorized */
-      401: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden */
-      403: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Not Found */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description App has no Git repository configured */
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  listAppGitRepoCredentials: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path: {
-        appId: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description OK */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['CredentialList'];
-        };
-      };
-      /** @description Unauthorized */
-      401: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden — token lacks admin context or CanManageApp fails */
-      403: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description App not found */
+      /** @description App not found */
       404: {
         headers: {
           [name: string]: unknown;
@@ -2155,6 +2345,43 @@ type operations = {
       };
     };
   };
+  getCurrentProject: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': {
+            id?: string;
+            /** Format: date-time */
+            createdTimestamp?: string;
+            /** Format: date-time */
+            updatedTimestamp?: string;
+            persistentStorage?: {
+              ready?: boolean | null;
+              k8sStorageClassName?: string | null;
+            };
+          };
+        };
+      };
+      /** @description Project not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
   listRuntimes: {
     parameters: {
       query?: {
@@ -2180,6 +2407,608 @@ type operations = {
       };
     };
   };
+  listAppsV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK (once implemented) */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'][];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  createAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        'application/json': components['schemas']['V2AppCreateRequest'];
+      };
+    };
+    responses: {
+      /** @description Created (once implemented) */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  getAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK (once implemented) */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  deleteAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  patchAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        'application/json': components['schemas']['V2AppPatchRequest'];
+      };
+    };
+    responses: {
+      /** @description OK (once implemented) */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  unpublishAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) — production is being unset */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description No Content (once implemented) — already unpublished; no-op */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  suspendAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) — suspend is being applied */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description No Content (once implemented) — already suspended; no-op */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict (once implemented) — the app has no currently serving member to suspend. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  resumeAppV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) — resume is being applied */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description No Content (once implemented) — already running; no-op */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict (once implemented) — the app has no currently serving member to resume. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  listDeploymentsV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK (once implemented) */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2Deployment'][];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  createDeploymentV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: {
+      content: {
+        'application/json': components['schemas']['V2DeploymentCreateRequest'];
+      };
+    };
+    responses: {
+      /** @description Accepted (once implemented) — deployment created in `QUEUED` state */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2Deployment'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  getDeploymentV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        deploymentId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK (once implemented) */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2Deployment'];
+        };
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  deleteDeploymentV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        deploymentId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict (once implemented) — this deployment is the current production deployment. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
+  promoteDeploymentV2: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        deploymentId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Accepted (once implemented) — promotion is being applied */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2App'];
+        };
+      };
+      /** @description No Content (once implemented) — already production; no-op */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found (once implemented) */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict (once implemented) — this deployment is not `READY` (and is not a re-materializable `archived` deployment). */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+      /** @description Not Implemented (current behavior) */
+      501: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "error": "This endpoint is not implemented yet."
+           *     }
+           */
+          'application/json': components['schemas']['V2ErrorResponse'];
+        };
+      };
+    };
+  };
 };
 
 type GetAppsQuery = OpenapiQueryType<paths['/apps']['get']>;