@knowledge-stack/ksapi 1.123.2 → 1.124.0

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.123.2
+# @knowledge-stack/ksapi@1.124.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -616,7 +616,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.123.2`
+- Package version: `1.124.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, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -32,6 +32,9 @@ export interface ListFolderContentsRequest {
     withTags?: boolean;
     limit?: number;
     offset?: number;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface ListFoldersRequest {
     parentPathPartId?: string | null;
@@ -161,12 +164,15 @@ export interface FoldersApiInterface {
      * @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.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
     listFolderContentsRequestOpts(requestParameters: ListFolderContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * 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.
      * @summary List Folder Contents Handler
      * @param {string} folderId
      * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
@@ -174,13 +180,16 @@ export interface FoldersApiInterface {
      * @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 {*} [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.  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).  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>;
@@ -345,12 +354,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.  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).  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.  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).  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

@@ -285,6 +285,15 @@ class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['offset'] != null) {
                 queryParameters['offset'] = requestParameters['offset'];
             }
+            if (requestParameters['approvalState'] != null) {
+                queryParameters['approval_state'] = requestParameters['approvalState'];
+            }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -304,7 +313,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.  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).  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) {
@@ -315,7 +324,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.  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).  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/apis/WorkflowRunsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
+import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, PathPartApprovalState, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
 export interface CloneWorkflowRunOperationRequest {
     runId: string;
     cloneWorkflowRunRequest: CloneWorkflowRunRequest;
@@ -29,7 +29,7 @@ export interface GetWorkflowRunsSummaryRequest {
 export interface ListWorkflowRunsForTenantRequest {
     state?: Array<WorkflowExecutionState> | null;
     mine?: boolean;
-    pendingApprovalForMe?: boolean;
+    approvableByMe?: boolean;
     definitionId?: string | null;
     ownerId?: string | null;
     sortBy?: WorkflowRunOrder;
@@ -40,6 +40,9 @@ export interface ListWorkflowRunsForTenantRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface RetryWorkflowRunRequest {
     runId: string;
@@ -162,7 +165,7 @@ export interface WorkflowRunsApiInterface {
      * Creates request options for listWorkflowRunsForTenant without sending the request
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -173,16 +176,19 @@ export interface WorkflowRunsApiInterface {
      * @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 {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.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     listWorkflowRunsForTenantRequestOpts(requestParameters: ListWorkflowRunsForTenantRequest): Promise<runtime.RequestOpts>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * @summary List Workflow Runs For Tenant Handler
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -193,13 +199,16 @@ export interface WorkflowRunsApiInterface {
      * @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 {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 {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse>;
@@ -399,12 +408,12 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
      */
     listWorkflowRunsForTenantRequestOpts(requestParameters: ListWorkflowRunsForTenantRequest): Promise<runtime.RequestOpts>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant(requestParameters?: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse>;

package/dist/apis/WorkflowRunsApi.js

@@ -271,8 +271,8 @@ class WorkflowRunsApi extends runtime.BaseAPI {
             if (requestParameters['mine'] != null) {
                 queryParameters['mine'] = requestParameters['mine'];
             }
-            if (requestParameters['pendingApprovalForMe'] != null) {
-                queryParameters['pending_approval_for_me'] = requestParameters['pendingApprovalForMe'];
+            if (requestParameters['approvableByMe'] != null) {
+                queryParameters['approvable_by_me'] = requestParameters['approvableByMe'];
             }
             if (requestParameters['definitionId'] != null) {
                 queryParameters['definition_id'] = requestParameters['definitionId'];
@@ -304,6 +304,15 @@ class WorkflowRunsApi extends runtime.BaseAPI {
             if (requestParameters['updatedBefore'] != null) {
                 queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
             }
+            if (requestParameters['approvalState'] != null) {
+                queryParameters['approval_state'] = requestParameters['approvalState'];
+            }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -322,7 +331,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenantRaw(requestParameters, initOverrides) {
@@ -333,7 +342,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant() {

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, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -32,6 +32,9 @@ export interface ListFolderContentsRequest {
     withTags?: boolean;
     limit?: number;
     offset?: number;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface ListFoldersRequest {
     parentPathPartId?: string | null;
@@ -161,12 +164,15 @@ export interface FoldersApiInterface {
      * @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.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
     listFolderContentsRequestOpts(requestParameters: ListFolderContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * 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.
      * @summary List Folder Contents Handler
      * @param {string} folderId
      * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
@@ -174,13 +180,16 @@ export interface FoldersApiInterface {
      * @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 {*} [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.  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).  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>;
@@ -345,12 +354,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.  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).  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.  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).  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

@@ -249,6 +249,15 @@ export class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['offset'] != null) {
                 queryParameters['offset'] = requestParameters['offset'];
             }
+            if (requestParameters['approvalState'] != null) {
+                queryParameters['approval_state'] = requestParameters['approvalState'];
+            }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -268,7 +277,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.  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).  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) {
@@ -279,7 +288,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.  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).  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/WorkflowRunsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
+import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, PathPartApprovalState, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
 export interface CloneWorkflowRunOperationRequest {
     runId: string;
     cloneWorkflowRunRequest: CloneWorkflowRunRequest;
@@ -29,7 +29,7 @@ export interface GetWorkflowRunsSummaryRequest {
 export interface ListWorkflowRunsForTenantRequest {
     state?: Array<WorkflowExecutionState> | null;
     mine?: boolean;
-    pendingApprovalForMe?: boolean;
+    approvableByMe?: boolean;
     definitionId?: string | null;
     ownerId?: string | null;
     sortBy?: WorkflowRunOrder;
@@ -40,6 +40,9 @@ export interface ListWorkflowRunsForTenantRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface RetryWorkflowRunRequest {
     runId: string;
@@ -162,7 +165,7 @@ export interface WorkflowRunsApiInterface {
      * Creates request options for listWorkflowRunsForTenant without sending the request
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -173,16 +176,19 @@ export interface WorkflowRunsApiInterface {
      * @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 {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.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     listWorkflowRunsForTenantRequestOpts(requestParameters: ListWorkflowRunsForTenantRequest): Promise<runtime.RequestOpts>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * @summary List Workflow Runs For Tenant Handler
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -193,13 +199,16 @@ export interface WorkflowRunsApiInterface {
      * @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 {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 {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse>;
@@ -399,12 +408,12 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
      */
     listWorkflowRunsForTenantRequestOpts(requestParameters: ListWorkflowRunsForTenantRequest): Promise<runtime.RequestOpts>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>>;
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant(requestParameters?: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse>;

package/dist/esm/apis/WorkflowRunsApi.js

@@ -235,8 +235,8 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
             if (requestParameters['mine'] != null) {
                 queryParameters['mine'] = requestParameters['mine'];
             }
-            if (requestParameters['pendingApprovalForMe'] != null) {
-                queryParameters['pending_approval_for_me'] = requestParameters['pendingApprovalForMe'];
+            if (requestParameters['approvableByMe'] != null) {
+                queryParameters['approvable_by_me'] = requestParameters['approvableByMe'];
             }
             if (requestParameters['definitionId'] != null) {
                 queryParameters['definition_id'] = requestParameters['definitionId'];
@@ -268,6 +268,15 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
             if (requestParameters['updatedBefore'] != null) {
                 queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
             }
+            if (requestParameters['approvalState'] != null) {
+                queryParameters['approval_state'] = requestParameters['approvalState'];
+            }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -286,7 +295,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenantRaw(requestParameters, initOverrides) {
@@ -297,7 +306,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant() {

package/docs/FoldersApi.md

@@ -321,11 +321,11 @@ example().catch(console.error);
 
 ## listFolderContents
 
-> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator listFolderContents(folderId, maxDepth, sortOrder, withTags, limit, offset)
+> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator listFolderContents(folderId, maxDepth, sortOrder, withTags, limit, offset, approvalState, includeTagIds, excludeTagIds)
 
 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.  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).  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
 
@@ -359,6 +359,12 @@ async function example() {
     limit: 56,
     // number | Number of items to skip (optional)
     offset: 56,
+    // Array<PathPartApprovalState> | Keep only items in these approval states (repeatable): not_required, pending, approved. (optional)
+    approvalState: ...,
+    // 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)
+    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: ...,
   } satisfies ListFolderContentsRequest;
 
   try {
@@ -384,6 +390,9 @@ example().catch(console.error);
 | **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] |
 
 ### Return type
 

package/docs/WorkflowRunsApi.md

@@ -325,11 +325,11 @@ example().catch(console.error);
 
 ## listWorkflowRunsForTenant
 
-> PaginatedResponseWorkflowRunResponse listWorkflowRunsForTenant(state, mine, pendingApprovalForMe, definitionId, ownerId, sortBy, sortDir, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore)
+> PaginatedResponseWorkflowRunResponse listWorkflowRunsForTenant(state, mine, approvableByMe, definitionId, ownerId, sortBy, sortDir, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore, approvalState, includeTagIds, excludeTagIds)
 
 List Workflow Runs For Tenant Handler
 
-List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
 
 ### Example
 
@@ -355,8 +355,8 @@ async function example() {
     state: ...,
     // boolean | Only runs the caller created (owner). Overrides owner_id. (optional)
     mine: true,
-    // boolean | Only runs pending approval that the caller may approve. (optional)
-    pendingApprovalForMe: true,
+    // boolean | Only runs the caller may approve (approve-path scoped). Compose with approval_state=pending for the approval worklist. (optional)
+    approvableByMe: true,
     // string | Only runs under this workflow definition. (optional)
     definitionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // string | Only runs created by this user. (optional)
@@ -377,6 +377,12 @@ async function example() {
     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,
+    // Array<PathPartApprovalState> | Keep only items in these approval states (repeatable): not_required, pending, approved. (optional)
+    approvalState: ...,
+    // 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)
+    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: ...,
   } satisfies ListWorkflowRunsForTenantRequest;
 
   try {
@@ -398,7 +404,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **state** | `Array<WorkflowExecutionState>` | Keep only runs in these execution states (repeatable). | [Optional] |
 | **mine** | `boolean` | Only runs the caller created (owner). Overrides owner_id. | [Optional] [Defaults to `false`] |
-| **pendingApprovalForMe** | `boolean` | Only runs pending approval that the caller may approve. | [Optional] [Defaults to `false`] |
+| **approvableByMe** | `boolean` | Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist. | [Optional] [Defaults to `false`] |
 | **definitionId** | `string` | Only runs under this workflow definition. | [Optional] [Defaults to `undefined`] |
 | **ownerId** | `string` | Only runs created by this user. | [Optional] [Defaults to `undefined`] |
 | **sortBy** | `WorkflowRunOrder` | Field to sort runs by (default: STARTED_AT) | [Optional] [Defaults to `undefined`] [Enum: STARTED_AT, CREATED_AT, COMPLETED_AT] |
@@ -409,6 +415,9 @@ example().catch(console.error);
 | **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`] |
+| **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] |
 
 ### Return type
 

package/package.json

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

package/src/apis/FoldersApi.ts

@@ -24,6 +24,7 @@ import type {
   PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator,
   PaginatedResponseFolderResponse,
   PathOrder,
+  PathPartApprovalState,
   SearchSortOrder,
   SearchablePartType,
   SortDirection,
@@ -48,6 +49,8 @@ import {
     PaginatedResponseFolderResponseToJSON,
     PathOrderFromJSON,
     PathOrderToJSON,
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateToJSON,
     SearchSortOrderFromJSON,
     SearchSortOrderToJSON,
     SearchablePartTypeFromJSON,
@@ -83,6 +86,9 @@ export interface ListFolderContentsRequest {
     withTags?: boolean;
     limit?: number;
     offset?: number;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 
 export interface ListFoldersRequest {
@@ -228,13 +234,16 @@ export interface FoldersApiInterface {
      * @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.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
     listFolderContentsRequestOpts(requestParameters: ListFolderContentsRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * 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.
      * @summary List Folder Contents Handler
      * @param {string} folderId 
      * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
@@ -242,6 +251,9 @@ export interface FoldersApiInterface {
      * @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 {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
@@ -249,7 +261,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.  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).  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 +646,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
             queryParameters['offset'] = requestParameters['offset'];
         }
 
+        if (requestParameters['approvalState'] != null) {
+            queryParameters['approval_state'] = requestParameters['approvalState'];
+        }
+
+        if (requestParameters['includeTagIds'] != null) {
+            queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+        }
+
+        if (requestParameters['excludeTagIds'] != null) {
+            queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -657,7 +681,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.  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).  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>> {
@@ -668,7 +692,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.  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).  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/apis/WorkflowRunsApi.ts

@@ -19,6 +19,7 @@ import type {
   ErrorResponse,
   HTTPValidationError,
   PaginatedResponseWorkflowRunResponse,
+  PathPartApprovalState,
   SetWorkflowRunApprovalRequest,
   SortDirection,
   StartWorkflowRunRequest,
@@ -39,6 +40,8 @@ import {
     HTTPValidationErrorToJSON,
     PaginatedResponseWorkflowRunResponseFromJSON,
     PaginatedResponseWorkflowRunResponseToJSON,
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateToJSON,
     SetWorkflowRunApprovalRequestFromJSON,
     SetWorkflowRunApprovalRequestToJSON,
     SortDirectionFromJSON,
@@ -83,7 +86,7 @@ export interface GetWorkflowRunsSummaryRequest {
 export interface ListWorkflowRunsForTenantRequest {
     state?: Array<WorkflowExecutionState> | null;
     mine?: boolean;
-    pendingApprovalForMe?: boolean;
+    approvableByMe?: boolean;
     definitionId?: string | null;
     ownerId?: string | null;
     sortBy?: WorkflowRunOrder;
@@ -94,6 +97,9 @@ export interface ListWorkflowRunsForTenantRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    approvalState?: Array<PathPartApprovalState> | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 
 export interface RetryWorkflowRunRequest {
@@ -235,7 +241,7 @@ export interface WorkflowRunsApiInterface {
      * Creates request options for listWorkflowRunsForTenant without sending the request
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -246,17 +252,20 @@ export interface WorkflowRunsApiInterface {
      * @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 {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.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     listWorkflowRunsForTenantRequestOpts(requestParameters: ListWorkflowRunsForTenantRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * @summary List Workflow Runs For Tenant Handler
      * @param {Array<WorkflowExecutionState>} [state] Keep only runs in these execution states (repeatable).
      * @param {boolean} [mine] Only runs the caller created (owner). Overrides owner_id.
-     * @param {boolean} [pendingApprovalForMe] Only runs pending approval that the caller may approve.
+     * @param {boolean} [approvableByMe] Only runs the caller may approve (approve-path scoped). Compose with approval_state&#x3D;pending for the approval worklist.
      * @param {string} [definitionId] Only runs under this workflow definition.
      * @param {string} [ownerId] Only runs created by this user.
      * @param {WorkflowRunOrder} [sortBy] Field to sort runs by (default: STARTED_AT)
@@ -267,6 +276,9 @@ export interface WorkflowRunsApiInterface {
      * @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 {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 {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
@@ -274,7 +286,7 @@ export interface WorkflowRunsApiInterface {
     listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>>;
 
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     listWorkflowRunsForTenant(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse>;
@@ -681,8 +693,8 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
             queryParameters['mine'] = requestParameters['mine'];
         }
 
-        if (requestParameters['pendingApprovalForMe'] != null) {
-            queryParameters['pending_approval_for_me'] = requestParameters['pendingApprovalForMe'];
+        if (requestParameters['approvableByMe'] != null) {
+            queryParameters['approvable_by_me'] = requestParameters['approvableByMe'];
         }
 
         if (requestParameters['definitionId'] != null) {
@@ -725,6 +737,18 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
             queryParameters['updated_before'] = (requestParameters['updatedBefore'] as any).toISOString();
         }
 
+        if (requestParameters['approvalState'] != null) {
+            queryParameters['approval_state'] = requestParameters['approvalState'];
+        }
+
+        if (requestParameters['includeTagIds'] != null) {
+            queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+        }
+
+        if (requestParameters['excludeTagIds'] != null) {
+            queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -747,7 +771,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     async listWorkflowRunsForTenantRaw(requestParameters: ListWorkflowRunsForTenantRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowRunResponse>> {
@@ -758,7 +782,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, ``pending_approval_for_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
+     * List runs across every workflow in the tenant, permission-scoped.  The single spine behind the dashboard worklists — the FE composes its tabs from preset filters (``mine`` + ``state``, and the approval worklist ``approval_state=pending`` + ``approvable_by_me``). Visibility follows the same model as the per-definition list: OWNER/ADMIN see all; a USER sees runs under workflows they can read.
      * List Workflow Runs For Tenant Handler
      */
     async listWorkflowRunsForTenant(requestParameters: ListWorkflowRunsForTenantRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowRunResponse> {