@knowledge-stack/ksapi 1.8.0 → 1.9.0

package/dist/models/PaginatedResponseDocumentContentPathPart.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { DocumentContentPathPart } from './DocumentContentPathPart';
+/**
+ *
+ * @export
+ * @interface PaginatedResponseDocumentContentPathPart
+ */
+export interface PaginatedResponseDocumentContentPathPart {
+    /**
+     * List of items
+     * @type {Array<DocumentContentPathPart>}
+     * @memberof PaginatedResponseDocumentContentPathPart
+     */
+    items: Array<DocumentContentPathPart>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof PaginatedResponseDocumentContentPathPart
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof PaginatedResponseDocumentContentPathPart
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof PaginatedResponseDocumentContentPathPart
+     */
+    offset: number;
+}
+/**
+ * Check if a given object implements the PaginatedResponseDocumentContentPathPart interface.
+ */
+export declare function instanceOfPaginatedResponseDocumentContentPathPart(value: object): value is PaginatedResponseDocumentContentPathPart;
+export declare function PaginatedResponseDocumentContentPathPartFromJSON(json: any): PaginatedResponseDocumentContentPathPart;
+export declare function PaginatedResponseDocumentContentPathPartFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseDocumentContentPathPart;
+export declare function PaginatedResponseDocumentContentPathPartToJSON(json: any): PaginatedResponseDocumentContentPathPart;
+export declare function PaginatedResponseDocumentContentPathPartToJSONTyped(value?: PaginatedResponseDocumentContentPathPart | null, ignoreDiscriminator?: boolean): any;
+export declare const PaginatedResponseDocumentContentPathPartPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};

package/dist/models/PaginatedResponseDocumentContentPathPart.js

@@ -0,0 +1,78 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginatedResponseDocumentContentPathPartPropertyValidationAttributesMap = void 0;
+exports.instanceOfPaginatedResponseDocumentContentPathPart = instanceOfPaginatedResponseDocumentContentPathPart;
+exports.PaginatedResponseDocumentContentPathPartFromJSON = PaginatedResponseDocumentContentPathPartFromJSON;
+exports.PaginatedResponseDocumentContentPathPartFromJSONTyped = PaginatedResponseDocumentContentPathPartFromJSONTyped;
+exports.PaginatedResponseDocumentContentPathPartToJSON = PaginatedResponseDocumentContentPathPartToJSON;
+exports.PaginatedResponseDocumentContentPathPartToJSONTyped = PaginatedResponseDocumentContentPathPartToJSONTyped;
+const DocumentContentPathPart_1 = require("./DocumentContentPathPart");
+/**
+ * Check if a given object implements the PaginatedResponseDocumentContentPathPart interface.
+ */
+function instanceOfPaginatedResponseDocumentContentPathPart(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+function PaginatedResponseDocumentContentPathPartFromJSON(json) {
+    return PaginatedResponseDocumentContentPathPartFromJSONTyped(json, false);
+}
+function PaginatedResponseDocumentContentPathPartFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(DocumentContentPathPart_1.DocumentContentPathPartFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+    };
+}
+function PaginatedResponseDocumentContentPathPartToJSON(json) {
+    return PaginatedResponseDocumentContentPathPartToJSONTyped(json, false);
+}
+function PaginatedResponseDocumentContentPathPartToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(DocumentContentPathPart_1.DocumentContentPathPartToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+    };
+}
+exports.PaginatedResponseDocumentContentPathPartPropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};

package/dist/models/PaginatedResponseFolderDocumentResponse.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { FolderDocumentResponse } from './FolderDocumentResponse';
+/**
+ *
+ * @export
+ * @interface PaginatedResponseFolderDocumentResponse
+ */
+export interface PaginatedResponseFolderDocumentResponse {
+    /**
+     * List of items
+     * @type {Array<FolderDocumentResponse>}
+     * @memberof PaginatedResponseFolderDocumentResponse
+     */
+    items: Array<FolderDocumentResponse>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof PaginatedResponseFolderDocumentResponse
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof PaginatedResponseFolderDocumentResponse
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof PaginatedResponseFolderDocumentResponse
+     */
+    offset: number;
+}
+/**
+ * Check if a given object implements the PaginatedResponseFolderDocumentResponse interface.
+ */
+export declare function instanceOfPaginatedResponseFolderDocumentResponse(value: object): value is PaginatedResponseFolderDocumentResponse;
+export declare function PaginatedResponseFolderDocumentResponseFromJSON(json: any): PaginatedResponseFolderDocumentResponse;
+export declare function PaginatedResponseFolderDocumentResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseFolderDocumentResponse;
+export declare function PaginatedResponseFolderDocumentResponseToJSON(json: any): PaginatedResponseFolderDocumentResponse;
+export declare function PaginatedResponseFolderDocumentResponseToJSONTyped(value?: PaginatedResponseFolderDocumentResponse | null, ignoreDiscriminator?: boolean): any;
+export declare const PaginatedResponseFolderDocumentResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};

package/dist/models/PaginatedResponseFolderDocumentResponse.js

@@ -0,0 +1,78 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginatedResponseFolderDocumentResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfPaginatedResponseFolderDocumentResponse = instanceOfPaginatedResponseFolderDocumentResponse;
+exports.PaginatedResponseFolderDocumentResponseFromJSON = PaginatedResponseFolderDocumentResponseFromJSON;
+exports.PaginatedResponseFolderDocumentResponseFromJSONTyped = PaginatedResponseFolderDocumentResponseFromJSONTyped;
+exports.PaginatedResponseFolderDocumentResponseToJSON = PaginatedResponseFolderDocumentResponseToJSON;
+exports.PaginatedResponseFolderDocumentResponseToJSONTyped = PaginatedResponseFolderDocumentResponseToJSONTyped;
+const FolderDocumentResponse_1 = require("./FolderDocumentResponse");
+/**
+ * Check if a given object implements the PaginatedResponseFolderDocumentResponse interface.
+ */
+function instanceOfPaginatedResponseFolderDocumentResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+function PaginatedResponseFolderDocumentResponseFromJSON(json) {
+    return PaginatedResponseFolderDocumentResponseFromJSONTyped(json, false);
+}
+function PaginatedResponseFolderDocumentResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(FolderDocumentResponse_1.FolderDocumentResponseFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+    };
+}
+function PaginatedResponseFolderDocumentResponseToJSON(json) {
+    return PaginatedResponseFolderDocumentResponseToJSONTyped(json, false);
+}
+function PaginatedResponseFolderDocumentResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(FolderDocumentResponse_1.FolderDocumentResponseToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+    };
+}
+exports.PaginatedResponseFolderDocumentResponsePropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};

package/dist/models/index.d.ts

@@ -8,12 +8,14 @@ export * from './CreateFolderRequest';
 export * from './CreatePasswordUserRequest';
 export * from './CreateSectionRequest';
 export * from './CreateTenantRequest';
+export * from './DocumentContentPathPart';
 export * from './DocumentOrigin';
 export * from './DocumentResponse';
 export * from './DocumentType';
 export * from './DocumentVersionResponse';
 export * from './EmailSentResponse';
 export * from './EmailVerificationRequest';
+export * from './FolderDocumentResponse';
 export * from './FolderResponse';
 export * from './HTTPValidationError';
 export * from './HealthCheckResponse';
@@ -22,8 +24,10 @@ export * from './InviteResponse';
 export * from './InviteStatus';
 export * from './InviteUserRequest';
 export * from './OAuth2Config';
+export * from './PaginatedResponseDocumentContentPathPart';
 export * from './PaginatedResponseDocumentResponse';
 export * from './PaginatedResponseDocumentVersionResponse';
+export * from './PaginatedResponseFolderDocumentResponse';
 export * from './PaginatedResponseFolderResponse';
 export * from './PaginatedResponseInviteResponse';
 export * from './PaginatedResponsePathPartResponse';

package/dist/models/index.js

@@ -26,12 +26,14 @@ __exportStar(require("./CreateFolderRequest"), exports);
 __exportStar(require("./CreatePasswordUserRequest"), exports);
 __exportStar(require("./CreateSectionRequest"), exports);
 __exportStar(require("./CreateTenantRequest"), exports);
+__exportStar(require("./DocumentContentPathPart"), exports);
 __exportStar(require("./DocumentOrigin"), exports);
 __exportStar(require("./DocumentResponse"), exports);
 __exportStar(require("./DocumentType"), exports);
 __exportStar(require("./DocumentVersionResponse"), exports);
 __exportStar(require("./EmailSentResponse"), exports);
 __exportStar(require("./EmailVerificationRequest"), exports);
+__exportStar(require("./FolderDocumentResponse"), exports);
 __exportStar(require("./FolderResponse"), exports);
 __exportStar(require("./HTTPValidationError"), exports);
 __exportStar(require("./HealthCheckResponse"), exports);
@@ -40,8 +42,10 @@ __exportStar(require("./InviteResponse"), exports);
 __exportStar(require("./InviteStatus"), exports);
 __exportStar(require("./InviteUserRequest"), exports);
 __exportStar(require("./OAuth2Config"), exports);
+__exportStar(require("./PaginatedResponseDocumentContentPathPart"), exports);
 __exportStar(require("./PaginatedResponseDocumentResponse"), exports);
 __exportStar(require("./PaginatedResponseDocumentVersionResponse"), exports);
+__exportStar(require("./PaginatedResponseFolderDocumentResponse"), exports);
 __exportStar(require("./PaginatedResponseFolderResponse"), exports);
 __exportStar(require("./PaginatedResponseInviteResponse"), exports);
 __exportStar(require("./PaginatedResponsePathPartResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/DocumentVersionsApi.ts

@@ -17,6 +17,7 @@ import * as runtime from '../runtime';
 import type {
   DocumentVersionResponse,
   HTTPValidationError,
+  PaginatedResponseDocumentContentPathPart,
   PaginatedResponseDocumentVersionResponse,
 } from '../models/index';
 import {
@@ -24,6 +25,8 @@ import {
     DocumentVersionResponseToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
+    PaginatedResponseDocumentContentPathPartFromJSON,
+    PaginatedResponseDocumentContentPathPartToJSON,
     PaginatedResponseDocumentVersionResponseFromJSON,
     PaginatedResponseDocumentVersionResponseToJSON,
 } from '../models/index';
@@ -43,6 +46,14 @@ export interface GetDocumentVersionRequest {
     ksUat?: string;
 }
 
+export interface GetDocumentVersionContentsRequest {
+    versionId: string;
+    sectionId?: string;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
+
 export interface ListDocumentVersionsRequest {
     documentId: string;
     limit?: number;
@@ -108,6 +119,26 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
 
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * @summary Get Document Version Contents Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
+
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * @summary List Document Versions Handler
@@ -250,6 +281,57 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
         return await response.value();
     }
 
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    async getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>> {
+        if (requestParameters['versionId'] == null) {
+            throw new runtime.RequiredError(
+                'versionId',
+                'Required parameter "versionId" was null or undefined when calling getDocumentVersionContents().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['sectionId'] != null) {
+            queryParameters['section_id'] = requestParameters['sectionId'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/document_versions/{version_id}/contents`;
+        urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseDocumentContentPathPartFromJSON(jsonValue));
+    }
+
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    async getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart> {
+        const response = await this.getDocumentVersionContentsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler

package/src/apis/FoldersApi.ts

@@ -18,6 +18,7 @@ import type {
   CreateFolderRequest,
   FolderResponse,
   HTTPValidationError,
+  PaginatedResponseFolderDocumentResponse,
   PaginatedResponseFolderResponse,
   PathOrder,
   UpdateFolderRequest,
@@ -29,6 +30,8 @@ import {
     FolderResponseToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
+    PaginatedResponseFolderDocumentResponseFromJSON,
+    PaginatedResponseFolderDocumentResponseToJSON,
     PaginatedResponseFolderResponseFromJSON,
     PaginatedResponseFolderResponseToJSON,
     PathOrderFromJSON,
@@ -52,6 +55,15 @@ export interface GetFolderRequest {
     ksUat?: string;
 }
 
+export interface ListFolderContentsRequest {
+    folderId: string;
+    maxDepth?: number;
+    sortOrder?: PathOrder;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
+
 export interface ListFoldersRequest {
     parentId?: string;
     sortOrder?: PathOrder;
@@ -124,6 +136,27 @@ 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  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)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+
+    /**
+     * 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  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>;
+
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * @summary List Folders Handler
@@ -287,6 +320,61 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
         return await response.value();
     }
 
+    /**
+     * 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  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
+     */
+    async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>> {
+        if (requestParameters['folderId'] == null) {
+            throw new runtime.RequiredError(
+                'folderId',
+                'Required parameter "folderId" was null or undefined when calling listFolderContents().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['maxDepth'] != null) {
+            queryParameters['max_depth'] = requestParameters['maxDepth'];
+        }
+
+        if (requestParameters['sortOrder'] != null) {
+            queryParameters['sort_order'] = requestParameters['sortOrder'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/v1/folders/{folder_id}/contents`;
+        urlPath = urlPath.replace(`{${"folder_id"}}`, encodeURIComponent(String(requestParameters['folderId'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseFolderDocumentResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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  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
+     */
+    async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse> {
+        const response = await this.listFolderContentsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * List Folders Handler

package/src/apis/PathPartsApi.ts

@@ -38,7 +38,6 @@ export interface GetPathPartRequest {
 
 export interface ListPathPartsRequest {
     parentId?: string;
-    includeDocuments?: boolean;
     maxDepth?: number;
     sortOrder?: PathOrder;
     limit?: number;
@@ -71,10 +70,9 @@ export interface PathPartsApiInterface {
     getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
 
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * @summary List Path Parts Handler
      * @param {string} [parentId] Parent PathPart ID (defaults to root)
-     * @param {boolean} [includeDocuments] Include documents in results (default: False, folders only)
      * @param {number} [maxDepth] Maximum depth to traverse (1 &#x3D; direct children, default: 1)
      * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
      * @param {number} [limit] Number of items per page
@@ -87,7 +85,7 @@ export interface PathPartsApiInterface {
     listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>>;
 
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathParts(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
@@ -139,7 +137,7 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
     }
 
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     async listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>> {
@@ -149,10 +147,6 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
             queryParameters['parent_id'] = requestParameters['parentId'];
         }
 
-        if (requestParameters['includeDocuments'] != null) {
-            queryParameters['include_documents'] = requestParameters['includeDocuments'];
-        }
-
         if (requestParameters['maxDepth'] != null) {
             queryParameters['max_depth'] = requestParameters['maxDepth'];
         }
@@ -185,7 +179,7 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
     }
 
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     async listPathParts(requestParameters: ListPathPartsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse> {