@knowledge-stack/ksapi 1.23.4 → 1.24.0

package/dist/apis/DocumentsApi.d.ts

@@ -50,6 +50,14 @@ export interface UpdateDocumentOperationRequest {
  * @interface DocumentsApiInterface
  */
 export interface DocumentsApiInterface {
+    /**
+     * Creates request options for createDocument without sending the request
+     * @param {CreateDocumentRequest} createDocumentRequest
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    createDocumentRequestOpts(requestParameters: CreateDocumentOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new document with initial v0 version.  The document is created as a child of the specified parent folder. An initial version (v0) is automatically created.
      * @summary Create Document Handler
@@ -65,6 +73,14 @@ export interface DocumentsApiInterface {
      * Create Document Handler
      */
     createDocument(requestParameters: CreateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
+    /**
+     * Creates request options for deleteDocument without sending the request
+     * @param {string} documentId
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    deleteDocumentRequestOpts(requestParameters: DeleteDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a document and all its contents.  WARNING: This cascades to all children (versions, sections, chunks, etc.) due to parent_id ON DELETE CASCADE.
      * @summary Delete Document Handler
@@ -80,6 +96,15 @@ export interface DocumentsApiInterface {
      * Delete Document Handler
      */
     deleteDocument(requestParameters: DeleteDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getDocument without sending the request
+     * @param {string} documentId
+     * @param {boolean} [withTags] Include tags in the response (default: false)
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    getDocumentRequestOpts(requestParameters: GetDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a document by its document ID.
      * @summary Get Document Handler
@@ -96,6 +121,16 @@ export interface DocumentsApiInterface {
      * Get Document Handler
      */
     getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
+    /**
+     * Creates request options for ingestDocument without sending the request
+     * @param {Blob} file
+     * @param {string} pathPartId Parent path part ID (must be a FOLDER type)
+     * @param {string} [ksUat]
+     * @param {string} [name] Document name (defaults to filename)
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    ingestDocumentRequestOpts(requestParameters: IngestDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
      * @summary Ingest Document Handler
@@ -113,6 +148,18 @@ export interface DocumentsApiInterface {
      * Ingest Document Handler
      */
     ingestDocument(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestDocumentResponse>;
+    /**
+     * Creates request options for listDocuments without sending the request
+     * @param {string} [parentPathPartId] Parent PathPart ID (defaults to root)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {boolean} [withTags] Include tags in the response (default: false)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    listDocumentsRequestOpts(requestParameters: ListDocumentsRequest): Promise<runtime.RequestOpts>;
     /**
      * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_path_part_id is not provided, lists top-level documents.
      * @summary List Documents Handler
@@ -132,6 +179,15 @@ export interface DocumentsApiInterface {
      * List Documents Handler
      */
     listDocuments(requestParameters: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentResponse>;
+    /**
+     * Creates request options for updateDocument without sending the request
+     * @param {string} documentId
+     * @param {UpdateDocumentRequest} updateDocumentRequest
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    updateDocumentRequestOpts(requestParameters: UpdateDocumentOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * @summary Update Document Handler
@@ -153,6 +209,10 @@ export interface DocumentsApiInterface {
  *
  */
 export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsApiInterface {
+    /**
+     * Creates request options for createDocument without sending the request
+     */
+    createDocumentRequestOpts(requestParameters: CreateDocumentOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new document with initial v0 version.  The document is created as a child of the specified parent folder. An initial version (v0) is automatically created.
      * Create Document Handler
@@ -163,6 +223,10 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      * Create Document Handler
      */
     createDocument(requestParameters: CreateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
+    /**
+     * Creates request options for deleteDocument without sending the request
+     */
+    deleteDocumentRequestOpts(requestParameters: DeleteDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a document and all its contents.  WARNING: This cascades to all children (versions, sections, chunks, etc.) due to parent_id ON DELETE CASCADE.
      * Delete Document Handler
@@ -173,6 +237,10 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      * Delete Document Handler
      */
     deleteDocument(requestParameters: DeleteDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getDocument without sending the request
+     */
+    getDocumentRequestOpts(requestParameters: GetDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a document by its document ID.
      * Get Document Handler
@@ -183,6 +251,10 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      * Get Document Handler
      */
     getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
+    /**
+     * Creates request options for ingestDocument without sending the request
+     */
+    ingestDocumentRequestOpts(requestParameters: IngestDocumentRequest): Promise<runtime.RequestOpts>;
     /**
      * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
      * Ingest Document Handler
@@ -193,6 +265,10 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      * Ingest Document Handler
      */
     ingestDocument(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestDocumentResponse>;
+    /**
+     * Creates request options for listDocuments without sending the request
+     */
+    listDocumentsRequestOpts(requestParameters: ListDocumentsRequest): Promise<runtime.RequestOpts>;
     /**
      * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_path_part_id is not provided, lists top-level documents.
      * List Documents Handler
@@ -203,6 +279,10 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      * List Documents Handler
      */
     listDocuments(requestParameters?: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentResponse>;
+    /**
+     * Creates request options for updateDocument without sending the request
+     */
+    updateDocumentRequestOpts(requestParameters: UpdateDocumentOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler

package/dist/apis/DocumentsApi.js

@@ -30,10 +30,9 @@ const index_1 = require("../models/index");
  */
 class DocumentsApi extends runtime.BaseAPI {
     /**
-     * Create a new document with initial v0 version.  The document is created as a child of the specified parent folder. An initial version (v0) is automatically created.
-     * Create Document Handler
+     * Creates request options for createDocument without sending the request
      */
-    createDocumentRaw(requestParameters, initOverrides) {
+    createDocumentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['createDocumentRequest'] == null) {
                 throw new runtime.RequiredError('createDocumentRequest', 'Required parameter "createDocumentRequest" was null or undefined when calling createDocument().');
@@ -42,13 +41,23 @@ class DocumentsApi extends runtime.BaseAPI {
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/documents`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.CreateDocumentRequestToJSON)(requestParameters['createDocumentRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Create a new document with initial v0 version.  The document is created as a child of the specified parent folder. An initial version (v0) is automatically created.
+     * Create Document Handler
+     */
+    createDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createDocumentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DocumentResponseFromJSON)(jsonValue));
         });
     }
@@ -63,10 +72,9 @@ class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Delete a document and all its contents.  WARNING: This cascades to all children (versions, sections, chunks, etc.) due to parent_id ON DELETE CASCADE.
-     * Delete Document Handler
+     * Creates request options for deleteDocument without sending the request
      */
-    deleteDocumentRaw(requestParameters, initOverrides) {
+    deleteDocumentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['documentId'] == null) {
                 throw new runtime.RequiredError('documentId', 'Required parameter "documentId" was null or undefined when calling deleteDocument().');
@@ -75,12 +83,22 @@ class DocumentsApi extends runtime.BaseAPI {
             const headerParameters = {};
             let urlPath = `/v1/documents/{document_id}`;
             urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'DELETE',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Delete a document and all its contents.  WARNING: This cascades to all children (versions, sections, chunks, etc.) due to parent_id ON DELETE CASCADE.
+     * Delete Document Handler
+     */
+    deleteDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteDocumentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.VoidApiResponse(response);
         });
     }
@@ -94,10 +112,9 @@ class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Get a document by its document ID.
-     * Get Document Handler
+     * Creates request options for getDocument without sending the request
      */
-    getDocumentRaw(requestParameters, initOverrides) {
+    getDocumentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['documentId'] == null) {
                 throw new runtime.RequiredError('documentId', 'Required parameter "documentId" was null or undefined when calling getDocument().');
@@ -109,12 +126,22 @@ class DocumentsApi extends runtime.BaseAPI {
             const headerParameters = {};
             let urlPath = `/v1/documents/{document_id}`;
             urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Get a document by its document ID.
+     * Get Document Handler
+     */
+    getDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getDocumentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DocumentResponseFromJSON)(jsonValue));
         });
     }
@@ -129,10 +156,9 @@ class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
-     * Ingest Document Handler
+     * Creates request options for ingestDocument without sending the request
      */
-    ingestDocumentRaw(requestParameters, initOverrides) {
+    ingestDocumentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['file'] == null) {
                 throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling ingestDocument().');
@@ -167,13 +193,23 @@ class DocumentsApi extends runtime.BaseAPI {
                 formParams.append('name', requestParameters['name']);
             }
             let urlPath = `/v1/documents/ingest`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
                 body: formParams,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.ingestDocumentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.IngestDocumentResponseFromJSON)(jsonValue));
         });
     }
@@ -188,10 +224,9 @@ class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_path_part_id is not provided, lists top-level documents.
-     * List Documents Handler
+     * Creates request options for listDocuments without sending the request
      */
-    listDocumentsRaw(requestParameters, initOverrides) {
+    listDocumentsRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
             if (requestParameters['parentPathPartId'] != null) {
@@ -211,12 +246,22 @@ class DocumentsApi extends runtime.BaseAPI {
             }
             const headerParameters = {};
             let urlPath = `/v1/documents`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_path_part_id is not provided, lists top-level documents.
+     * List Documents Handler
+     */
+    listDocumentsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listDocumentsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseDocumentResponseFromJSON)(jsonValue));
         });
     }
@@ -231,10 +276,9 @@ class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
-     * Update Document Handler
+     * Creates request options for updateDocument without sending the request
      */
-    updateDocumentRaw(requestParameters, initOverrides) {
+    updateDocumentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['documentId'] == null) {
                 throw new runtime.RequiredError('documentId', 'Required parameter "documentId" was null or undefined when calling updateDocument().');
@@ -247,13 +291,23 @@ class DocumentsApi extends runtime.BaseAPI {
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/documents/{document_id}`;
             urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.UpdateDocumentRequestToJSON)(requestParameters['updateDocumentRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update Document Handler
+     */
+    updateDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.updateDocumentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DocumentResponseFromJSON)(jsonValue));
         });
     }

package/dist/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateFolderRequest, FolderResponse, PaginatedResponseFolderDocumentResponse, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
+import type { CreateFolderRequest, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
     ksUat?: string | null;
@@ -53,6 +53,14 @@ export interface UpdateFolderOperationRequest {
  * @interface FoldersApiInterface
  */
 export interface FoldersApiInterface {
+    /**
+     * Creates request options for createFolder without sending the request
+     * @param {CreateFolderRequest} createFolderRequest
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    createFolderRequestOpts(requestParameters: CreateFolderOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new folder.  The folder is created as a child of the specified parent folder. It is automatically added to the end of the parent\'s children list.
      * @summary Create Folder Handler
@@ -68,6 +76,14 @@ export interface FoldersApiInterface {
      * Create Folder Handler
      */
     createFolder(requestParameters: CreateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * Creates request options for deleteFolder without sending the request
+     * @param {string} folderId
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    deleteFolderRequestOpts(requestParameters: DeleteFolderRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a folder and all its contents.  WARNING: This cascades to all children due to parent_id ON DELETE CASCADE. The root folder cannot be deleted.
      * @summary Delete Folder Handler
@@ -83,6 +99,15 @@ export interface FoldersApiInterface {
      * Delete Folder Handler
      */
     deleteFolder(requestParameters: DeleteFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getFolder without sending the request
+     * @param {string} folderId
+     * @param {boolean} [withTags] Include tags in the response (default: false)
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    getFolderRequestOpts(requestParameters: GetFolderRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a folder by its folder ID.
      * @summary Get Folder Handler
@@ -100,7 +125,20 @@ export interface FoldersApiInterface {
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * Creates request options for listFolderContents without sending the request
+     * @param {string} folderId
+     * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {boolean} [withTags] Include tag IDs for each item (default: false)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    listFolderContentsRequestOpts(requestParameters: ListFolderContentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * @summary List Folder Contents Handler
      * @param {string} folderId
      * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
@@ -113,12 +151,24 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>;
+    /**
+     * Creates request options for listFolders without sending the request
+     * @param {string} [parentPathPartId] Parent PathPart ID (defaults to root)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {boolean} [withTags] Include tags in the response (default: false)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    listFoldersRequestOpts(requestParameters: ListFoldersRequest): Promise<runtime.RequestOpts>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_path_part_id is not provided, lists top-level folders.  At root level, the /users folder is hidden and replaced with the current user\'s personal folder (/users/{user_id}) displayed as \"Personal\".
      * @summary List Folders Handler
@@ -138,6 +188,15 @@ export interface FoldersApiInterface {
      * List Folders Handler
      */
     listFolders(requestParameters: ListFoldersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderResponse>;
+    /**
+     * Creates request options for updateFolder without sending the request
+     * @param {string} folderId
+     * @param {UpdateFolderRequest} updateFolderRequest
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    updateFolderRequestOpts(requestParameters: UpdateFolderOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
      * @summary Update Folder Handler
@@ -159,6 +218,10 @@ export interface FoldersApiInterface {
  *
  */
 export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
+    /**
+     * Creates request options for createFolder without sending the request
+     */
+    createFolderRequestOpts(requestParameters: CreateFolderOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new folder.  The folder is created as a child of the specified parent folder. It is automatically added to the end of the parent\'s children list.
      * Create Folder Handler
@@ -169,6 +232,10 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Create Folder Handler
      */
     createFolder(requestParameters: CreateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * Creates request options for deleteFolder without sending the request
+     */
+    deleteFolderRequestOpts(requestParameters: DeleteFolderRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a folder and all its contents.  WARNING: This cascades to all children due to parent_id ON DELETE CASCADE. The root folder cannot be deleted.
      * Delete Folder Handler
@@ -179,6 +246,10 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Delete Folder Handler
      */
     deleteFolder(requestParameters: DeleteFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getFolder without sending the request
+     */
+    getFolderRequestOpts(requestParameters: GetFolderRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a folder by its folder ID.
      * Get Folder Handler
@@ -190,15 +261,23 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * Creates request options for listFolderContents without sending the request
+     */
+    listFolderContentsRequestOpts(requestParameters: ListFolderContentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>;
+    /**
+     * Creates request options for listFolders without sending the request
+     */
+    listFoldersRequestOpts(requestParameters: ListFoldersRequest): Promise<runtime.RequestOpts>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_path_part_id is not provided, lists top-level folders.  At root level, the /users folder is hidden and replaced with the current user\'s personal folder (/users/{user_id}) displayed as \"Personal\".
      * List Folders Handler
@@ -209,6 +288,10 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * List Folders Handler
      */
     listFolders(requestParameters?: ListFoldersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderResponse>;
+    /**
+     * Creates request options for updateFolder without sending the request
+     */
+    updateFolderRequestOpts(requestParameters: UpdateFolderOperationRequest): Promise<runtime.RequestOpts>;
     /**
      * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
      * Update Folder Handler