@knowledge-stack/ksapi 1.154.1 → 1.156.0

package/docs/UserPermissionsApi.md

@@ -4,6 +4,8 @@ All URIs are relative to *http://localhost:8000*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**bulkGrantUserPermissions**](UserPermissionsApi.md#bulkgrantuserpermissions) | **POST** /v1/user-permissions/bulk | Bulk Grant User Permissions Handler |
+| [**bulkRevokeUserPermissions**](UserPermissionsApi.md#bulkrevokeuserpermissions) | **POST** /v1/user-permissions/bulk-delete | Bulk Revoke User Permissions Handler |
 | [**createUserPermission**](UserPermissionsApi.md#createuserpermission) | **POST** /v1/user-permissions | Create User Permission Handler |
 | [**deleteUserPermission**](UserPermissionsApi.md#deleteuserpermission) | **DELETE** /v1/user-permissions/{permission_id} | Delete User Permission Handler |
 | [**listUserPermissions**](UserPermissionsApi.md#listuserpermissions) | **GET** /v1/user-permissions | List User Permissions Handler |
@@ -11,6 +13,156 @@ All URIs are relative to *http://localhost:8000*
 
 
 
+## bulkGrantUserPermissions
+
+> BulkGrantResponse bulkGrantUserPermissions(bulkGrantRequest)
+
+Bulk Grant User Permissions Handler
+
+Grant many (user, object, capability) permissions (admin/owner only).  Each grant is applied in its own transaction, reporting a per-item outcome keyed on the (user_id, object_id) pair: a missing/trashed object or a user not in the tenant is ``not_found``, hitting the per-user cap is ``permission_limit``, and an already-covered grant is ``subsumed``.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  UserPermissionsApi,
+} from '@knowledge-stack/ksapi';
+import type { BulkGrantUserPermissionsRequest } 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 UserPermissionsApi(config);
+
+  const body = {
+    // BulkGrantRequest
+    bulkGrantRequest: ...,
+  } satisfies BulkGrantUserPermissionsRequest;
+
+  try {
+    const data = await api.bulkGrantUserPermissions(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **bulkGrantRequest** | [BulkGrantRequest](BulkGrantRequest.md) |  | |
+
+### Return type
+
+[**BulkGrantResponse**](BulkGrantResponse.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)
+
+
+## bulkRevokeUserPermissions
+
+> BulkOperationResponse bulkRevokeUserPermissions(bulkRevokeRequest)
+
+Bulk Revoke User Permissions Handler
+
+Revoke many permissions by their ids (admin/owner only), per item.  A permission id not found in the tenant lands in ``failed`` as ``not_found``.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  UserPermissionsApi,
+} from '@knowledge-stack/ksapi';
+import type { BulkRevokeUserPermissionsRequest } 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 UserPermissionsApi(config);
+
+  const body = {
+    // BulkRevokeRequest
+    bulkRevokeRequest: ...,
+  } satisfies BulkRevokeUserPermissionsRequest;
+
+  try {
+    const data = await api.bulkRevokeUserPermissions(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **bulkRevokeRequest** | [BulkRevokeRequest](BulkRevokeRequest.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)
+
+
 ## createUserPermission
 
 > PermissionResponse createUserPermission(createPermissionRequest)

package/package.json

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

package/src/apis/BulkDeleteApi.ts

@@ -0,0 +1,133 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call. 
+ *
+ * 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 {
+  BulkDeleteRequest,
+  BulkOperationResponse,
+  ErrorResponse,
+  HTTPValidationError,
+} from '../models/index';
+import {
+    BulkDeleteRequestFromJSON,
+    BulkDeleteRequestToJSON,
+    BulkOperationResponseFromJSON,
+    BulkOperationResponseToJSON,
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+} from '../models/index';
+
+export interface BulkDeleteOperationRequest {
+    bulkDeleteRequest: BulkDeleteRequest;
+}
+
+/**
+ * BulkDeleteApi - interface
+ * 
+ * @export
+ * @interface BulkDeleteApiInterface
+ */
+export interface BulkDeleteApiInterface {
+    /**
+     * Creates request options for bulkDelete without sending the request
+     * @param {BulkDeleteRequest} bulkDeleteRequest 
+     * @throws {RequiredError}
+     * @memberof BulkDeleteApiInterface
+     */
+    bulkDeleteRequestOpts(requestParameters: BulkDeleteOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Move the selected folders and documents to Trash, reporting per item.  Each id is soft-deleted in its own transaction: items the caller may not delete, that are approval-sealed, held by another user, contain an in-progress run, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed. Over the selection cap returns ``400``.
+     * @summary Bulk Delete Handler
+     * @param {BulkDeleteRequest} bulkDeleteRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof BulkDeleteApiInterface
+     */
+    bulkDeleteRaw(requestParameters: BulkDeleteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>>;
+
+    /**
+     * Move the selected folders and documents to Trash, reporting per item.  Each id is soft-deleted in its own transaction: items the caller may not delete, that are approval-sealed, held by another user, contain an in-progress run, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed. Over the selection cap returns ``400``.
+     * Bulk Delete Handler
+     */
+    bulkDelete(requestParameters: BulkDeleteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse>;
+
+}
+
+/**
+ * 
+ */
+export class BulkDeleteApi extends runtime.BaseAPI implements BulkDeleteApiInterface {
+
+    /**
+     * Creates request options for bulkDelete without sending the request
+     */
+    async bulkDeleteRequestOpts(requestParameters: BulkDeleteOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['bulkDeleteRequest'] == null) {
+            throw new runtime.RequiredError(
+                'bulkDeleteRequest',
+                'Required parameter "bulkDeleteRequest" was null or undefined when calling bulkDelete().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/bulk-delete`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: BulkDeleteRequestToJSON(requestParameters['bulkDeleteRequest']),
+        };
+    }
+
+    /**
+     * Move the selected folders and documents to Trash, reporting per item.  Each id is soft-deleted in its own transaction: items the caller may not delete, that are approval-sealed, held by another user, contain an in-progress run, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed. Over the selection cap returns ``400``.
+     * Bulk Delete Handler
+     */
+    async bulkDeleteRaw(requestParameters: BulkDeleteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>> {
+        const requestOptions = await this.bulkDeleteRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkOperationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Move the selected folders and documents to Trash, reporting per item.  Each id is soft-deleted in its own transaction: items the caller may not delete, that are approval-sealed, held by another user, contain an in-progress run, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed. Over the selection cap returns ``400``.
+     * Bulk Delete Handler
+     */
+    async bulkDelete(requestParameters: BulkDeleteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse> {
+        const response = await this.bulkDeleteRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/BulkMoveApi.ts

@@ -0,0 +1,133 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call. 
+ *
+ * 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 {
+  BulkMoveRequest,
+  BulkOperationResponse,
+  ErrorResponse,
+  HTTPValidationError,
+} from '../models/index';
+import {
+    BulkMoveRequestFromJSON,
+    BulkMoveRequestToJSON,
+    BulkOperationResponseFromJSON,
+    BulkOperationResponseToJSON,
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+} from '../models/index';
+
+export interface BulkMoveOperationRequest {
+    bulkMoveRequest: BulkMoveRequest;
+}
+
+/**
+ * BulkMoveApi - interface
+ * 
+ * @export
+ * @interface BulkMoveApiInterface
+ */
+export interface BulkMoveApiInterface {
+    /**
+     * Creates request options for bulkMove without sending the request
+     * @param {BulkMoveRequest} bulkMoveRequest 
+     * @throws {RequiredError}
+     * @memberof BulkMoveApiInterface
+     */
+    bulkMoveRequestOpts(requestParameters: BulkMoveOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Move the selected folders and documents into ``target_folder_id``.  The destination is checked once up front — an invalid target returns ``400`` and a target the caller cannot write returns ``403``, before any item moves. Each source then moves in its own transaction; items the caller may not write, that are sealed, held by another user, that would form a cycle, hit a name collision, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed.
+     * @summary Bulk Move Handler
+     * @param {BulkMoveRequest} bulkMoveRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof BulkMoveApiInterface
+     */
+    bulkMoveRaw(requestParameters: BulkMoveOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>>;
+
+    /**
+     * Move the selected folders and documents into ``target_folder_id``.  The destination is checked once up front — an invalid target returns ``400`` and a target the caller cannot write returns ``403``, before any item moves. Each source then moves in its own transaction; items the caller may not write, that are sealed, held by another user, that would form a cycle, hit a name collision, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed.
+     * Bulk Move Handler
+     */
+    bulkMove(requestParameters: BulkMoveOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse>;
+
+}
+
+/**
+ * 
+ */
+export class BulkMoveApi extends runtime.BaseAPI implements BulkMoveApiInterface {
+
+    /**
+     * Creates request options for bulkMove without sending the request
+     */
+    async bulkMoveRequestOpts(requestParameters: BulkMoveOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['bulkMoveRequest'] == null) {
+            throw new runtime.RequiredError(
+                'bulkMoveRequest',
+                'Required parameter "bulkMoveRequest" was null or undefined when calling bulkMove().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/bulk-move`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: BulkMoveRequestToJSON(requestParameters['bulkMoveRequest']),
+        };
+    }
+
+    /**
+     * Move the selected folders and documents into ``target_folder_id``.  The destination is checked once up front — an invalid target returns ``400`` and a target the caller cannot write returns ``403``, before any item moves. Each source then moves in its own transaction; items the caller may not write, that are sealed, held by another user, that would form a cycle, hit a name collision, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed.
+     * Bulk Move Handler
+     */
+    async bulkMoveRaw(requestParameters: BulkMoveOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>> {
+        const requestOptions = await this.bulkMoveRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkOperationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Move the selected folders and documents into ``target_folder_id``.  The destination is checked once up front — an invalid target returns ``400`` and a target the caller cannot write returns ``403``, before any item moves. Each source then moves in its own transaction; items the caller may not write, that are sealed, held by another user, that would form a cycle, hit a name collision, or sit inside another selected folder land in ``failed`` with a reason while the rest succeed.
+     * Bulk Move Handler
+     */
+    async bulkMove(requestParameters: BulkMoveOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse> {
+        const response = await this.bulkMoveRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/TrashApi.ts

@@ -15,6 +15,8 @@
 
 import * as runtime from '../runtime';
 import type {
+  BulkOperationResponse,
+  BulkTrashRequest,
   ErrorResponse,
   HTTPValidationError,
   PaginatedResponseTrashItemResponse,
@@ -23,6 +25,10 @@ import type {
   SortDirection,
 } from '../models/index';
 import {
+    BulkOperationResponseFromJSON,
+    BulkOperationResponseToJSON,
+    BulkTrashRequestFromJSON,
+    BulkTrashRequestToJSON,
     ErrorResponseFromJSON,
     ErrorResponseToJSON,
     HTTPValidationErrorFromJSON,
@@ -37,6 +43,14 @@ import {
     SortDirectionToJSON,
 } from '../models/index';
 
+export interface BulkPermanentlyDeleteTrashRequest {
+    bulkTrashRequest: BulkTrashRequest;
+}
+
+export interface BulkRestoreTrashRequest {
+    bulkTrashRequest: BulkTrashRequest;
+}
+
 export interface ListTrashRequest {
     sortOrder?: PathOrder;
     sortDir?: SortDirection;
@@ -66,6 +80,54 @@ export interface RestoreTrashItemRequest {
  * @interface TrashApiInterface
  */
 export interface TrashApiInterface {
+    /**
+     * Creates request options for bulkPermanentlyDeleteTrash without sending the request
+     * @param {BulkTrashRequest} bulkTrashRequest 
+     * @throws {RequiredError}
+     * @memberof TrashApiInterface
+     */
+    bulkPermanentlyDeleteTrashRequestOpts(requestParameters: BulkPermanentlyDeleteTrashRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Permanently delete the selected trashed objects (by PDO id), per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; the rest are hard-deleted and their Qdrant points purged.
+     * @summary Bulk Permanently Delete Trash Handler
+     * @param {BulkTrashRequest} bulkTrashRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TrashApiInterface
+     */
+    bulkPermanentlyDeleteTrashRaw(requestParameters: BulkPermanentlyDeleteTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>>;
+
+    /**
+     * Permanently delete the selected trashed objects (by PDO id), per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; the rest are hard-deleted and their Qdrant points purged.
+     * Bulk Permanently Delete Trash Handler
+     */
+    bulkPermanentlyDeleteTrash(requestParameters: BulkPermanentlyDeleteTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse>;
+
+    /**
+     * Creates request options for bulkRestoreTrash without sending the request
+     * @param {BulkTrashRequest} bulkTrashRequest 
+     * @throws {RequiredError}
+     * @memberof TrashApiInterface
+     */
+    bulkRestoreTrashRequestOpts(requestParameters: BulkRestoreTrashRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Restore the selected trashed objects (by PDO id), reporting per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; a live name collision at the original location that auto-rename cannot resolve lands as ``name_conflict``.
+     * @summary Bulk Restore Trash Handler
+     * @param {BulkTrashRequest} bulkTrashRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TrashApiInterface
+     */
+    bulkRestoreTrashRaw(requestParameters: BulkRestoreTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>>;
+
+    /**
+     * Restore the selected trashed objects (by PDO id), reporting per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; a live name collision at the original location that auto-rename cannot resolve lands as ``name_conflict``.
+     * Bulk Restore Trash Handler
+     */
+    bulkRestoreTrash(requestParameters: BulkRestoreTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse>;
+
     /**
      * Creates request options for listTrash without sending the request
      * @param {PathOrder} [sortOrder] Sort order (default: LOGICAL &#x3D; deletion recency)
@@ -165,6 +227,120 @@ export interface TrashApiInterface {
  */
 export class TrashApi extends runtime.BaseAPI implements TrashApiInterface {
 
+    /**
+     * Creates request options for bulkPermanentlyDeleteTrash without sending the request
+     */
+    async bulkPermanentlyDeleteTrashRequestOpts(requestParameters: BulkPermanentlyDeleteTrashRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['bulkTrashRequest'] == null) {
+            throw new runtime.RequiredError(
+                'bulkTrashRequest',
+                'Required parameter "bulkTrashRequest" was null or undefined when calling bulkPermanentlyDeleteTrash().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/trash/bulk-delete`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: BulkTrashRequestToJSON(requestParameters['bulkTrashRequest']),
+        };
+    }
+
+    /**
+     * Permanently delete the selected trashed objects (by PDO id), per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; the rest are hard-deleted and their Qdrant points purged.
+     * Bulk Permanently Delete Trash Handler
+     */
+    async bulkPermanentlyDeleteTrashRaw(requestParameters: BulkPermanentlyDeleteTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>> {
+        const requestOptions = await this.bulkPermanentlyDeleteTrashRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkOperationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Permanently delete the selected trashed objects (by PDO id), per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; the rest are hard-deleted and their Qdrant points purged.
+     * Bulk Permanently Delete Trash Handler
+     */
+    async bulkPermanentlyDeleteTrash(requestParameters: BulkPermanentlyDeleteTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse> {
+        const response = await this.bulkPermanentlyDeleteTrashRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for bulkRestoreTrash without sending the request
+     */
+    async bulkRestoreTrashRequestOpts(requestParameters: BulkRestoreTrashRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['bulkTrashRequest'] == null) {
+            throw new runtime.RequiredError(
+                'bulkTrashRequest',
+                'Required parameter "bulkTrashRequest" was null or undefined when calling bulkRestoreTrash().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/trash/bulk-restore`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: BulkTrashRequestToJSON(requestParameters['bulkTrashRequest']),
+        };
+    }
+
+    /**
+     * Restore the selected trashed objects (by PDO id), reporting per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; a live name collision at the original location that auto-rename cannot resolve lands as ``name_conflict``.
+     * Bulk Restore Trash Handler
+     */
+    async bulkRestoreTrashRaw(requestParameters: BulkRestoreTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkOperationResponse>> {
+        const requestOptions = await this.bulkRestoreTrashRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkOperationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Restore the selected trashed objects (by PDO id), reporting per item.  An object not visible in the caller\'s trash scope lands in ``failed`` as ``not_found``; a live name collision at the original location that auto-rename cannot resolve lands as ``name_conflict``.
+     * Bulk Restore Trash Handler
+     */
+    async bulkRestoreTrash(requestParameters: BulkRestoreTrashRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkOperationResponse> {
+        const response = await this.bulkRestoreTrashRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listTrash without sending the request
      */