@knowledge-stack/ksapi 1.88.1 → 1.90.0

package/src/apis/DocumentCheckoutApi.ts

@@ -26,19 +26,20 @@ import {
 } from '../models/index';
 
 export interface AcquireDocumentCheckoutRequest {
-    pathPartId: string;
+    documentId: string;
+    force?: boolean;
     authorization?: string | null;
     ksUat?: string | null;
 }
 
 export interface GetDocumentCheckoutRequest {
-    pathPartId: string;
+    documentId: string;
     authorization?: string | null;
     ksUat?: string | null;
 }
 
 export interface ReleaseDocumentCheckoutRequest {
-    pathPartId: string;
+    documentId: string;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -52,7 +53,8 @@ export interface ReleaseDocumentCheckoutRequest {
 export interface DocumentCheckoutApiInterface {
     /**
      * Creates request options for acquireDocumentCheckout without sending the request
-     * @param {string} pathPartId Document\'s PathPart ID
+     * @param {string} documentId Document ID
+     * @param {boolean} [force] OWNER/ADMIN only — atomically take the checkout regardless of the current holder. Sealed docs are still refused.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -61,9 +63,10 @@ export interface DocumentCheckoutApiInterface {
     acquireDocumentCheckoutRequestOpts(requestParameters: AcquireDocumentCheckoutRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. Locks have no TTL — they persist until released by the holder.
+     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. ``?force=true`` lets OWNER/ADMIN steal the lock from the current holder; a sealed (approved) document is refused regardless of ``force``. Locks have no TTL — they persist until released by the holder.
      * @summary Acquire Document Checkout Handler
-     * @param {string} pathPartId Document\&#39;s PathPart ID
+     * @param {string} documentId Document ID
+     * @param {boolean} [force] OWNER/ADMIN only — atomically take the checkout regardless of the current holder. Sealed docs are still refused.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -73,14 +76,14 @@ export interface DocumentCheckoutApiInterface {
     acquireDocumentCheckoutRaw(requestParameters: AcquireDocumentCheckoutRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentCheckoutResponse>>;
 
     /**
-     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. Locks have no TTL — they persist until released by the holder.
+     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. ``?force=true`` lets OWNER/ADMIN steal the lock from the current holder; a sealed (approved) document is refused regardless of ``force``. Locks have no TTL — they persist until released by the holder.
      * Acquire Document Checkout Handler
      */
     acquireDocumentCheckout(requestParameters: AcquireDocumentCheckoutRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentCheckoutResponse>;
 
     /**
      * Creates request options for getDocumentCheckout without sending the request
-     * @param {string} pathPartId Document\&#39;s PathPart ID
+     * @param {string} documentId Document ID
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -91,7 +94,7 @@ export interface DocumentCheckoutApiInterface {
     /**
      * Get the active checkout for the document.  404 if no active checkout exists. The holder can always GET their own lock regardless of current path permissions (parallel to the release holder-bypass).
      * @summary Get Document Checkout Handler
-     * @param {string} pathPartId Document\&#39;s PathPart ID
+     * @param {string} documentId Document ID
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -108,7 +111,7 @@ export interface DocumentCheckoutApiInterface {
 
     /**
      * Creates request options for releaseDocumentCheckout without sending the request
-     * @param {string} pathPartId Document\&#39;s PathPart ID
+     * @param {string} documentId Document ID
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -119,7 +122,7 @@ export interface DocumentCheckoutApiInterface {
     /**
      * Release the write lock on the document.  Only the holder may release the lock; others receive 403. The holder can always release regardless of current path permissions (in case a folder move relocated the doc to a path the holder can no longer write to).
      * @summary Release Document Checkout Handler
-     * @param {string} pathPartId Document\&#39;s PathPart ID
+     * @param {string} documentId Document ID
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -145,15 +148,19 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
      * Creates request options for acquireDocumentCheckout without sending the request
      */
     async acquireDocumentCheckoutRequestOpts(requestParameters: AcquireDocumentCheckoutRequest): Promise<runtime.RequestOpts> {
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['documentId'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling acquireDocumentCheckout().'
+                'documentId',
+                'Required parameter "documentId" was null or undefined when calling acquireDocumentCheckout().'
             );
         }
 
         const queryParameters: any = {};
 
+        if (requestParameters['force'] != null) {
+            queryParameters['force'] = requestParameters['force'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (requestParameters['authorization'] != null) {
@@ -161,8 +168,8 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
         }
 
 
-        let urlPath = `/v1/documents/{path_part_id}/checkout`;
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+        let urlPath = `/v1/documents/{document_id}/checkout`;
+        urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
 
         return {
             path: urlPath,
@@ -173,7 +180,7 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
     }
 
     /**
-     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. Locks have no TTL — they persist until released by the holder.
+     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. ``?force=true`` lets OWNER/ADMIN steal the lock from the current holder; a sealed (approved) document is refused regardless of ``force``. Locks have no TTL — they persist until released by the holder.
      * Acquire Document Checkout Handler
      */
     async acquireDocumentCheckoutRaw(requestParameters: AcquireDocumentCheckoutRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentCheckoutResponse>> {
@@ -184,7 +191,7 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
     }
 
     /**
-     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. Locks have no TTL — they persist until released by the holder.
+     * Acquire a write lock on the document.  If the caller already holds the lock, re-acquire refreshes ``acquired_at``; the response is 200 in both cases. If another user holds the lock, returns 409. ``?force=true`` lets OWNER/ADMIN steal the lock from the current holder; a sealed (approved) document is refused regardless of ``force``. Locks have no TTL — they persist until released by the holder.
      * Acquire Document Checkout Handler
      */
     async acquireDocumentCheckout(requestParameters: AcquireDocumentCheckoutRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentCheckoutResponse> {
@@ -196,10 +203,10 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
      * Creates request options for getDocumentCheckout without sending the request
      */
     async getDocumentCheckoutRequestOpts(requestParameters: GetDocumentCheckoutRequest): Promise<runtime.RequestOpts> {
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['documentId'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling getDocumentCheckout().'
+                'documentId',
+                'Required parameter "documentId" was null or undefined when calling getDocumentCheckout().'
             );
         }
 
@@ -212,8 +219,8 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
         }
 
 
-        let urlPath = `/v1/documents/{path_part_id}/checkout`;
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+        let urlPath = `/v1/documents/{document_id}/checkout`;
+        urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
 
         return {
             path: urlPath,
@@ -247,10 +254,10 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
      * Creates request options for releaseDocumentCheckout without sending the request
      */
     async releaseDocumentCheckoutRequestOpts(requestParameters: ReleaseDocumentCheckoutRequest): Promise<runtime.RequestOpts> {
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['documentId'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling releaseDocumentCheckout().'
+                'documentId',
+                'Required parameter "documentId" was null or undefined when calling releaseDocumentCheckout().'
             );
         }
 
@@ -263,8 +270,8 @@ export class DocumentCheckoutApi extends runtime.BaseAPI implements DocumentChec
         }
 
 
-        let urlPath = `/v1/documents/{path_part_id}/checkout`;
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+        let urlPath = `/v1/documents/{document_id}/checkout`;
+        urlPath = urlPath.replace(`{${"document_id"}}`, encodeURIComponent(String(requestParameters['documentId'])));
 
         return {
             path: urlPath,

package/src/apis/DocumentVersionsApi.ts

@@ -236,7 +236,7 @@ export interface DocumentVersionsApiInterface {
     getDocumentVersionRequestOpts(requestParameters: GetDocumentVersionRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Get a document version by its ID.
+     * 
      * @summary Get Document Version Handler
      * @param {string} versionId DocumentVersion ID
      * @param {boolean} [includePageScreenshots] When true, populate page_screenshot_urls with presigned URLs for every per-page WEBP screenshot the ingestion pipeline produced. Off by default to keep typical responses small.
@@ -249,7 +249,6 @@ export interface DocumentVersionsApiInterface {
     getDocumentVersionRaw(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
 
     /**
-     * Get a document version by its ID.
      * Get Document Version Handler
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
@@ -609,7 +608,6 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * Get a document version by its ID.
      * Get Document Version Handler
      */
     async getDocumentVersionRaw(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>> {
@@ -620,7 +618,6 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * Get a document version by its ID.
      * Get Document Version Handler
      */
     async getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse> {

package/src/apis/DocumentsApi.ts

@@ -183,7 +183,7 @@ export interface DocumentsApiInterface {
     getDocumentRequestOpts(requestParameters: GetDocumentRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Get a document by its document ID.
+     * 
      * @summary Get Document Handler
      * @param {string} documentId 
      * @param {boolean} [withTags] Include tags in the response (default: false)
@@ -196,7 +196,6 @@ export interface DocumentsApiInterface {
     getDocumentRaw(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>>;
 
     /**
-     * Get a document by its document ID.
      * Get Document Handler
      */
     getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
@@ -491,7 +490,6 @@ export class DocumentsApi extends runtime.BaseAPI implements DocumentsApiInterfa
     }
 
     /**
-     * Get a document by its document ID.
      * Get Document Handler
      */
     async getDocumentRaw(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>> {
@@ -502,7 +500,6 @@ export class DocumentsApi extends runtime.BaseAPI implements DocumentsApiInterfa
     }
 
     /**
-     * Get a document by its document ID.
      * Get Document Handler
      */
     async getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse> {

package/src/apis/FoldersApi.ts

@@ -20,7 +20,7 @@ import type {
   FolderActionResponse,
   FolderResponse,
   HTTPValidationError,
-  PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator,
+  PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator,
   PaginatedResponseFolderResponse,
   PathOrder,
   SearchSortOrder,
@@ -38,8 +38,8 @@ import {
     FolderResponseToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
-    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminatorFromJSON,
-    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminatorToJSON,
+    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminatorFromJSON,
+    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminatorToJSON,
     PaginatedResponseFolderResponseFromJSON,
     PaginatedResponseFolderResponseToJSON,
     PathOrderFromJSON,
@@ -223,7 +223,7 @@ export interface FoldersApiInterface {
     getFolderRequestOpts(requestParameters: GetFolderRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Get a folder by its folder ID.
+     * 
      * @summary Get Folder Handler
      * @param {string} folderId 
      * @param {boolean} [withTags] Include tags in the response (default: false)
@@ -236,7 +236,6 @@ export interface FoldersApiInterface {
     getFolderRaw(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FolderResponse>>;
 
     /**
-     * Get a folder by its folder ID.
      * Get Folder Handler
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
@@ -271,13 +270,13 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>>;
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>>;
 
     /**
      * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>;
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>;
 
     /**
      * Creates request options for listFolders without sending the request
@@ -347,13 +346,13 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>>;
 
     /**
      * Search for folders and documents by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>;
 
     /**
      * Creates request options for updateFolder without sending the request
@@ -593,7 +592,6 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * Get a folder by its folder ID.
      * Get Folder Handler
      */
     async getFolderRaw(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FolderResponse>> {
@@ -604,7 +602,6 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * Get a folder by its folder ID.
      * Get Folder Handler
      */
     async getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse> {
@@ -667,18 +664,18 @@ 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 Folder Contents Handler
      */
-    async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>> {
+    async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>> {
         const requestOptions = await this.listFolderContentsRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminatorFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminatorFromJSON(jsonValue));
     }
 
     /**
      * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator> {
+    async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator> {
         const response = await this.listFolderContentsRaw(requestParameters, initOverrides);
         return await response.value();
     }
@@ -808,18 +805,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
      * Search for folders and documents by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator>> {
+    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator>> {
         const requestOptions = await this.searchItemsRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminatorFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminatorFromJSON(jsonValue));
     }
 
     /**
      * Search for folders and documents by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator> {
+    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDiscriminator> {
         const response = await this.searchItemsRaw(requestParameters, initOverrides);
         return await response.value();
     }

package/src/apis/PathPartApprovalsApi.ts

@@ -0,0 +1,228 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  HTTPValidationError,
+  PathPartApprovalResponse,
+  SetApprovalStateRequest,
+} from '../models/index';
+import {
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    PathPartApprovalResponseFromJSON,
+    PathPartApprovalResponseToJSON,
+    SetApprovalStateRequestFromJSON,
+    SetApprovalStateRequestToJSON,
+} from '../models/index';
+
+export interface GetPathPartApprovalRequest {
+    pathPartId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface SetPathPartApprovalRequest {
+    pathPartId: string;
+    setApprovalStateRequest: SetApprovalStateRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+/**
+ * PathPartApprovalsApi - interface
+ * 
+ * @export
+ * @interface PathPartApprovalsApiInterface
+ */
+export interface PathPartApprovalsApiInterface {
+    /**
+     * Creates request options for getPathPartApproval without sending the request
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof PathPartApprovalsApiInterface
+     */
+    getPathPartApprovalRequestOpts(requestParameters: GetPathPartApprovalRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Return the current approval audit row for a path_part.  Exposes ``reviewer_id`` / ``reason`` and the decision timestamps so a caller can re-read who decided what and why. 404 if the path_part never entered the approval flow (its ``approval_state`` is still ``not_required``).
+     * @summary Get Path Part Approval Handler
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartApprovalsApiInterface
+     */
+    getPathPartApprovalRaw(requestParameters: GetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+
+    /**
+     * Return the current approval audit row for a path_part.  Exposes ``reviewer_id`` / ``reason`` and the decision timestamps so a caller can re-read who decided what and why. 404 if the path_part never entered the approval flow (its ``approval_state`` is still ``not_required``).
+     * Get Path Part Approval Handler
+     */
+    getPathPartApproval(requestParameters: GetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+
+    /**
+     * Creates request options for setPathPartApproval without sending the request
+     * @param {string} pathPartId 
+     * @param {SetApprovalStateRequest} setApprovalStateRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof PathPartApprovalsApiInterface
+     */
+    setPathPartApprovalRequestOpts(requestParameters: SetPathPartApprovalRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Set the approval state on a path_part.  | current ↓ / target → | pending                  | approved                 | | -------------------- | ------------------------ | ------------------------ | | not_required         | 200 request              | 409                      | | pending              | 200 (returns current row)| 200 approve              | | approved             | 200 unapprove            | 200 (returns current row)|  ``reason`` is forwarded to whichever service method handles the transition and persisted on the audit row (for ``approved``) or captured in the corresponding event payload (for ``pending``).
+     * @summary Set Path Part Approval Handler
+     * @param {string} pathPartId 
+     * @param {SetApprovalStateRequest} setApprovalStateRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartApprovalsApiInterface
+     */
+    setPathPartApprovalRaw(requestParameters: SetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+
+    /**
+     * Set the approval state on a path_part.  | current ↓ / target → | pending                  | approved                 | | -------------------- | ------------------------ | ------------------------ | | not_required         | 200 request              | 409                      | | pending              | 200 (returns current row)| 200 approve              | | approved             | 200 unapprove            | 200 (returns current row)|  ``reason`` is forwarded to whichever service method handles the transition and persisted on the audit row (for ``approved``) or captured in the corresponding event payload (for ``pending``).
+     * Set Path Part Approval Handler
+     */
+    setPathPartApproval(requestParameters: SetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+
+}
+
+/**
+ * 
+ */
+export class PathPartApprovalsApi extends runtime.BaseAPI implements PathPartApprovalsApiInterface {
+
+    /**
+     * Creates request options for getPathPartApproval without sending the request
+     */
+    async getPathPartApprovalRequestOpts(requestParameters: GetPathPartApprovalRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling getPathPartApproval().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/path-parts/{path_part_id}/approval`;
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Return the current approval audit row for a path_part.  Exposes ``reviewer_id`` / ``reason`` and the decision timestamps so a caller can re-read who decided what and why. 404 if the path_part never entered the approval flow (its ``approval_state`` is still ``not_required``).
+     * Get Path Part Approval Handler
+     */
+    async getPathPartApprovalRaw(requestParameters: GetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
+        const requestOptions = await this.getPathPartApprovalRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Return the current approval audit row for a path_part.  Exposes ``reviewer_id`` / ``reason`` and the decision timestamps so a caller can re-read who decided what and why. 404 if the path_part never entered the approval flow (its ``approval_state`` is still ``not_required``).
+     * Get Path Part Approval Handler
+     */
+    async getPathPartApproval(requestParameters: GetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
+        const response = await this.getPathPartApprovalRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for setPathPartApproval without sending the request
+     */
+    async setPathPartApprovalRequestOpts(requestParameters: SetPathPartApprovalRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling setPathPartApproval().'
+            );
+        }
+
+        if (requestParameters['setApprovalStateRequest'] == null) {
+            throw new runtime.RequiredError(
+                'setApprovalStateRequest',
+                'Required parameter "setApprovalStateRequest" was null or undefined when calling setPathPartApproval().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/path-parts/{path_part_id}/approval`;
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: SetApprovalStateRequestToJSON(requestParameters['setApprovalStateRequest']),
+        };
+    }
+
+    /**
+     * Set the approval state on a path_part.  | current ↓ / target → | pending                  | approved                 | | -------------------- | ------------------------ | ------------------------ | | not_required         | 200 request              | 409                      | | pending              | 200 (returns current row)| 200 approve              | | approved             | 200 unapprove            | 200 (returns current row)|  ``reason`` is forwarded to whichever service method handles the transition and persisted on the audit row (for ``approved``) or captured in the corresponding event payload (for ``pending``).
+     * Set Path Part Approval Handler
+     */
+    async setPathPartApprovalRaw(requestParameters: SetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
+        const requestOptions = await this.setPathPartApprovalRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Set the approval state on a path_part.  | current ↓ / target → | pending                  | approved                 | | -------------------- | ------------------------ | ------------------------ | | not_required         | 200 request              | 409                      | | pending              | 200 (returns current row)| 200 approve              | | approved             | 200 unapprove            | 200 (returns current row)|  ``reason`` is forwarded to whichever service method handles the transition and persisted on the audit row (for ``approved``) or captured in the corresponding event payload (for ``pending``).
+     * Set Path Part Approval Handler
+     */
+    async setPathPartApproval(requestParameters: SetPathPartApprovalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
+        const response = await this.setPathPartApprovalRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}