@keboola/api-client 55.0.0 → 57.0.0

package/dist/{types-CRC4lbPw.d.cts → types-Dteot3tT.d.ts}

@@ -1,4 +1,4 @@
-import { c as OpenapiQueryType, l as OpenapiReturnType, r as OpenapiBodyType, s as OpenapiPathType } from "./index-FrsEkDvX.cjs";
+import { c as OpenapiQueryType, l as OpenapiReturnType, r as OpenapiBodyType, s as OpenapiPathType } from "./index-9p4O-clX.js";
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -149,37 +149,6 @@ type paths = {
     patch?: never;
     trace?: never;
   };
-  '/apps/{appId}/activity': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get?: never;
-    put?: never;
-    /**
-     * Record app activity
-     * @description Records the timestamp of the app's most recent request — the heartbeat that drives
-     *     idle auto-suspend. Caller-supplied rather than server-stamped, so a caller can batch
-     *     several observed requests into one call and report the actual last-seen time instead
-     *     of the time of the call itself.
-     *
-     *     Callable only by apps-proxy: requires a Manage API application token with the
-     *     `apps:proxy` scope (or an equivalent ServiceAccount token). A Storage API token is
-     *     not accepted here, unlike `PATCH /apps/{appId}`.
-     *
-     *     Monotonic: a timestamp older than the one already stored is ignored rather than applied,
-     *     so an out-of-order or retried call can never move the heartbeat backwards and make an
-     *     active app read as idle sooner than it really is.
-     */
-    post: operations['recordAppActivity'];
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
   '/apps/{appId}/password': {
     parameters: {
       query?: never;
@@ -298,6 +267,8 @@ type paths = {
      *     or a specific past version via `configVersion`. `promote: true` by default —
      *     deploying also promotes to production unless explicitly disabled, in which case
      *     the deployment is staged for a later promotion and never runs in the meantime.
+     *     A promoted deployment of a git-backed app runs the branch HEAD: it drops the commit
+     *     the app had pinned on its earlier runs.
      *
      *     An app keeps at most 4 live deployments: the production one(s) and the newest others.
      *     Creating a deployment archives every older one beyond that, exactly as if it were
@@ -460,6 +431,104 @@ type paths = {
     patch?: never;
     trace?: never;
   };
+  '/apps/{appId}/drafts': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List drafts
+     * @description The app's live drafts, newest first. A draft is not listed once it is deleted, nor
+     *     once the platform has removed its workload — the two are the same end for a draft.
+     */
+    get: operations['listDrafts'];
+    put?: never;
+    /**
+     * Create draft
+     * @description Creates a draft and starts it. The draft gets its own hostname, so it is reachable
+     *     independently of production and never takes production traffic.
+     *
+     *     `gitBranch` names the branch the draft syncs. It must already exist: a draft never
+     *     creates a branch, so a name that matches none is an error rather than a new branch,
+     *     and a typo cannot silently hand you an empty draft.
+     *
+     *     The branch is used as it is and shared with anything else using it, so pushing to it
+     *     reaches the draft. Several drafts may deliberately sit on one branch.
+     *
+     *     Because nothing is ever written to the repository, this works with whatever repository
+     *     the app is configured with, including one outside the platform.
+     *
+     *     Not idempotent, and the duplicate is not harmless: every call mints a new draft and
+     *     starts it, so retrying a request that timed out leaves two running workloads on two
+     *     hostnames, both consuming resources. They differ only by id. Delete the one you do not
+     *     want. Several drafts may deliberately share a branch, so nothing rejects the second one.
+     */
+    post: operations['createDraft'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/apps/{appId}/drafts/{draftId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get draft detail
+     * @description One draft, in exactly the shape `GET /apps/{appId}/drafts` returns for it, so a client
+     *     never has to tell the two apart.
+     *
+     *     A draft that belongs to a different app is `404` here, not an error saying it is
+     *     someone else's — a reply that distinguished the two would confirm the id exists.
+     */
+    get: operations['getDraft'];
+    put?: never;
+    post?: never;
+    /**
+     * Delete draft
+     * @description Stops and removes the draft's workload. The branch itself is untouched — deleting a
+     *     draft never changes the Git repository.
+     *
+     *     The draft stops being listed and can no longer be addressed, so deleting the same
+     *     draft twice returns `404` the second time.
+     */
+    delete: operations['deleteDraft'];
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/apps/{appId}/drafts/{draftId}/preview-link': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Create draft preview link
+     * @description Mints a short-lived link that opens the draft in a browser without the app's own
+     *     authentication. The link points at the draft's own `url`, never at the app's
+     *     production URL, and works only there. The token is in the URL fragment and is valid
+     *     for 60 seconds; opening the link starts a preview session on the draft host.
+     *
+     *     Works for a draft of any app, whatever the app's own mode.
+     */
+    post: operations['createDraftPreviewLink'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/apps/{appId}/git-repo': {
     parameters: {
       query?: never;
@@ -535,6 +604,61 @@ type paths = {
     patch?: never;
     trace?: never;
   };
+  '/apps/{appId}/git-repo/tree': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List a directory of the app's Git repository
+     * @description Lists one level of a directory of the app's Git repository (no recursion): directories
+     *     first, then by name, at most 1000 entries (`truncated` is `true` when the listing was cut).
+     *     `size` is the byte size of regular files and `null` for directories, symlinks and
+     *     submodules. The repository is resolved as for `listAppGitRepoBranches`; credentials are
+     *     never accepted in the request. `commit` is the commit the listing was read from - send it
+     *     back as `ref` to keep reading the same snapshot.
+     *
+     *     Requires a master (admin) token of a project member whose role is not `readOnly`.
+     */
+    get: operations['getAppGitRepoTree'];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/apps/{appId}/git-repo/file': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Read a file from the app's Git repository
+     * @description Returns the content of one regular file of the app's Git repository, at most 1 MiB
+     *     (1048576 bytes). The content is returned as text (`encoding: utf-8`) when the bytes are
+     *     valid UTF-8 with no NUL byte in the first 8000 bytes, otherwise base64-encoded
+     *     (`encoding: base64`). Directories, symlinks and submodules are refused. The repository is
+     *     resolved as for `listAppGitRepoBranches`; credentials are never accepted in the request.
+     *     `commit` is the commit the file was read from - send it back as `ref` to keep reading the
+     *     same snapshot.
+     *
+     *     Requires a master (admin) token of a project member whose role is not `readOnly`.
+     */
+    get: operations['getAppGitRepoFile'];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/apps/{appId}/git-repo/credentials': {
     parameters: {
       query?: never;
@@ -782,6 +906,48 @@ type components = {
       /** @description Pins this deployment to a specific Storage config version instead of whatever is newest at the moment of the request. Omit to deploy the latest version. */
       configVersion?: string | null;
     };
+    Draft: {
+      /**
+       * Format: uuid
+       * @description Draft id, assigned when the draft is created.
+       */
+      id: string;
+      /**
+       * @description The draft's own public URL — its own hostname, separate from the app's production URL. `null` until the draft's workload has come far enough up for the platform to assign one, which is always the case in the response to `POST .../drafts`.
+       *     Observed, like `runState`: it appears a moment after the platform assigns it. Once set it stays set — a draft that has suspended itself still answers on it, and the request is what wakes the draft back up.
+       */
+      url: string | null;
+      /** @description The branch of the app's Git repository this draft syncs. Push to it and the draft picks the change up without a redeploy. This is a Git branch, unrelated to the Keboola branch the app lives in. */
+      gitBranch: string;
+      /**
+       * @description Whether this draft currently has a live, healthy workload.
+       *
+       *     | Value | Meaning |
+       *     |---|---|
+       *     | `neverRun` | Created, and nothing has observed it starting yet. |
+       *     | `pending` | Requested but not yet executing (pulling an image, scheduling). |
+       *     | `starting` | Executing but not ready yet. |
+       *     | `running` | Up and healthy. |
+       *     | `stopping` / `stopped` | Shutting down, or stopped after running. A draft suspends itself after about 15 minutes idle, so `stopped` is its normal resting state between sessions. |
+       *     | `failed` | Crashed, failed to start, or hit a terminal error. |
+       *
+       *     The value is observed, so it lags the workload by the time it takes the
+       *     platform to report a change. The response to `POST /apps/{appId}/drafts` is
+       *     always `neverRun`, because the draft has only just been asked for.
+       * @enum {string}
+       */
+      runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
+      /**
+       * Format: date-time
+       * @description When the draft was created.
+       */
+      createdAt: string;
+    };
+    /** @description Which branch of the app's Git repository the draft syncs. */
+    DraftCreateRequest: {
+      /** @description A branch of the app's Git repository that already exists, which this draft syncs as-is. This names the draft's branch; it is not a point to start a new one at, and nothing is cut. */
+      gitBranch: string;
+    };
     CreateCredentialRequest: {
       /** @enum {string} */
       type: 'ssh_key' | 'http_token';
@@ -854,6 +1020,75 @@ type components = {
        */
       truncated: boolean;
     };
+    GitTree: {
+      /**
+       * @description The ref the listing was made at (requested, configured or default branch).
+       * @example main
+       */
+      ref: string;
+      /**
+       * @description Full SHA of the commit the listing was read from (the ref resolved; an annotated tag peeled to its commit).
+       * @example 3f46562c1b08c6ee1f6bc64428daf4f26dc9ba70
+       */
+      commit: string;
+      /**
+       * @description The listed directory, normalized (`""` is the repository root).
+       * @example src
+       */
+      path: string;
+      entries: components['schemas']['GitTreeEntry'][];
+      /**
+       * @description `true` when the listing was cut at 1000 entries.
+       * @example false
+       */
+      truncated: boolean;
+    };
+    GitTreeEntry: {
+      /** @example app.py */
+      name: string;
+      /**
+       * @description Path relative to the repository root.
+       * @example src/app.py
+       */
+      path: string;
+      /**
+       * @example file
+       * @enum {string}
+       */
+      type: 'file' | 'dir' | 'symlink' | 'submodule';
+      /**
+       * @description Byte size of regular files, `null` otherwise.
+       * @example 120
+       */
+      size: number | null;
+    };
+    GitFile: {
+      /**
+       * @description The ref the file was read at (requested, configured or default branch).
+       * @example main
+       */
+      ref: string;
+      /**
+       * @description Full SHA of the commit the file was read from (the ref resolved; an annotated tag peeled to its commit).
+       * @example 3f46562c1b08c6ee1f6bc64428daf4f26dc9ba70
+       */
+      commit: string;
+      /** @example src/app.py */
+      path: string;
+      /**
+       * @description Byte size of the file.
+       * @example 9
+       */
+      size: number;
+      /**
+       * @description `utf-8` when the bytes are valid UTF-8 with no NUL in the first 8000 bytes, otherwise `base64`.
+       * @example utf-8
+       * @enum {string}
+       */
+      encoding: 'utf-8' | 'base64';
+      /** @example print(1) */
+      content: string;
+    };
   };
   responses: never;
   parameters: never;
@@ -939,6 +1174,13 @@ interface operations {
           'application/json': components['schemas']['App'];
         };
       };
+      /** @description Forbidden — the token is not allowed to create apps in the project. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
       /** @description Unprocessable Entity */
       422: {
         headers: {
@@ -1171,63 +1413,6 @@ interface operations {
       };
     };
   };
-  recordAppActivity: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path: {
-        appId: string;
-      };
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        'application/json': {
-          /** Format: date-time */
-          lastRequestTimestamp: string;
-        };
-      };
-    };
-    responses: {
-      /** @description No Content — recorded */
-      204: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Unauthorized */
-      401: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden — the token is valid but lacks the `apps:proxy` scope. A Storage API token is rejected here whatever its project, unlike every other endpoint on this app. */
-      403: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Not Found */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Unprocessable Entity — missing or malformed `lastRequestTimestamp` */
-      422: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['ErrorResponse'];
-        };
-      };
-    };
-  };
   getAppPassword: {
     parameters: {
       query?: never;
@@ -1472,7 +1657,7 @@ interface operations {
           'application/json': components['schemas']['Deployment'];
         };
       };
-      /** @description Bad Request — the app belongs to a different project than the token's, or `configVersion` names a version that does not exist for this app's config. */
+      /** @description Bad Request — the app belongs to a different project than the token's, `configVersion` names a version that does not exist for this app's config, or the configuration at that version is invalid. Nothing is created in any of these cases. */
       400: {
         headers: {
           [name: string]: unknown;
@@ -1810,9 +1995,12 @@ interface operations {
       };
     };
   };
-  getAppGitRepo: {
+  listDrafts: {
     parameters: {
-      query?: never;
+      query?: {
+        offset?: number;
+        limit?: number;
+      };
       header?: never;
       path: {
         appId: string;
@@ -1827,18 +2015,11 @@ interface operations {
           [name: string]: unknown;
         };
         content: {
-          'application/json': {
-            /** @description SSH clone URL. `null` for a repository configured over HTTP(S). */
-            sshUrl: string | null;
-            /** @description HTTPS clone URL. `null` for a repository configured over SSH. */
-            httpsUrl: string | null;
-            /** @description Whether the repository is a managed Git repository provisioned by the service. */
-            isManagedGitRepo: boolean;
-          };
+          'application/json': components['schemas']['Draft'][];
         };
       };
-      /** @description Forbidden — the app belongs to a different project than the token's. */
-      403: {
+      /** @description Bad Request — the app belongs to a different project than the token's, or `offset` or `limit` is not valid. */
+      400: {
         headers: {
           [name: string]: unknown;
         };
@@ -1851,16 +2032,258 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Conflict — the app has no Git repository configured. */
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
     };
   };
-  listAppGitRepoBranches: {
+  createDraft: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        'application/json': components['schemas']['DraftCreateRequest'];
+      };
+    };
+    responses: {
+      /** @description Created — the draft exists and its workload is starting. `url` is `null` in this response: the hostname is assigned while the workload comes up, so read it from `GET /apps/{appId}/drafts` once the draft is running. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['Draft'];
+        };
+      };
+      /** @description Bad Request — the app belongs to a different project than the token's, or `gitBranch` names a branch the app's repository does not have. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found — no such app. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict — the app has never been deployed, so there is nothing for a draft to belong to. Deploy the app first. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Unprocessable Entity — the body is not a usable request: `gitBranch` is missing, empty, or the body carries a field this endpoint does not accept. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  getDraft: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        draftId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['Draft'];
+        };
+      };
+      /** @description Bad Request — the app belongs to a different project than the token's. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found — no live draft with this id on this app. Also the answer for a draft that exists on another app, and for one that has been deleted. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  deleteDraft: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        draftId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description No Content — the draft is deleted. */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Bad Request — the app belongs to a different project than the token's. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found — no such live draft on this app. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  createDraftPreviewLink: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+        draftId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          /** @example no-store, private */
+          'Cache-Control'?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "url": "https://draft-01a0a8fc-eedd-70a0-b0a5-0db120d05acc.hub.keboola.com/_proxy/preview#t=eyJhbGciOiJFUzI1NiIs...",
+           *       "linkExpiresAt": "2026-11-05T10:01:00+00:00"
+           *     }
+           */
+          'application/json': {
+            /**
+             * Format: url
+             * @description The draft's `url` origin + `/_proxy/preview#t=<token>`.
+             */
+            url: string;
+            /** Format: date-time */
+            linkExpiresAt: string;
+          };
+        };
+      };
+      /**
+       * @description Bad Request — the app belongs to a different project than the token's, or the
+       *     draft has no `url` yet (`Draft "<id>" has no URL yet.`). Retry once the draft
+       *     reports a `url`.
+       */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found — no live draft with this id on this app. Also the answer for a draft that exists on another app, and for one that has been deleted. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Preview links are not configured on this stack (`App preview links are not configured.`). */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  getAppGitRepo: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': {
+            /** @description SSH clone URL. `null` for a repository configured over HTTP(S). */
+            sshUrl: string | null;
+            /** @description HTTPS clone URL. `null` for a repository configured over SSH. */
+            httpsUrl: string | null;
+            /** @description Whether the repository is a managed Git repository provisioned by the service. */
+            isManagedGitRepo: boolean;
+          };
+        };
+      };
+      /** @description Forbidden — the app belongs to a different project than the token's. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Not Found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Conflict — the app has no Git repository configured. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  listAppGitRepoBranches: {
     parameters: {
       query?: never;
       header?: never;
@@ -1916,6 +2339,15 @@ interface operations {
           'application/json': components['schemas']['ErrorResponse'];
         };
       };
+      /** @description Service Unavailable — the Git provider's rate limit was reached; retry later. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
       /** @description Gateway Timeout — the Git provider or the git operation timed out; retry later. */
       504: {
         headers: {
@@ -1995,6 +2427,213 @@ interface operations {
           'application/json': components['schemas']['ErrorResponse'];
         };
       };
+      /** @description Service Unavailable — the Git provider's rate limit was reached; retry later. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Gateway Timeout — the Git provider or the git operation timed out; retry later. */
+      504: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+    };
+  };
+  getAppGitRepoTree: {
+    parameters: {
+      query?: {
+        /** @description Branch, tag or full 40-character commit SHA (abbreviated SHAs are not supported and answer 404). Defaults to the branch configured in the app's latest saved config (`parameters.dataApp.git.branch`, for a managed repository too; an empty value counts as not configured), then the repository's default branch. */
+        ref?: string;
+        /** @description Directory path relative to the repository root, without a leading slash. Defaults to the root. */
+        path?: string;
+      };
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['GitTree'];
+        };
+      };
+      /** @description Bad Request — invalid `ref` or `path`. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Forbidden — the app belongs to a different project than the token's, or the token is not a master token of a project member, or the member's role is `readOnly`. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Not Found — the app doesn't exist or is not a data app, or the ref or path doesn't exist. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Conflict — the app has no Git repository configured, its stored Git configuration is invalid, or the repository is not accessible with the stored credentials. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Unprocessable Entity — the path is not a directory. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Bad Gateway — the Git provider failed or returned an unexpected response. */
+      502: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Service Unavailable — the Git provider's rate limit was reached; retry later. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Gateway Timeout — the Git provider or the git operation timed out; retry later. */
+      504: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+    };
+  };
+  getAppGitRepoFile: {
+    parameters: {
+      query: {
+        /** @description Branch, tag or full 40-character commit SHA (abbreviated SHAs are not supported and answer 404). Defaults to the branch configured in the app's latest saved config (`parameters.dataApp.git.branch`, for a managed repository too; an empty value counts as not configured), then the repository's default branch. */
+        ref?: string;
+        /** @description File path relative to the repository root, without a leading slash. */
+        path: string;
+      };
+      header?: never;
+      path: {
+        appId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['GitFile'];
+        };
+      };
+      /** @description Bad Request — invalid `ref`, or `path` missing or invalid. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Forbidden — the app belongs to a different project than the token's, or the token is not a master token of a project member, or the member's role is `readOnly`. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Not Found — the app doesn't exist or is not a data app, or the ref or path doesn't exist. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Conflict — the app has no Git repository configured, its stored Git configuration is invalid, or the repository is not accessible with the stored credentials. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Unprocessable Entity — the path is a directory, symlink or submodule, or the file exceeds 1 MiB (1048576 bytes). */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Bad Gateway — the Git provider failed or returned an unexpected response. */
+      502: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
+      /** @description Service Unavailable — the Git provider's rate limit was reached; retry later. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': components['schemas']['ErrorResponse'];
+        };
+      };
       /** @description Gateway Timeout — the Git provider or the git operation timed out; retry later. */
       504: {
         headers: {
@@ -2181,6 +2820,9 @@ type DeploymentBuildState = Deployment['buildState'];
 type DeploymentRunState = Deployment['runState'];
 type AppRun = components['schemas']['Run'];
 type AppPassword = OpenapiReturnType<paths['/apps/{appId}/password']['get']>;
+type Draft = components['schemas']['Draft'];
+type DraftRunState = Draft['runState'];
+type DraftPreviewLink = OpenapiReturnType<paths['/apps/{appId}/drafts/{draftId}/preview-link']['post']>;
 type AppGitRepo = OpenapiReturnType<paths['/apps/{appId}/git-repo']['get']>;
 type Credential = components['schemas']['Credential'];
 type CreatedCredential = components['schemas']['CreatedCredential'];
@@ -2188,14 +2830,17 @@ type CredentialList = components['schemas']['CredentialList'];
 type AppId = OpenapiPathType<paths['/apps/{appId}']['get']>['appId'];
 type DeploymentId = OpenapiPathType<paths['/apps/{appId}/deployments/{deploymentId}']['get']>['deploymentId'];
 type RunId = OpenapiPathType<paths['/apps/{appId}/runs/{runId}']['get']>['runId'];
+type DraftId = OpenapiPathType<paths['/apps/{appId}/drafts/{draftId}']['get']>['draftId'];
 type CredentialId = OpenapiPathType<paths['/apps/{appId}/git-repo/credentials/{credentialId}']['get']>['credentialId'];
 type GetAppGitEntrypointsQuery = OpenapiQueryType<paths['/apps/{appId}/git-repo/entrypoints']['get']>;
 type GetAppsQuery = OpenapiQueryType<paths['/apps']['get']>;
 type GetAppRunsQuery = OpenapiQueryType<paths['/apps/{appId}/runs']['get']>;
+type GetDraftsQuery = OpenapiQueryType<paths['/apps/{appId}/drafts']['get']>;
 type GetDeploymentsQuery = OpenapiQueryType<paths['/apps/{appId}/deployments']['get']>;
 type GetLogsTailQuery = OpenapiQueryType<paths['/apps/{appId}/logs/tail']['get']>;
 type CreateAppBody = OpenapiBodyType<paths['/apps']['post']>;
 type CreateDeploymentBody = OpenapiBodyType<paths['/apps/{appId}/deployments']['post']>;
+type CreateDraftBody = OpenapiBodyType<paths['/apps/{appId}/drafts']['post']>;
 type CreateCredentialBody = OpenapiBodyType<paths['/apps/{appId}/git-repo/credentials']['post']>;
-export { RunId as C, components as E, GetLogsTailQuery as S, parseLogLines as T, DeploymentRunState as _, AppRun as a, GetAppsQuery as b, CreateCredentialBody as c, Credential as d, CredentialId as f, DeploymentId as g, DeploymentBuildState as h, AppPassword as i, CreateDeploymentBody as l, Deployment as m, AppGitRepo as n, AppState as o, CredentialList as p, AppId as r, CreateAppBody as s, App as t, CreatedCredential as u, GetAppGitEntrypointsQuery as v, LogEntry as w, GetDeploymentsQuery as x, GetAppRunsQuery as y };
-//# sourceMappingURL=types-CRC4lbPw.d.cts.map
+export { LogEntry as A, GetAppGitEntrypointsQuery as C, GetDraftsQuery as D, GetDeploymentsQuery as E, components as M, GetLogsTailQuery as O, DraftRunState as S, GetAppsQuery as T, DeploymentId as _, AppRun as a, DraftId as b, CreateCredentialBody as c, CreatedCredential as d, Credential as f, DeploymentBuildState as g, Deployment as h, AppPassword as i, parseLogLines as j, RunId as k, CreateDeploymentBody as l, CredentialList as m, AppGitRepo as n, AppState as o, CredentialId as p, AppId as r, CreateAppBody as s, App as t, CreateDraftBody as u, DeploymentRunState as v, GetAppRunsQuery as w, DraftPreviewLink as x, Draft as y };
+//# sourceMappingURL=types-Dteot3tT.d.ts.map