@knowledge-stack/ksapi 1.127.0 → 1.128.0

package/.openapi-generator/FILES

@@ -59,6 +59,7 @@ docs/ColumnConfig.md
 docs/ColumnReference.md
 docs/CommonFileExclusionReason.md
 docs/ConnectionConfig.md
+docs/ContentsSortOrder.md
 docs/CreateApiConnectionRequest.md
 docs/CreateApiKeyRequest.md
 docs/CreateApiKeyResponse.md
@@ -448,6 +449,7 @@ src/models/ColumnConfig.ts
 src/models/ColumnReference.ts
 src/models/CommonFileExclusionReason.ts
 src/models/ConnectionConfig.ts
+src/models/ContentsSortOrder.ts
 src/models/CreateApiConnectionRequest.ts
 src/models/CreateApiKeyRequest.ts
 src/models/CreateApiKeyResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.127.0
+# @knowledge-stack/ksapi@1.128.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -316,6 +316,7 @@ All URIs are relative to *http://localhost:8000*
 - [ColumnReference](docs/ColumnReference.md)
 - [CommonFileExclusionReason](docs/CommonFileExclusionReason.md)
 - [ConnectionConfig](docs/ConnectionConfig.md)
+- [ContentsSortOrder](docs/ContentsSortOrder.md)
 - [CreateApiConnectionRequest](docs/CreateApiConnectionRequest.md)
 - [CreateApiKeyRequest](docs/CreateApiKeyRequest.md)
 - [CreateApiKeyResponse](docs/CreateApiKeyResponse.md)
@@ -616,7 +617,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.127.0`
+- Package version: `1.128.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -28,13 +28,20 @@ export interface GetFolderRequest {
 export interface ListFolderContentsRequest {
     folderId: string;
     maxDepth?: number;
-    sortOrder?: PathOrder;
+    sortOrder?: ContentsSortOrder;
+    sortDir?: SortDirection;
+    ownerId?: string | null;
+    nameLike?: string | null;
     withTags?: boolean;
     limit?: number;
     offset?: number;
     approvalState?: Array<PathPartApprovalState> | null;
     includeTagIds?: Array<string> | null;
     excludeTagIds?: Array<string> | null;
+    createdAfter?: Date | null;
+    createdBefore?: Date | null;
+    updatedAfter?: Date | null;
+    updatedBefore?: Date | null;
 }
 export interface ListFoldersRequest {
     parentPathPartId?: string | null;
@@ -160,36 +167,50 @@ export interface FoldersApiInterface {
      * 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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
     listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
@@ -354,12 +375,12 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      */
     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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;

package/dist/apis/FoldersApi.js

@@ -276,6 +276,15 @@ class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['sortOrder'] != null) {
                 queryParameters['sort_order'] = requestParameters['sortOrder'];
             }
+            if (requestParameters['sortDir'] != null) {
+                queryParameters['sort_dir'] = requestParameters['sortDir'];
+            }
+            if (requestParameters['ownerId'] != null) {
+                queryParameters['owner_id'] = requestParameters['ownerId'];
+            }
+            if (requestParameters['nameLike'] != null) {
+                queryParameters['name_like'] = requestParameters['nameLike'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }
@@ -294,6 +303,18 @@ class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['excludeTagIds'] != null) {
                 queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
             }
+            if (requestParameters['createdAfter'] != null) {
+                queryParameters['created_after'] = requestParameters['createdAfter'].toISOString();
+            }
+            if (requestParameters['createdBefore'] != null) {
+                queryParameters['created_before'] = requestParameters['createdBefore'].toISOString();
+            }
+            if (requestParameters['updatedAfter'] != null) {
+                queryParameters['updated_after'] = requestParameters['updatedAfter'].toISOString();
+            }
+            if (requestParameters['updatedBefore'] != null) {
+                queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -313,7 +334,7 @@ class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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, initOverrides) {
@@ -324,7 +345,7 @@ class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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, initOverrides) {

package/dist/esm/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -28,13 +28,20 @@ export interface GetFolderRequest {
 export interface ListFolderContentsRequest {
     folderId: string;
     maxDepth?: number;
-    sortOrder?: PathOrder;
+    sortOrder?: ContentsSortOrder;
+    sortDir?: SortDirection;
+    ownerId?: string | null;
+    nameLike?: string | null;
     withTags?: boolean;
     limit?: number;
     offset?: number;
     approvalState?: Array<PathPartApprovalState> | null;
     includeTagIds?: Array<string> | null;
     excludeTagIds?: Array<string> | null;
+    createdAfter?: Date | null;
+    createdBefore?: Date | null;
+    updatedAfter?: Date | null;
+    updatedBefore?: Date | null;
 }
 export interface ListFoldersRequest {
     parentPathPartId?: string | null;
@@ -160,36 +167,50 @@ export interface FoldersApiInterface {
      * 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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
     listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
@@ -354,12 +375,12 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      */
     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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;

package/dist/esm/apis/FoldersApi.js

@@ -240,6 +240,15 @@ export class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['sortOrder'] != null) {
                 queryParameters['sort_order'] = requestParameters['sortOrder'];
             }
+            if (requestParameters['sortDir'] != null) {
+                queryParameters['sort_dir'] = requestParameters['sortDir'];
+            }
+            if (requestParameters['ownerId'] != null) {
+                queryParameters['owner_id'] = requestParameters['ownerId'];
+            }
+            if (requestParameters['nameLike'] != null) {
+                queryParameters['name_like'] = requestParameters['nameLike'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }
@@ -258,6 +267,18 @@ export class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['excludeTagIds'] != null) {
                 queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
             }
+            if (requestParameters['createdAfter'] != null) {
+                queryParameters['created_after'] = requestParameters['createdAfter'].toISOString();
+            }
+            if (requestParameters['createdBefore'] != null) {
+                queryParameters['created_before'] = requestParameters['createdBefore'].toISOString();
+            }
+            if (requestParameters['updatedAfter'] != null) {
+                queryParameters['updated_after'] = requestParameters['updatedAfter'].toISOString();
+            }
+            if (requestParameters['updatedBefore'] != null) {
+                queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -277,7 +298,7 @@ export class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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, initOverrides) {
@@ -288,7 +309,7 @@ export class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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, initOverrides) {

package/dist/esm/models/ContentsSortOrder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+/**
+ * Sort options for the folder-contents listing.
+ *
+ * Superset of the base :class:`PathOrder` columns plus ``STATUS``
+ * (``approval_state``). Kept separate from ``PathOrder`` so the extra columns
+ * do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+ * @export
+ */
+export declare const ContentsSortOrder: {
+    readonly Logical: "LOGICAL";
+    readonly Name: "NAME";
+    readonly UpdatedAt: "UPDATED_AT";
+    readonly CreatedAt: "CREATED_AT";
+    readonly Status: "STATUS";
+    readonly Owner: "OWNER";
+    readonly Tags: "TAGS";
+};
+export type ContentsSortOrder = typeof ContentsSortOrder[keyof typeof ContentsSortOrder];
+export declare function instanceOfContentsSortOrder(value: any): boolean;
+export declare function ContentsSortOrderFromJSON(json: any): ContentsSortOrder;
+export declare function ContentsSortOrderFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsSortOrder;
+export declare function ContentsSortOrderToJSON(value?: ContentsSortOrder | null): any;
+export declare function ContentsSortOrderToJSONTyped(value: any, ignoreDiscriminator: boolean): ContentsSortOrder;

package/dist/esm/models/ContentsSortOrder.js

@@ -0,0 +1,52 @@
+/* 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.
+ */
+/**
+ * Sort options for the folder-contents listing.
+ *
+ * Superset of the base :class:`PathOrder` columns plus ``STATUS``
+ * (``approval_state``). Kept separate from ``PathOrder`` so the extra columns
+ * do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+ * @export
+ */
+export const ContentsSortOrder = {
+    Logical: 'LOGICAL',
+    Name: 'NAME',
+    UpdatedAt: 'UPDATED_AT',
+    CreatedAt: 'CREATED_AT',
+    Status: 'STATUS',
+    Owner: 'OWNER',
+    Tags: 'TAGS'
+};
+export function instanceOfContentsSortOrder(value) {
+    for (const key in ContentsSortOrder) {
+        if (Object.prototype.hasOwnProperty.call(ContentsSortOrder, key)) {
+            if (ContentsSortOrder[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function ContentsSortOrderFromJSON(json) {
+    return ContentsSortOrderFromJSONTyped(json, false);
+}
+export function ContentsSortOrderFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function ContentsSortOrderToJSON(value) {
+    return value;
+}
+export function ContentsSortOrderToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

package/dist/esm/models/index.d.ts

@@ -47,6 +47,7 @@ export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
+export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
 export * from './CreateApiKeyResponse';

package/dist/esm/models/index.js

@@ -49,6 +49,7 @@ export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
+export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
 export * from './CreateApiKeyResponse';

package/dist/models/ContentsSortOrder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+/**
+ * Sort options for the folder-contents listing.
+ *
+ * Superset of the base :class:`PathOrder` columns plus ``STATUS``
+ * (``approval_state``). Kept separate from ``PathOrder`` so the extra columns
+ * do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+ * @export
+ */
+export declare const ContentsSortOrder: {
+    readonly Logical: "LOGICAL";
+    readonly Name: "NAME";
+    readonly UpdatedAt: "UPDATED_AT";
+    readonly CreatedAt: "CREATED_AT";
+    readonly Status: "STATUS";
+    readonly Owner: "OWNER";
+    readonly Tags: "TAGS";
+};
+export type ContentsSortOrder = typeof ContentsSortOrder[keyof typeof ContentsSortOrder];
+export declare function instanceOfContentsSortOrder(value: any): boolean;
+export declare function ContentsSortOrderFromJSON(json: any): ContentsSortOrder;
+export declare function ContentsSortOrderFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsSortOrder;
+export declare function ContentsSortOrderToJSON(value?: ContentsSortOrder | null): any;
+export declare function ContentsSortOrderToJSONTyped(value: any, ignoreDiscriminator: boolean): ContentsSortOrder;

package/dist/models/ContentsSortOrder.js

@@ -0,0 +1,60 @@
+"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.ContentsSortOrder = void 0;
+exports.instanceOfContentsSortOrder = instanceOfContentsSortOrder;
+exports.ContentsSortOrderFromJSON = ContentsSortOrderFromJSON;
+exports.ContentsSortOrderFromJSONTyped = ContentsSortOrderFromJSONTyped;
+exports.ContentsSortOrderToJSON = ContentsSortOrderToJSON;
+exports.ContentsSortOrderToJSONTyped = ContentsSortOrderToJSONTyped;
+/**
+ * Sort options for the folder-contents listing.
+ *
+ * Superset of the base :class:`PathOrder` columns plus ``STATUS``
+ * (``approval_state``). Kept separate from ``PathOrder`` so the extra columns
+ * do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+ * @export
+ */
+exports.ContentsSortOrder = {
+    Logical: 'LOGICAL',
+    Name: 'NAME',
+    UpdatedAt: 'UPDATED_AT',
+    CreatedAt: 'CREATED_AT',
+    Status: 'STATUS',
+    Owner: 'OWNER',
+    Tags: 'TAGS'
+};
+function instanceOfContentsSortOrder(value) {
+    for (const key in exports.ContentsSortOrder) {
+        if (Object.prototype.hasOwnProperty.call(exports.ContentsSortOrder, key)) {
+            if (exports.ContentsSortOrder[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function ContentsSortOrderFromJSON(json) {
+    return ContentsSortOrderFromJSONTyped(json, false);
+}
+function ContentsSortOrderFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+function ContentsSortOrderToJSON(value) {
+    return value;
+}
+function ContentsSortOrderToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

package/dist/models/index.d.ts

@@ -47,6 +47,7 @@ export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
+export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
 export * from './CreateApiKeyResponse';

package/dist/models/index.js

@@ -65,6 +65,7 @@ __exportStar(require("./ColumnConfig"), exports);
 __exportStar(require("./ColumnReference"), exports);
 __exportStar(require("./CommonFileExclusionReason"), exports);
 __exportStar(require("./ConnectionConfig"), exports);
+__exportStar(require("./ContentsSortOrder"), exports);
 __exportStar(require("./CreateApiConnectionRequest"), exports);
 __exportStar(require("./CreateApiKeyRequest"), exports);
 __exportStar(require("./CreateApiKeyResponse"), exports);

package/docs/ContentsSortOrder.md

@@ -0,0 +1,33 @@
+
+# ContentsSortOrder
+
+Sort options for the folder-contents listing.  Superset of the base :class:`PathOrder` columns plus ``STATUS`` (``approval_state``). Kept separate from ``PathOrder`` so the extra columns do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { ContentsSortOrder } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies ContentsSortOrder
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ContentsSortOrder
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/FoldersApi.md

@@ -321,11 +321,11 @@ example().catch(console.error);
 
 ## listFolderContents
 
-> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator listFolderContents(folderId, maxDepth, sortOrder, withTags, limit, offset, approvalState, includeTagIds, excludeTagIds)
+> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator listFolderContents(folderId, maxDepth, sortOrder, sortDir, ownerId, nameLike, withTags, limit, offset, approvalState, includeTagIds, excludeTagIds, createdAfter, createdBefore, updatedAfter, updatedBefore)
 
 List Folder Contents Handler
 
-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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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.
 
 ### Example
 
@@ -351,8 +351,14 @@ async function example() {
     folderId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // number | Maximum depth to traverse (1=direct children, default: 1) (optional)
     maxDepth: 56,
-    // PathOrder | Sort order for results (default: LOGICAL) (optional)
+    // ContentsSortOrder | Sort order for results (default: LOGICAL) (optional)
     sortOrder: ...,
+    // SortDirection | Sort direction; overrides the column\'s natural default (optional)
+    sortDir: ...,
+    // string | Filter to items owned by this user (optional)
+    ownerId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // string | Case-insensitive substring filter on the item name (optional)
+    nameLike: nameLike_example,
     // boolean | Include tag IDs for each item (default: false) (optional)
     withTags: true,
     // number | Number of items per page (optional)
@@ -365,6 +371,14 @@ async function example() {
     includeTagIds: ...,
     // Array<string> | Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. (optional)
     excludeTagIds: ...,
+    // Date | Only items created at or after this timestamp (inclusive) (optional)
+    createdAfter: 2013-10-20T19:20:30+01:00,
+    // Date | Only items created strictly before this timestamp (optional)
+    createdBefore: 2013-10-20T19:20:30+01:00,
+    // Date | Only items updated at or after this timestamp (inclusive) (optional)
+    updatedAfter: 2013-10-20T19:20:30+01:00,
+    // Date | Only items updated strictly before this timestamp (optional)
+    updatedBefore: 2013-10-20T19:20:30+01:00,
   } satisfies ListFolderContentsRequest;
 
   try {
@@ -386,13 +400,20 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **folderId** | `string` |  | [Defaults to `undefined`] |
 | **maxDepth** | `number` | Maximum depth to traverse (1&#x3D;direct children, default: 1) | [Optional] [Defaults to `1`] |
-| **sortOrder** | `PathOrder` | Sort order for results (default: LOGICAL) | [Optional] [Defaults to `undefined`] [Enum: LOGICAL, NAME, UPDATED_AT, CREATED_AT] |
+| **sortOrder** | `ContentsSortOrder` | Sort order for results (default: LOGICAL) | [Optional] [Defaults to `undefined`] [Enum: LOGICAL, NAME, UPDATED_AT, CREATED_AT, STATUS, OWNER, TAGS] |
+| **sortDir** | `SortDirection` | Sort direction; overrides the column\&#39;s natural default | [Optional] [Defaults to `undefined`] [Enum: ASC, DESC] |
+| **ownerId** | `string` | Filter to items owned by this user | [Optional] [Defaults to `undefined`] |
+| **nameLike** | `string` | Case-insensitive substring filter on the item name | [Optional] [Defaults to `undefined`] |
 | **withTags** | `boolean` | Include tag IDs for each item (default: false) | [Optional] [Defaults to `false`] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
 | **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |
 | **approvalState** | `Array<PathPartApprovalState>` | Keep only items in these approval states (repeatable): not_required, pending, approved. | [Optional] |
 | **includeTagIds** | `Array<string>` | Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance). | [Optional] |
 | **excludeTagIds** | `Array<string>` | Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. | [Optional] |
+| **createdAfter** | `Date` | Only items created at or after this timestamp (inclusive) | [Optional] [Defaults to `undefined`] |
+| **createdBefore** | `Date` | Only items created strictly before this timestamp | [Optional] [Defaults to `undefined`] |
+| **updatedAfter** | `Date` | Only items updated at or after this timestamp (inclusive) | [Optional] [Defaults to `undefined`] |
+| **updatedBefore** | `Date` | Only items updated strictly before this timestamp | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 

package/package.json

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

package/src/apis/FoldersApi.ts

@@ -15,6 +15,7 @@
 
 import * as runtime from '../runtime';
 import type {
+  ContentsSortOrder,
   CreateFolderRequest,
   ErrorResponse,
   FolderAction,
@@ -31,6 +32,8 @@ import type {
   UpdateFolderRequest,
 } from '../models/index';
 import {
+    ContentsSortOrderFromJSON,
+    ContentsSortOrderToJSON,
     CreateFolderRequestFromJSON,
     CreateFolderRequestToJSON,
     ErrorResponseFromJSON,
@@ -82,13 +85,20 @@ export interface GetFolderRequest {
 export interface ListFolderContentsRequest {
     folderId: string;
     maxDepth?: number;
-    sortOrder?: PathOrder;
+    sortOrder?: ContentsSortOrder;
+    sortDir?: SortDirection;
+    ownerId?: string | null;
+    nameLike?: string | null;
     withTags?: boolean;
     limit?: number;
     offset?: number;
     approvalState?: Array<PathPartApprovalState> | null;
     includeTagIds?: Array<string> | null;
     excludeTagIds?: Array<string> | null;
+    createdAfter?: Date | null;
+    createdBefore?: Date | null;
+    updatedAfter?: Date | null;
+    updatedBefore?: Date | null;
 }
 
 export interface ListFoldersRequest {
@@ -230,30 +240,44 @@ export interface FoldersApiInterface {
      * 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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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 {ContentsSortOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
+     * @param {string} [ownerId] Filter to items owned by this user
+     * @param {string} [nameLike] Case-insensitive substring filter on the item name
      * @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 {Array<PathPartApprovalState>} [approvalState] Keep only items in these approval states (repeatable): not_required, pending, approved.
      * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
      * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
+     * @param {Date} [createdAfter] Only items created at or after this timestamp (inclusive)
+     * @param {Date} [createdBefore] Only items created strictly before this timestamp
+     * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
+     * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
@@ -261,7 +285,7 @@ export interface FoldersApiInterface {
     listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
 
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
@@ -634,6 +658,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
             queryParameters['sort_order'] = requestParameters['sortOrder'];
         }
 
+        if (requestParameters['sortDir'] != null) {
+            queryParameters['sort_dir'] = requestParameters['sortDir'];
+        }
+
+        if (requestParameters['ownerId'] != null) {
+            queryParameters['owner_id'] = requestParameters['ownerId'];
+        }
+
+        if (requestParameters['nameLike'] != null) {
+            queryParameters['name_like'] = requestParameters['nameLike'];
+        }
+
         if (requestParameters['withTags'] != null) {
             queryParameters['with_tags'] = requestParameters['withTags'];
         }
@@ -658,6 +694,22 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
             queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
         }
 
+        if (requestParameters['createdAfter'] != null) {
+            queryParameters['created_after'] = (requestParameters['createdAfter'] as any).toISOString();
+        }
+
+        if (requestParameters['createdBefore'] != null) {
+            queryParameters['created_before'] = (requestParameters['createdBefore'] as any).toISOString();
+        }
+
+        if (requestParameters['updatedAfter'] != null) {
+            queryParameters['updated_after'] = (requestParameters['updatedAfter'] as any).toISOString();
+        }
+
+        if (requestParameters['updatedBefore'] != null) {
+            queryParameters['updated_before'] = (requestParameters['updatedBefore'] as any).toISOString();
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -681,7 +733,7 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>> {
@@ -692,7 +744,7 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * 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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  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.  ``approval_state`` / ``include_tag_ids`` / ``exclude_tag_ids`` filter the result at the path_part layer: approval state on the item, tags matched by self-or-ancestor inheritance (include = OR, exclude wins).  ``sort_dir``, ``owner_id``, ``name_like``, the created_at/updated_at range filters, and the STATUS/OWNER/TAGS sorts apply to the direct-children listing only (``max_depth=1``); combining them with a deeper traversal is a 400.  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<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator> {

package/src/models/ContentsSortOrder.ts

@@ -0,0 +1,62 @@
+/* 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.
+ */
+
+
+/**
+ * Sort options for the folder-contents listing.
+ * 
+ * Superset of the base :class:`PathOrder` columns plus ``STATUS``
+ * (``approval_state``). Kept separate from ``PathOrder`` so the extra columns
+ * do not leak onto ``/folders`` or ``/path-parts``, and only apply at depth 1.
+ * @export
+ */
+export const ContentsSortOrder = {
+    Logical: 'LOGICAL',
+    Name: 'NAME',
+    UpdatedAt: 'UPDATED_AT',
+    CreatedAt: 'CREATED_AT',
+    Status: 'STATUS',
+    Owner: 'OWNER',
+    Tags: 'TAGS'
+} as const;
+export type ContentsSortOrder = typeof ContentsSortOrder[keyof typeof ContentsSortOrder];
+
+
+export function instanceOfContentsSortOrder(value: any): boolean {
+    for (const key in ContentsSortOrder) {
+        if (Object.prototype.hasOwnProperty.call(ContentsSortOrder, key)) {
+            if (ContentsSortOrder[key as keyof typeof ContentsSortOrder] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function ContentsSortOrderFromJSON(json: any): ContentsSortOrder {
+    return ContentsSortOrderFromJSONTyped(json, false);
+}
+
+export function ContentsSortOrderFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsSortOrder {
+    return json as ContentsSortOrder;
+}
+
+export function ContentsSortOrderToJSON(value?: ContentsSortOrder | null): any {
+    return value as any;
+}
+
+export function ContentsSortOrderToJSONTyped(value: any, ignoreDiscriminator: boolean): ContentsSortOrder {
+    return value as ContentsSortOrder;
+}
+

package/src/models/index.ts

@@ -49,6 +49,7 @@ export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
+export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
 export * from './CreateApiKeyResponse';