chore(sync): pull latest SDK docs (2026-07-08)

Author: ks-docs-sync[bot]

sdks/_generated-python/COMMIT

@@ -1 +1 @@
-677e0276957386ee44e90efa674ede903be15ae7
+dfdfd6b3b939dfa82f6dcfa66bff55e2a7aa0833

sdks/_generated-python/ContentsSortOrder.md

@@ -0,0 +1,23 @@
+# 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.
+
+## Enum
+
+* `LOGICAL` (value: `'LOGICAL'`)
+
+* `NAME` (value: `'NAME'`)
+
+* `UPDATED_AT` (value: `'UPDATED_AT'`)
+
+* `CREATED_AT` (value: `'CREATED_AT'`)
+
+* `STATUS` (value: `'STATUS'`)
+
+* `OWNER` (value: `'OWNER'`)
+
+* `TAGS` (value: `'TAGS'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

sdks/_generated-python/FoldersApi.md

@@ -370,7 +370,7 @@ Name | Type | Description  | Notes
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **list_folder_contents**
-> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator list_folder_contents(folder_id, max_depth=max_depth, sort_order=sort_order, with_tags=with_tags, limit=limit, offset=offset, approval_state=approval_state, include_tag_ids=include_tag_ids, exclude_tag_ids=exclude_tag_ids)
+> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator list_folder_contents(folder_id, max_depth=max_depth, sort_order=sort_order, sort_dir=sort_dir, owner_id=owner_id, name_like=name_like, with_tags=with_tags, limit=limit, offset=offset, approval_state=approval_state, include_tag_ids=include_tag_ids, exclude_tag_ids=exclude_tag_ids, created_after=created_after, created_before=created_before, updated_after=updated_after, updated_before=updated_before)
 
 List Folder Contents Handler
 
@@ -385,6 +385,11 @@ When with_tags=true, each item includes a tags field with the full tag objects.
 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.
 
@@ -395,9 +400,10 @@ For generic path traversal of folders only, use GET /path-parts.
 
 ```python
 import ksapi
+from ksapi.models.contents_sort_order import ContentsSortOrder
 from ksapi.models.paginated_response_annotated_union_folder_response_document_response_workflow_definition_response_workflow_run_response_data_source_response_data_source_schema_response_data_source_table_response_api_connection_response_discriminator import PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator
-from ksapi.models.path_order import PathOrder
 from ksapi.models.path_part_approval_state import PathPartApprovalState
+from ksapi.models.sort_direction import SortDirection
 from ksapi.rest import ApiException
 from pprint import pprint
 
@@ -429,17 +435,24 @@ with ksapi.ApiClient(configuration) as api_client:
     api_instance = ksapi.FoldersApi(api_client)
     folder_id = UUID('38400000-8cf0-11bd-b23e-10b96e4ef00d') # UUID | 
     max_depth = 1 # int | Maximum depth to traverse (1=direct children, default: 1) (optional) (default to 1)
-    sort_order = ksapi.PathOrder() # PathOrder | Sort order for results (default: LOGICAL) (optional)
+    sort_order = ksapi.ContentsSortOrder() # ContentsSortOrder | Sort order for results (default: LOGICAL) (optional)
+    sort_dir = ksapi.SortDirection() # SortDirection | Sort direction; overrides the column's natural default (optional)
+    owner_id = UUID('38400000-8cf0-11bd-b23e-10b96e4ef00d') # UUID | Filter to items owned by this user (optional)
+    name_like = 'name_like_example' # str | Case-insensitive substring filter on the item name (optional)
     with_tags = False # bool | Include tag IDs for each item (default: false) (optional) (default to False)
     limit = 20 # int | Number of items per page (optional) (default to 20)
     offset = 0 # int | Number of items to skip (optional) (default to 0)
     approval_state = [ksapi.PathPartApprovalState()] # List[PathPartApprovalState] | Keep only items in these approval states (repeatable): not_required, pending, approved. (optional)
     include_tag_ids = None # List[UUID] | Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance). (optional)
     exclude_tag_ids = None # List[UUID] | Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. (optional)
+    created_after = '2013-10-20T19:20:30+01:00' # datetime | Only items created at or after this timestamp (inclusive) (optional)
+    created_before = '2013-10-20T19:20:30+01:00' # datetime | Only items created strictly before this timestamp (optional)
+    updated_after = '2013-10-20T19:20:30+01:00' # datetime | Only items updated at or after this timestamp (inclusive) (optional)
+    updated_before = '2013-10-20T19:20:30+01:00' # datetime | Only items updated strictly before this timestamp (optional)
 
     try:
         # List Folder Contents Handler
-        api_response = api_instance.list_folder_contents(folder_id, max_depth=max_depth, sort_order=sort_order, with_tags=with_tags, limit=limit, offset=offset, approval_state=approval_state, include_tag_ids=include_tag_ids, exclude_tag_ids=exclude_tag_ids)
+        api_response = api_instance.list_folder_contents(folder_id, max_depth=max_depth, sort_order=sort_order, sort_dir=sort_dir, owner_id=owner_id, name_like=name_like, with_tags=with_tags, limit=limit, offset=offset, approval_state=approval_state, include_tag_ids=include_tag_ids, exclude_tag_ids=exclude_tag_ids, created_after=created_after, created_before=created_before, updated_after=updated_after, updated_before=updated_before)
         print("The response of FoldersApi->list_folder_contents:\n")
         pprint(api_response)
     except Exception as e:
@@ -455,13 +468,20 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **folder_id** | **UUID**|  | 
  **max_depth** | **int**| Maximum depth to traverse (1=direct children, default: 1) | [optional] [default to 1]
- **sort_order** | [**PathOrder**](.md)| Sort order for results (default: LOGICAL) | [optional] 
+ **sort_order** | [**ContentsSortOrder**](.md)| Sort order for results (default: LOGICAL) | [optional] 
+ **sort_dir** | [**SortDirection**](.md)| Sort direction; overrides the column's natural default | [optional] 
+ **owner_id** | **UUID**| Filter to items owned by this user | [optional] 
+ **name_like** | **str**| Case-insensitive substring filter on the item name | [optional] 
  **with_tags** | **bool**| Include tag IDs for each item (default: false) | [optional] [default to False]
  **limit** | **int**| Number of items per page | [optional] [default to 20]
  **offset** | **int**| Number of items to skip | [optional] [default to 0]
  **approval_state** | [**List[PathPartApprovalState]**](PathPartApprovalState.md)| Keep only items in these approval states (repeatable): not_required, pending, approved. | [optional] 
  **include_tag_ids** | [**List[UUID]**](UUID.md)| Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance). | [optional] 
  **exclude_tag_ids** | [**List[UUID]**](UUID.md)| Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. | [optional] 
+ **created_after** | **datetime**| Only items created at or after this timestamp (inclusive) | [optional] 
+ **created_before** | **datetime**| Only items created strictly before this timestamp | [optional] 
+ **updated_after** | **datetime**| Only items updated at or after this timestamp (inclusive) | [optional] 
+ **updated_before** | **datetime**| Only items updated strictly before this timestamp | [optional] 
 
 ### Return type
 

sdks/_generated-python/VERSION

@@ -1 +1 @@
-version = "1.127.0"
+version = "1.128.0"

sdks/_generated-ts/COMMIT

@@ -1 +1 @@
-2a687ad69a5fafa5afb8a0649ec07cc41be488c2
+753035d25b84ce557029e56914b0bd7e666c6f24

sdks/_generated-ts/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)
+
+

sdks/_generated-ts/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
 

sdks/_generated-ts/README.md

@@ -54,7 +54,7 @@ Below this line is auto-generated reference content.
 
 ---
 
-# @knowledge-stack/ksapi@1.127.0
+# @knowledge-stack/ksapi@1.128.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -372,6 +372,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)
@@ -672,7 +673,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`
 

sdks/_generated-ts/VERSION

@@ -1 +1 @@
-  "version": "1.127.0",
+  "version": "1.128.0",