@knowledge-stack/ksapi 3.13.1 → 3.14.1

package/dist/models/WorkflowDetailResponse.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { PipelineStatus } from './PipelineStatus';
+import type { UserInfo } from './UserInfo';
 /**
  * Single item - adds live Temporal fields.
  * @export
@@ -28,12 +29,36 @@ export interface WorkflowDetailResponse {
      * @memberof WorkflowDetailResponse
      */
     documentId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof WorkflowDetailResponse
+     */
+    documentName: string;
+    /**
+     * The document's path
+     * @type {string}
+     * @memberof WorkflowDetailResponse
+     */
+    materializedPath: string;
     /**
      *
      * @type {string}
      * @memberof WorkflowDetailResponse
      */
     documentVersionId: string;
+    /**
+     * Whether this version is the document's active one; false for an unfinished newer upload and for a superseded older version
+     * @type {boolean}
+     * @memberof WorkflowDetailResponse
+     */
+    isActiveVersion: boolean;
+    /**
+     *
+     * @type {UserInfo}
+     * @memberof WorkflowDetailResponse
+     */
+    uploader: UserInfo;
     /**
      *
      * @type {PipelineStatus}
@@ -53,7 +78,7 @@ export interface WorkflowDetailResponse {
      */
     error?: string | null;
     /**
-     *
+     * When the last run started; the upload time until a run has started
      * @type {Date}
      * @memberof WorkflowDetailResponse
      */

package/dist/models/WorkflowDetailResponse.js

@@ -20,6 +20,7 @@ exports.WorkflowDetailResponseFromJSONTyped = WorkflowDetailResponseFromJSONType
 exports.WorkflowDetailResponseToJSON = WorkflowDetailResponseToJSON;
 exports.WorkflowDetailResponseToJSONTyped = WorkflowDetailResponseToJSONTyped;
 const PipelineStatus_1 = require("./PipelineStatus");
+const UserInfo_1 = require("./UserInfo");
 exports.WorkflowDetailResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the WorkflowDetailResponse interface.
@@ -29,8 +30,16 @@ function instanceOfWorkflowDetailResponse(value) {
         return false;
     if (!('documentId' in value) || value['documentId'] === undefined)
         return false;
+    if (!('documentName' in value) || value['documentName'] === undefined)
+        return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined)
+        return false;
     if (!('documentVersionId' in value) || value['documentVersionId'] === undefined)
         return false;
+    if (!('isActiveVersion' in value) || value['isActiveVersion'] === undefined)
+        return false;
+    if (!('uploader' in value) || value['uploader'] === undefined)
+        return false;
     if (!('status' in value) || value['status'] === undefined)
         return false;
     if (!('lastRunTimestamp' in value) || value['lastRunTimestamp'] === undefined)
@@ -59,7 +68,11 @@ function WorkflowDetailResponseFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'workflowId': json['workflow_id'],
         'documentId': json['document_id'],
+        'documentName': json['document_name'],
+        'materializedPath': json['materialized_path'],
         'documentVersionId': json['document_version_id'],
+        'isActiveVersion': json['is_active_version'],
+        'uploader': (0, UserInfo_1.UserInfoFromJSON)(json['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusFromJSON)(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
         'error': json['error'] == null ? undefined : json['error'],
@@ -85,7 +98,11 @@ function WorkflowDetailResponseToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'workflow_id': value['workflowId'],
         'document_id': value['documentId'],
+        'document_name': value['documentName'],
+        'materialized_path': value['materializedPath'],
         'document_version_id': value['documentVersionId'],
+        'is_active_version': value['isActiveVersion'],
+        'uploader': (0, UserInfo_1.UserInfoToJSON)(value['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusToJSON)(value['status']),
         'last_activity': value['lastActivity'],
         'error': value['error'],

package/dist/models/WorkflowSummaryResponse.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { PipelineStatus } from './PipelineStatus';
+import type { UserInfo } from './UserInfo';
 /**
  * List item - DB-only fields, no Temporal call per item.
  * @export
@@ -28,12 +29,36 @@ export interface WorkflowSummaryResponse {
      * @memberof WorkflowSummaryResponse
      */
     documentId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof WorkflowSummaryResponse
+     */
+    documentName: string;
+    /**
+     * The document's path
+     * @type {string}
+     * @memberof WorkflowSummaryResponse
+     */
+    materializedPath: string;
     /**
      *
      * @type {string}
      * @memberof WorkflowSummaryResponse
      */
     documentVersionId: string;
+    /**
+     * Whether this version is the document's active one; false for an unfinished newer upload and for a superseded older version
+     * @type {boolean}
+     * @memberof WorkflowSummaryResponse
+     */
+    isActiveVersion: boolean;
+    /**
+     *
+     * @type {UserInfo}
+     * @memberof WorkflowSummaryResponse
+     */
+    uploader: UserInfo;
     /**
      *
      * @type {PipelineStatus}
@@ -53,7 +78,7 @@ export interface WorkflowSummaryResponse {
      */
     error?: string | null;
     /**
-     *
+     * When the last run started; the upload time until a run has started
      * @type {Date}
      * @memberof WorkflowSummaryResponse
      */

package/dist/models/WorkflowSummaryResponse.js

@@ -20,6 +20,7 @@ exports.WorkflowSummaryResponseFromJSONTyped = WorkflowSummaryResponseFromJSONTy
 exports.WorkflowSummaryResponseToJSON = WorkflowSummaryResponseToJSON;
 exports.WorkflowSummaryResponseToJSONTyped = WorkflowSummaryResponseToJSONTyped;
 const PipelineStatus_1 = require("./PipelineStatus");
+const UserInfo_1 = require("./UserInfo");
 exports.WorkflowSummaryResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the WorkflowSummaryResponse interface.
@@ -29,8 +30,16 @@ function instanceOfWorkflowSummaryResponse(value) {
         return false;
     if (!('documentId' in value) || value['documentId'] === undefined)
         return false;
+    if (!('documentName' in value) || value['documentName'] === undefined)
+        return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined)
+        return false;
     if (!('documentVersionId' in value) || value['documentVersionId'] === undefined)
         return false;
+    if (!('isActiveVersion' in value) || value['isActiveVersion'] === undefined)
+        return false;
+    if (!('uploader' in value) || value['uploader'] === undefined)
+        return false;
     if (!('status' in value) || value['status'] === undefined)
         return false;
     if (!('lastRunTimestamp' in value) || value['lastRunTimestamp'] === undefined)
@@ -49,7 +58,11 @@ function WorkflowSummaryResponseFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'workflowId': json['workflow_id'],
         'documentId': json['document_id'],
+        'documentName': json['document_name'],
+        'materializedPath': json['materialized_path'],
         'documentVersionId': json['document_version_id'],
+        'isActiveVersion': json['is_active_version'],
+        'uploader': (0, UserInfo_1.UserInfoFromJSON)(json['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusFromJSON)(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
         'error': json['error'] == null ? undefined : json['error'],
@@ -68,7 +81,11 @@ function WorkflowSummaryResponseToJSONTyped(value, ignoreDiscriminator = false)
     return {
         'workflow_id': value['workflowId'],
         'document_id': value['documentId'],
+        'document_name': value['documentName'],
+        'materialized_path': value['materializedPath'],
         'document_version_id': value['documentVersionId'],
+        'is_active_version': value['isActiveVersion'],
+        'uploader': (0, UserInfo_1.UserInfoToJSON)(value['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusToJSON)(value['status']),
         'last_activity': value['lastActivity'],
         'error': value['error'],

package/dist/models/index.d.ts

@@ -35,6 +35,7 @@ export * from './BulkModelTablesRequest';
 export * from './BulkModelTablesResponse';
 export * from './BulkMoveRequest';
 export * from './BulkOperationResponse';
+export * from './BulkRerunRequest';
 export * from './BulkRevokeRequest';
 export * from './BulkTagRequest';
 export * from './BulkTrashRequest';
@@ -235,6 +236,7 @@ export * from './PaginatedResponseTenantUserResponse';
 export * from './PaginatedResponseThreadMessageResponse';
 export * from './PaginatedResponseThreadResponse';
 export * from './PaginatedResponseTrashItemResponse';
+export * from './PaginatedResponseUserInfo';
 export * from './PaginatedResponseWorkflowDefinitionResponse';
 export * from './PaginatedResponseWorkflowRunResponse';
 export * from './PaginatedResponseWorkflowSummaryResponse';

package/dist/models/index.js

@@ -53,6 +53,7 @@ __exportStar(require("./BulkModelTablesRequest"), exports);
 __exportStar(require("./BulkModelTablesResponse"), exports);
 __exportStar(require("./BulkMoveRequest"), exports);
 __exportStar(require("./BulkOperationResponse"), exports);
+__exportStar(require("./BulkRerunRequest"), exports);
 __exportStar(require("./BulkRevokeRequest"), exports);
 __exportStar(require("./BulkTagRequest"), exports);
 __exportStar(require("./BulkTrashRequest"), exports);
@@ -253,6 +254,7 @@ __exportStar(require("./PaginatedResponseTenantUserResponse"), exports);
 __exportStar(require("./PaginatedResponseThreadMessageResponse"), exports);
 __exportStar(require("./PaginatedResponseThreadResponse"), exports);
 __exportStar(require("./PaginatedResponseTrashItemResponse"), exports);
+__exportStar(require("./PaginatedResponseUserInfo"), exports);
 __exportStar(require("./PaginatedResponseWorkflowDefinitionResponse"), exports);
 __exportStar(require("./PaginatedResponseWorkflowRunResponse"), exports);
 __exportStar(require("./PaginatedResponseWorkflowSummaryResponse"), exports);

package/docs/BulkRerunRequest.md

@@ -0,0 +1,35 @@
+
+# BulkRerunRequest
+
+Re-run ingestion for the selected document versions.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`documentVersionIds` | Array<string>
+
+## Example
+
+```typescript
+import type { BulkRerunRequest } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "documentVersionIds": null,
+} satisfies BulkRerunRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as BulkRerunRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DocumentVersionsApi.md

@@ -826,7 +826,7 @@ example().catch(console.error);
 
 Update Document Version Metadata Handler
 
-Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.  When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
+Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.  When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).  Any settle pushes a tenant-wide ``document_detail_changed``; a failed, cancelled or quota-limited one does so with the ``ingestion_failed`` kind so open views (the Ingestions page) refetch.
 
 ### Example
 

package/docs/DocumentsApi.md

@@ -832,7 +832,7 @@ example().catch(console.error);
 
 Ingest Zip Handler
 
-Upload a ZIP archive; ingest each member asynchronously via a fan-out.  The whole archive nests under a single FOLDER named after the ZIP file (``report.zip`` -> ``report/``), with the ZIP\'s directory structure mirrored beneath it as FOLDER PathParts — all created synchronously. Returns 202 with the fan-out ``workflow_id`` (poll ``GET /v1/system-jobs/zip-ingestions/{workflow_id}`` for per-member outcomes) plus the artifacts ``skipped`` during classification.  Whole-archive failures (not a ZIP, zip-bomb, >500 files) return 400 before any DB writes; a re-upload whose ZIP-named folder already exists returns 409. Per-member failures (unsupported type, oversized) surface in the polled workflow results, not in this response. Each member reuses the single-file ingest path, so run-enrollment and completion events fire per member there.
+Upload a ZIP archive; ingest each member asynchronously via a fan-out.  The whole archive nests under a single FOLDER named after the ZIP file (``report.zip`` -> ``report/``), with the ZIP\'s directory structure mirrored beneath it as FOLDER PathParts — all created synchronously. Returns 202 with the fan-out ``workflow_id`` (poll ``GET /v1/system-jobs/zip-ingestions/{workflow_id}`` for per-member outcomes). ``skipped`` carries OS artifacts (skipped) and the members rejected up front (nested archive, empty, over the size cap) as errors; with nothing left to ingest no workflow starts and ``workflow_id`` is null.  Whole-archive failures (not a ZIP, zip-bomb, >500 files) return 400 before any DB writes; a re-upload whose ZIP-named folder already exists returns 409. Failures of accepted members (for example an unsupported file type) surface in the polled workflow results, not in this response. Each member reuses the single-file ingest path, so run-enrollment and completion events fire per member there.
 
 ### Example
 

package/docs/PaginatedResponseUserInfo.md

@@ -0,0 +1,40 @@
+
+# PaginatedResponseUserInfo
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`items` | [Array<UserInfo>](UserInfo.md)
+`total` | number
+`limit` | number
+`offset` | number
+
+## Example
+
+```typescript
+import type { PaginatedResponseUserInfo } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "items": null,
+  "total": null,
+  "limit": null,
+  "offset": null,
+} satisfies PaginatedResponseUserInfo
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PaginatedResponseUserInfo
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/SystemJobsApi.md

@@ -4,22 +4,99 @@ All URIs are relative to *http://localhost:8000*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**bulkRerunDvWorkflows**](SystemJobsApi.md#bulkrerundvworkflows) | **POST** /v1/system-jobs/document_versions/bulk-rerun | Bulk Rerun Dv Workflows Handler |
 | [**cancelTemporalWorkflow**](SystemJobsApi.md#canceltemporalworkflow) | **DELETE** /v1/system-jobs/{workflow_id} | Cancel Temporal Workflow Handler |
 | [**dvWorkflowRerun**](SystemJobsApi.md#dvworkflowrerun) | **POST** /v1/system-jobs/document_versions/{workflow_id} | Dv Workflow Rerun Handler |
 | [**getDvWorkflow**](SystemJobsApi.md#getdvworkflow) | **GET** /v1/system-jobs/document_versions/{workflow_id} | Get Dv Workflow Handler |
 | [**getTemporalWorkflowStatus**](SystemJobsApi.md#gettemporalworkflowstatus) | **GET** /v1/system-jobs/{workflow_id} | Get Temporal Workflow Status Handler |
 | [**getZipIngestionStatus**](SystemJobsApi.md#getzipingestionstatus) | **GET** /v1/system-jobs/zip-ingestions/{workflow_id} | Get Zip Ingestion Status Handler |
+| [**listDvWorkflowUploaders**](SystemJobsApi.md#listdvworkflowuploaders) | **GET** /v1/system-jobs/document_versions/uploaders | List Dv Workflow Uploaders Handler |
 | [**listDvWorkflows**](SystemJobsApi.md#listdvworkflows) | **GET** /v1/system-jobs/document_versions | List Dv Workflows Handler |
 
 
 
+## bulkRerunDvWorkflows
+
+> BulkOperationResponse bulkRerunDvWorkflows(bulkRerunRequest)
+
+Bulk Rerun Dv Workflows Handler
+
+Re-run ingestion for the selected document versions, reporting per item.  ``not_found``: missing, trashed, never ingested or without its stored source; ``forbidden``: no ``can_write``; ``in_progress_workflow``: still pending/processing; ``already_ingested``: completed; ``unsupported_document_type``: a type that is no longer ingested; ``superseded``: a newer version of the document exists. More than 200 ids is a 400 before any re-run.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SystemJobsApi,
+} from '@knowledge-stack/ksapi';
+import type { BulkRerunDvWorkflowsRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new SystemJobsApi(config);
+
+  const body = {
+    // BulkRerunRequest
+    bulkRerunRequest: ...,
+  } satisfies BulkRerunDvWorkflowsRequest;
+
+  try {
+    const data = await api.bulkRerunDvWorkflows(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **bulkRerunRequest** | [BulkRerunRequest](BulkRerunRequest.md) |  | |
+
+### Return type
+
+[**BulkOperationResponse**](BulkOperationResponse.md)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## cancelTemporalWorkflow
 
 > WorkflowCancelResponse cancelTemporalWorkflow(workflowId)
 
 Cancel Temporal Workflow Handler
 
-Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side.
+Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side. A run no worker ever picked up is terminated instead, since a cancel request is itself a workflow task nobody would process. When Temporal no longer has the run, or it was terminated here, a document version still showing it running is settled as cancelled (needs ``can_write``) so it can be re-run.
 
 ### Example
 
@@ -94,7 +171,7 @@ example().catch(console.error);
 
 Dv Workflow Rerun Handler
 
-Rerun a workflow. USER role requires ``can_write`` on the document path.  ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
+Rerun a workflow. USER role requires ``can_write`` on the document path.  A version that a newer live version supersedes is refused with 409. ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
 
 ### Example
 
@@ -319,7 +396,7 @@ example().catch(console.error);
 
 Get Zip Ingestion Status Handler
 
-Get a ZIP fan-out\'s live status + per-member outcomes.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow\'s ``results`` query (served from retained history), so once Temporal retention expires this 404s.
+Get a ZIP fan-out\'s live status + per-member outcomes.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow\'s ``results`` query (served from retained history), so once Temporal retention expires this 404s. Any other workflow type has no ``results`` query and is a 404, not a 500.
 
 ### Example
 
@@ -388,13 +465,94 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## listDvWorkflowUploaders
+
+> PaginatedResponseUserInfo listDvWorkflowUploaders(usernameLike, limit, offset)
+
+List Dv Workflow Uploaders Handler
+
+People who uploaded a version the caller can list, for the uploader filter.  Scoped like ``list_dv_workflows``: USER only counts versions under readable paths.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SystemJobsApi,
+} from '@knowledge-stack/ksapi';
+import type { ListDvWorkflowUploadersRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new SystemJobsApi(config);
+
+  const body = {
+    // string | Case-insensitive substring of the first or last name (optional)
+    usernameLike: usernameLike_example,
+    // number | Number of items per page (optional)
+    limit: 56,
+    // number | Number of items to skip (optional)
+    offset: 56,
+  } satisfies ListDvWorkflowUploadersRequest;
+
+  try {
+    const data = await api.listDvWorkflowUploaders(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **usernameLike** | `string` | Case-insensitive substring of the first or last name | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
+| **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |
+
+### Return type
+
+[**PaginatedResponseUserInfo**](PaginatedResponseUserInfo.md)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## listDvWorkflows
 
-> PaginatedResponseWorkflowSummaryResponse listDvWorkflows(limit, offset)
+> PaginatedResponseWorkflowSummaryResponse listDvWorkflows(limit, offset, sortDir, status, nameLike, latestVersionOnly, uploaderUserId, createdAfter, createdBefore, updatedAfter, updatedBefore)
 
 List Dv Workflows Handler
 
-List all workflows for the current tenant (paginated, DB-backed).  ADMIN/OWNER see all workflows; USER sees only those under permitted paths.
+List ingestions of live documents in the current tenant, newest upload first.  ADMIN/OWNER see every version; USER only versions under readable paths. ``sort_dir=ASC`` lists the oldest upload first.
 
 ### Example
 
@@ -420,6 +578,24 @@ async function example() {
     limit: 56,
     // number | Number of items to skip (optional)
     offset: 56,
+    // SortDirection | Sort direction (ASC or DESC); overrides the field\'s natural default. Every sort field supports both directions. (optional)
+    sortDir: ...,
+    // Array<PipelineStatus> | Only versions in one of these pipeline statuses (optional)
+    status: ...,
+    // string | Case-insensitive substring filter on document name (optional)
+    nameLike: nameLike_example,
+    // boolean | Skip versions superseded by a newer version (optional)
+    latestVersionOnly: true,
+    // string | Filter to versions uploaded by this user (optional)
+    uploaderUserId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // Date | Only items created at or after this timestamp (inclusive) (optional)
+    createdAfter: 2013-10-20T19:20:30+01:00,
+    // Date | Only items created strictly before this timestamp (optional)
+    createdBefore: 2013-10-20T19:20:30+01:00,
+    // Date | Only items updated at or after this timestamp (inclusive) (optional)
+    updatedAfter: 2013-10-20T19:20:30+01:00,
+    // Date | Only items updated strictly before this timestamp (optional)
+    updatedBefore: 2013-10-20T19:20:30+01:00,
   } satisfies ListDvWorkflowsRequest;
 
   try {
@@ -441,6 +617,15 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
 | **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |
+| **sortDir** | `SortDirection` | Sort direction (ASC or DESC); overrides the field\&#39;s natural default. Every sort field supports both directions. | [Optional] [Defaults to `undefined`] [Enum: ASC, DESC] |
+| **status** | `Array<PipelineStatus>` | Only versions in one of these pipeline statuses | [Optional] |
+| **nameLike** | `string` | Case-insensitive substring filter on document name | [Optional] [Defaults to `undefined`] |
+| **latestVersionOnly** | `boolean` | Skip versions superseded by a newer version | [Optional] [Defaults to `false`] |
+| **uploaderUserId** | `string` | Filter to versions uploaded by this user | [Optional] [Defaults to `undefined`] |
+| **createdAfter** | `Date` | Only items created at or after this timestamp (inclusive) | [Optional] [Defaults to `undefined`] |
+| **createdBefore** | `Date` | Only items created strictly before this timestamp | [Optional] [Defaults to `undefined`] |
+| **updatedAfter** | `Date` | Only items updated at or after this timestamp (inclusive) | [Optional] [Defaults to `undefined`] |
+| **updatedBefore** | `Date` | Only items updated strictly before this timestamp | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 

package/docs/WorkflowDetailResponse.md

@@ -9,7 +9,11 @@ Name | Type
 ------------ | -------------
 `workflowId` | string
 `documentId` | string
+`documentName` | string
+`materializedPath` | string
 `documentVersionId` | string
+`isActiveVersion` | boolean
+`uploader` | [UserInfo](UserInfo.md)
 `status` | [PipelineStatus](PipelineStatus.md)
 `lastActivity` | string
 `error` | string
@@ -33,7 +37,11 @@ import type { WorkflowDetailResponse } from '@knowledge-stack/ksapi'
 const example = {
   "workflowId": null,
   "documentId": null,
+  "documentName": null,
+  "materializedPath": null,
   "documentVersionId": null,
+  "isActiveVersion": null,
+  "uploader": null,
   "status": null,
   "lastActivity": null,
   "error": null,

package/docs/WorkflowSummaryResponse.md

@@ -9,7 +9,11 @@ Name | Type
 ------------ | -------------
 `workflowId` | string
 `documentId` | string
+`documentName` | string
+`materializedPath` | string
 `documentVersionId` | string
+`isActiveVersion` | boolean
+`uploader` | [UserInfo](UserInfo.md)
 `status` | [PipelineStatus](PipelineStatus.md)
 `lastActivity` | string
 `error` | string
@@ -26,7 +30,11 @@ import type { WorkflowSummaryResponse } from '@knowledge-stack/ksapi'
 const example = {
   "workflowId": null,
   "documentId": null,
+  "documentName": null,
+  "materializedPath": null,
   "documentVersionId": null,
+  "isActiveVersion": null,
+  "uploader": null,
   "status": null,
   "lastActivity": null,
   "error": null,

package/package.json

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