@uipath/uipath-typescript 1.4.0 → 1.4.2

package/dist/buckets/index.mjs

@@ -1299,12 +1299,18 @@ class PaginationHelpers {
      * @returns Promise resolving to a paginated result
      */
     static async getAllPaginated(params) {
-        const { serviceAccess, getEndpoint, folderId, headers: providedHeaders, paginationParams, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        const { serviceAccess, getEndpoint, folderId, headers: providedHeaders, paginationParams, additionalParams, queryParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
         const endpoint = getEndpoint(folderId);
         const headers = providedHeaders ?? (folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {});
+        // On POST, the caller's options go in the body; queryParams stays in the URL.
+        // On GET, everything is URL — queryParams merges with additionalParams.
+        const isPost = method === HTTP_METHODS.POST;
+        const requestSpec = isPost
+            ? { body: additionalParams, params: queryParams }
+            : { params: { ...additionalParams, ...queryParams } };
         const paginatedResponse = await serviceAccess.requestWithPagination(method, endpoint, paginationParams, {
             headers,
-            params: additionalParams,
+            ...requestSpec,
             pagination: {
                 paginationType: options.paginationType || PaginationType.OFFSET,
                 itemsField: options.itemsField || DEFAULT_ITEMS_FIELD,
@@ -1329,7 +1335,7 @@ class PaginationHelpers {
      * @returns Promise resolving to an object with data and totalCount
      */
     static async getAllNonPaginated(params) {
-        const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, headers: providedHeaders, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, headers: providedHeaders, additionalParams, queryParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
         // Set default field names
         const itemsField = options.itemsField || DEFAULT_ITEMS_FIELD;
         const totalCountField = options.totalCountField || DEFAULT_TOTAL_COUNT_FIELD;
@@ -1339,11 +1345,11 @@ class PaginationHelpers {
         // Make the API call based on method
         let response;
         if (method === HTTP_METHODS.POST) {
-            response = await serviceAccess.post(endpoint, additionalParams, { headers });
+            response = await serviceAccess.post(endpoint, additionalParams, { headers, params: queryParams });
         }
         else {
             response = await serviceAccess.get(endpoint, {
-                params: additionalParams,
+                params: { ...additionalParams, ...queryParams },
                 headers
             });
         }
@@ -1398,6 +1404,7 @@ class PaginationHelpers {
                 headers: config.headers,
                 paginationParams: cursor ? { cursor, pageSize } : jumpToPage !== undefined ? { jumpToPage, pageSize } : { pageSize },
                 additionalParams: prefixedOptions,
+                queryParams: config.queryParams,
                 transformFn: config.transformFn,
                 method: config.method,
                 options: {
@@ -1415,6 +1422,7 @@ class PaginationHelpers {
             folderId,
             headers: config.headers,
             additionalParams: prefixedOptions,
+            queryParams: config.queryParams,
             transformFn: config.transformFn,
             method: config.method,
             options: {
@@ -1606,18 +1614,17 @@ class BaseService {
         const params = this.validateAndPreparePaginationParams(paginationType, paginationOptions);
         // Prepare request parameters based on pagination type
         const requestParams = this.preparePaginationRequestParams(paginationType, params, options.pagination);
-        // For POST requests, merge pagination params into body and set params to undefined; for GET, use query params
+        // Route pagination state to wherever the API expects it (body for POST, URL for GET).
+        // Caller-supplied options.body / options.params are respected as-is — the api-client
+        // already handles params (URL) and body (request body) independently for every method.
         if (method.toUpperCase() === 'POST') {
             const existingBody = (options.body && typeof options.body === 'object') ? options.body : {};
             options.body = {
                 ...existingBody,
-                ...options.params,
                 ...requestParams
             };
-            options.params = undefined;
         }
         else {
-            // Merge pagination parameters with existing parameters
             options.params = {
                 ...options.params,
                 ...requestParams
@@ -2130,48 +2137,32 @@ class BucketService extends FolderScopedService {
             }
         }, options);
     }
-    /**
-     * Gets metadata for files in a bucket with optional filtering and pagination
-     *
-     * The method returns either:
-     * - A NonPaginatedResponse with items array (when no pagination parameters are provided)
-     * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
-     *
-     * @param bucketId - The ID of the bucket to get file metadata from
-     * @param folderId - Required folder ID for organization unit context
-     * @param options - Optional parameters for filtering, pagination and access URL generation
-     * @returns Promise resolving to the list of file metadata in the bucket or paginated result
-     *
-     * @example
-     * ```typescript
-     * import { Buckets } from '@uipath/uipath-typescript/buckets';
-     *
-     * const buckets = new Buckets(sdk);
-     *
-     * // Get metadata for all files in a bucket
-     * const fileMetadata = await buckets.getFileMetaData(123, 456);
-     *
-     * // Get file metadata with a specific prefix
-     * const fileMetadata = await buckets.getFileMetaData(123, 456, {
-     *   prefix: '/folder1'
-     * });
-     *
-     * // First page with pagination
-     * const page1 = await buckets.getFileMetaData(123, 456, { pageSize: 10 });
-     *
-     * // Navigate using cursor
-     * if (page1.hasNextPage) {
-     *   const page2 = await buckets.getFileMetaData(123, 456, { cursor: page1.nextCursor });
-     * }
-     * ```
-     */
-    async getFileMetaData(bucketId, folderId, options) {
+    async getFileMetaData(bucketId, optionsOrFolderId, legacyOptions) {
         if (!bucketId) {
             throw new ValidationError({ message: 'bucketId is required for getFileMetaData' });
         }
-        if (!folderId) {
-            throw new ValidationError({ message: 'folderId is required for getFileMetaData' });
+        // Normalize the two overload forms into a single internal shape.
+        let folderId;
+        let folderKey;
+        let folderPath;
+        let restOptions;
+        if (typeof optionsOrFolderId === 'number') {
+            // Deprecated positional form: getFileMetaData(bucketId, folderId, options?)
+            folderId = optionsOrFolderId;
+            restOptions = (legacyOptions ?? {});
+        }
+        else {
+            // Preferred form: getFileMetaData(bucketId, options?)
+            const opts = optionsOrFolderId ?? {};
+            ({ folderId, folderKey, folderPath, ...restOptions } = opts);
         }
+        const headers = resolveFolderHeaders({
+            folderId,
+            folderKey,
+            folderPath,
+            resourceType: 'Buckets.getFileMetaData',
+            fallbackFolderKey: this.config.folderKey,
+        });
         // Transformation function for blob items
         const transformBlobItem = (item) => transformData(item, BucketMap);
         return PaginationHelpers.getAll({
@@ -2187,93 +2178,97 @@ class BucketService extends FolderScopedService {
                     tokenParam: BUCKET_TOKEN_PARAMS.TOKEN_PARAM
                 }
             },
-            excludeFromPrefix: ['prefix'] // Bucket-specific param, not OData
-        }, { ...options, folderId });
-    }
-    /**
-     * Uploads a file to a bucket
-     *
-     * @param options - Options for file upload including bucket ID, folder ID, path, content, and optional parameters
-     * @returns Promise resolving to a response with success status and HTTP status code
-     *
-     * @example
-     * ```typescript
-     * import { Buckets } from '@uipath/uipath-typescript/buckets';
-     *
-     * const buckets = new Buckets(sdk);
-     *
-     * // Upload a file from browser
-     * const file = new File(['file content'], 'example.txt');
-     * const result = await buckets.uploadFile({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/example.txt',
-     *   content: file
-     * });
-     *
-     * // In Node env with Buffer
-     * const buffer = Buffer.from('file content');
-     * const result = await buckets.uploadFile({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/example.txt',
-     *   content: buffer
-     * });
-     * ```
-     */
-    async uploadFile(options) {
-        const { bucketId, folderId, path, content } = options;
+            excludeFromPrefix: ['prefix'], // Bucket-specific param, not OData
+            headers,
+        }, restOptions);
+    }
+    async uploadFile(bucketIdOrOptions, path, content, options) {
+        // Normalize the two overload forms into a single internal shape.
+        let bucketId;
+        let resolvedPath;
+        let resolvedContent;
+        let folderId;
+        let folderKey;
+        let folderPath;
+        if (bucketIdOrOptions !== null && typeof bucketIdOrOptions === 'object') {
+            // Deprecated options-only form: uploadFile({ bucketId, path, content, ... })
+            ({ bucketId, path: resolvedPath, content: resolvedContent, folderId, folderKey, folderPath } = bucketIdOrOptions);
+        }
+        else {
+            // Preferred positional form: uploadFile(bucketId, path, content, options?)
+            bucketId = bucketIdOrOptions;
+            resolvedPath = path;
+            resolvedContent = content;
+            const opts = options ?? {};
+            ({ folderId, folderKey, folderPath } = opts);
+        }
         if (!bucketId) {
             throw new ValidationError({ message: 'bucketId is required for uploadFile' });
         }
-        if (!folderId) {
-            throw new ValidationError({ message: 'folderId is required for uploadFile' });
-        }
-        if (!path) {
+        if (!resolvedPath) {
             throw new ValidationError({ message: 'path is required for uploadFile' });
         }
-        if (!content) {
+        if (!resolvedContent) {
             throw new ValidationError({ message: 'content is required for uploadFile' });
         }
+        const headers = resolveFolderHeaders({
+            folderId,
+            folderKey,
+            folderPath,
+            resourceType: 'Buckets.uploadFile',
+            fallbackFolderKey: this.config.folderKey,
+        });
         const uriResponse = await this._getWriteUri({
             bucketId,
-            folderId,
-            path,
+            path: resolvedPath,
+            headers,
         });
         // Upload file to the provided URI
-        const response = await this._uploadToUri(uriResponse, content);
+        const response = await this._uploadToUri(uriResponse, resolvedContent);
         return {
             success: response.status >= 200 && response.status < 300,
             statusCode: response.status
         };
     }
-    /**
-     * Gets a direct download URL for a file in the bucket
-     *
-     * @param options - Contains bucketId, folderId, file path and optional expiry time
-     * @returns Promise resolving to blob file access information
-     *
-     * @example
-     * ```typescript
-     * import { Buckets } from '@uipath/uipath-typescript/buckets';
-     *
-     * const buckets = new Buckets(sdk);
-     *
-     * // Get download URL for a file
-     * const fileAccess = await buckets.getReadUri({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/file.pdf'
-     * });
-     * ```
-     */
-    async getReadUri(options) {
-        const { bucketId, folderId, path, expiryInMinutes, ...restOptions } = options;
+    async getReadUri(bucketIdOrOptions, path, options) {
+        // Normalize the two overload forms into a single internal shape.
+        let bucketId;
+        let resolvedPath;
+        let folderId;
+        let folderKey;
+        let folderPath;
+        let expiryInMinutes;
+        let restOptions;
+        if (bucketIdOrOptions !== null && typeof bucketIdOrOptions === 'object') {
+            // Deprecated options-only form: getReadUri({ bucketId, path, ... })
+            const { bucketId: bid, path: p, expiryInMinutes: e, folderId: fid, folderKey: fkey, folderPath: fpath, ...rest } = bucketIdOrOptions;
+            bucketId = bid;
+            resolvedPath = p;
+            expiryInMinutes = e;
+            folderId = fid;
+            folderKey = fkey;
+            folderPath = fpath;
+            restOptions = rest;
+        }
+        else {
+            // Preferred positional form: getReadUri(bucketId, path, options?)
+            bucketId = bucketIdOrOptions;
+            resolvedPath = path;
+            const opts = options ?? {};
+            ({ expiryInMinutes, folderId, folderKey, folderPath, ...restOptions } = opts);
+        }
+        const headers = resolveFolderHeaders({
+            folderId,
+            folderKey,
+            folderPath,
+            resourceType: 'Buckets.getReadUri',
+            fallbackFolderKey: this.config.folderKey,
+        });
         const queryOptions = {
             expiryInMinutes,
             ...addPrefixToKeys(restOptions, ODATA_PREFIX, Object.keys(restOptions))
         };
-        return this._getUri(BUCKET_ENDPOINTS.GET_READ_URI(bucketId), bucketId, folderId, path, queryOptions);
+        return this._getUri(BUCKET_ENDPOINTS.GET_READ_URI(bucketId), bucketId, resolvedPath, headers, queryOptions);
     }
     /**
      * Uploads content to the provided URI
@@ -2303,23 +2298,18 @@ class BucketService extends FolderScopedService {
      * Private method to handle common URI request logic
      * @param endpoint - The API endpoint to call
      * @param bucketId - The bucket ID
-     * @param folderId - The folder ID
      * @param path - The file path
+     * @param headers - Pre-built folder-context headers (built via `resolveFolderHeaders`)
      * @param queryOptions - Additional query parameters
      * @returns Promise resolving to blob file access information
      */
-    async _getUri(endpoint, bucketId, folderId, path, queryOptions = {}) {
+    async _getUri(endpoint, bucketId, path, headers, queryOptions = {}) {
         if (!bucketId) {
             throw new ValidationError({ message: 'bucketId is required for getUri' });
         }
-        if (!folderId) {
-            throw new ValidationError({ message: 'folderId is required for getUri' });
-        }
         if (!path) {
             throw new ValidationError({ message: 'path is required for getUri' });
         }
-        // Create headers with required folder ID
-        const headers = createHeaders({ [FOLDER_ID]: folderId });
         // Filter out undefined values and build query params
         const queryParams = filterUndefined({
             path,
@@ -2454,16 +2444,16 @@ class BucketService extends FolderScopedService {
     /**
      * Gets a direct upload URL for a file in the bucket
      *
-     * @param options - Contains bucketId, folderId, file path, optional expiry time
+     * @param options - Contains bucketId, file path, optional expiry time, and pre-built folder-context headers
      * @returns Promise resolving to blob file access information
      */
     async _getWriteUri(options) {
-        const { bucketId, folderId, path, expiryInMinutes, ...restOptions } = options;
+        const { bucketId, path, expiryInMinutes, headers, ...restOptions } = options;
         const queryOptions = {
             expiryInMinutes,
             ...addPrefixToKeys(restOptions, ODATA_PREFIX, Object.keys(restOptions))
         };
-        return this._getUri(BUCKET_ENDPOINTS.GET_WRITE_URI(bucketId), bucketId, folderId, path, queryOptions);
+        return this._getUri(BUCKET_ENDPOINTS.GET_WRITE_URI(bucketId), bucketId, path, headers, queryOptions);
     }
 }
 __decorate([

package/dist/cases/index.cjs

@@ -1623,12 +1623,18 @@ class PaginationHelpers {
      * @returns Promise resolving to a paginated result
      */
     static async getAllPaginated(params) {
-        const { serviceAccess, getEndpoint, folderId, headers: providedHeaders, paginationParams, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        const { serviceAccess, getEndpoint, folderId, headers: providedHeaders, paginationParams, additionalParams, queryParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
         const endpoint = getEndpoint(folderId);
         const headers = providedHeaders ?? (folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {});
+        // On POST, the caller's options go in the body; queryParams stays in the URL.
+        // On GET, everything is URL — queryParams merges with additionalParams.
+        const isPost = method === HTTP_METHODS.POST;
+        const requestSpec = isPost
+            ? { body: additionalParams, params: queryParams }
+            : { params: { ...additionalParams, ...queryParams } };
         const paginatedResponse = await serviceAccess.requestWithPagination(method, endpoint, paginationParams, {
             headers,
-            params: additionalParams,
+            ...requestSpec,
             pagination: {
                 paginationType: options.paginationType || PaginationType.OFFSET,
                 itemsField: options.itemsField || DEFAULT_ITEMS_FIELD,
@@ -1653,7 +1659,7 @@ class PaginationHelpers {
      * @returns Promise resolving to an object with data and totalCount
      */
     static async getAllNonPaginated(params) {
-        const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, headers: providedHeaders, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+        const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, headers: providedHeaders, additionalParams, queryParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
         // Set default field names
         const itemsField = options.itemsField || DEFAULT_ITEMS_FIELD;
         const totalCountField = options.totalCountField || DEFAULT_TOTAL_COUNT_FIELD;
@@ -1663,11 +1669,11 @@ class PaginationHelpers {
         // Make the API call based on method
         let response;
         if (method === HTTP_METHODS.POST) {
-            response = await serviceAccess.post(endpoint, additionalParams, { headers });
+            response = await serviceAccess.post(endpoint, additionalParams, { headers, params: queryParams });
         }
         else {
             response = await serviceAccess.get(endpoint, {
-                params: additionalParams,
+                params: { ...additionalParams, ...queryParams },
                 headers
             });
         }
@@ -1722,6 +1728,7 @@ class PaginationHelpers {
                 headers: config.headers,
                 paginationParams: cursor ? { cursor, pageSize } : jumpToPage !== undefined ? { jumpToPage, pageSize } : { pageSize },
                 additionalParams: prefixedOptions,
+                queryParams: config.queryParams,
                 transformFn: config.transformFn,
                 method: config.method,
                 options: {
@@ -1739,6 +1746,7 @@ class PaginationHelpers {
             folderId,
             headers: config.headers,
             additionalParams: prefixedOptions,
+            queryParams: config.queryParams,
             transformFn: config.transformFn,
             method: config.method,
             options: {
@@ -1930,18 +1938,17 @@ class BaseService {
         const params = this.validateAndPreparePaginationParams(paginationType, paginationOptions);
         // Prepare request parameters based on pagination type
         const requestParams = this.preparePaginationRequestParams(paginationType, params, options.pagination);
-        // For POST requests, merge pagination params into body and set params to undefined; for GET, use query params
+        // Route pagination state to wherever the API expects it (body for POST, URL for GET).
+        // Caller-supplied options.body / options.params are respected as-is — the api-client
+        // already handles params (URL) and body (request body) independently for every method.
         if (method.toUpperCase() === 'POST') {
             const existingBody = (options.body && typeof options.body === 'object') ? options.body : {};
             options.body = {
                 ...existingBody,
-                ...options.params,
                 ...requestParams
             };
-            options.params = undefined;
         }
         else {
-            // Merge pagination parameters with existing parameters
             options.params = {
                 ...options.params,
                 ...requestParams
@@ -2828,6 +2835,24 @@ var TaskActivityType;
     TaskActivityType["BulkCompleted"] = "BulkCompleted";
     TaskActivityType["FirstOpened"] = "FirstOpened";
 })(TaskActivityType || (TaskActivityType = {}));
+/**
+ * Defines how a task assignment is distributed.
+ *
+ * Defaults to {@link TaskAssignmentCriteria.SingleUser} (a direct single-user
+ * assignment) when not specified. The group-based criteria tell Action Center
+ * how to distribute the task across the members of a directory group.
+ */
+var TaskAssignmentCriteria;
+(function (TaskAssignmentCriteria) {
+    /** Assigned to a single user, like a direct assignment. */
+    TaskAssignmentCriteria["SingleUser"] = "SingleUser";
+    /** Assigned to the group member with the fewest pending tasks. */
+    TaskAssignmentCriteria["Workload"] = "Workload";
+    /** Assigned to all users in the group. */
+    TaskAssignmentCriteria["AllUsers"] = "AllUsers";
+    /** Assigned in a round-robin manner across the group's members. */
+    TaskAssignmentCriteria["RoundRobin"] = "RoundRobin";
+})(TaskAssignmentCriteria || (TaskAssignmentCriteria = {}));
 
 /**
  * Maps numeric TaskStatus values (from API) to TaskStatus enum values.
@@ -2877,17 +2902,19 @@ function createTaskMethods(taskData, service) {
         async assign(options) {
             if (!taskData.id)
                 throw new Error('Task ID is undefined');
+            const criteria = options.assignmentCriteria !== undefined ? { assignmentCriteria: options.assignmentCriteria } : {};
             const assignmentOptions = 'userId' in options && options.userId !== undefined
-                ? { taskId: taskData.id, userId: options.userId }
-                : { taskId: taskData.id, userNameOrEmail: options.userNameOrEmail };
+                ? { taskId: taskData.id, userId: options.userId, ...criteria }
+                : { taskId: taskData.id, userNameOrEmail: options.userNameOrEmail, ...criteria };
             return service.assign(assignmentOptions);
         },
         async reassign(options) {
             if (!taskData.id)
                 throw new Error('Task ID is undefined');
+            const criteria = options.assignmentCriteria !== undefined ? { assignmentCriteria: options.assignmentCriteria } : {};
             const assignmentOptions = 'userId' in options && options.userId !== undefined
-                ? { taskId: taskData.id, userId: options.userId }
-                : { taskId: taskData.id, userNameOrEmail: options.userNameOrEmail };
+                ? { taskId: taskData.id, userId: options.userId, ...criteria }
+                : { taskId: taskData.id, userNameOrEmail: options.userNameOrEmail, ...criteria };
             return service.reassign(assignmentOptions);
         },
         async unassign() {
@@ -3200,6 +3227,26 @@ class TaskService extends BaseService {
      *   }
      * ]);
      * ```
+     *
+     * @example Group assignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Assign to a directory group by userId + criteria — Action Center
+     * // distributes the task across the group's members based on the criteria
+     * const result = await tasks.assign({
+     *   taskId: 123,
+     *   userId: 456, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.assign({
+     *   taskId: 123,
+     *   userNameOrEmail: "My Group",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     async assign(taskAssignments) {
         // Normalize input to array
@@ -3251,6 +3298,25 @@ class TaskService extends BaseService {
      *   }
      * ]);
      * ```
+     *
+     * @example Group reassignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Reassign to a directory group by userId + criteria
+     * const result = await tasks.reassign({
+     *   taskId: 123,
+     *   userId: 456, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.reassign({
+     *   taskId: 123,
+     *   userNameOrEmail: "My Group",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     async reassign(taskAssignments) {
         // Normalize input to array

package/dist/cases/index.d.ts

@@ -1090,22 +1090,49 @@ interface RawTaskGetResponse extends TaskBaseResponse {
     actionLabel?: string | null;
     taskSlaDetails?: TaskSlaDetail[] | null;
     completedByUser?: UserLoginInfo | null;
-    taskAssignmentCriteria?: string;
+    taskAssignmentCriteria?: TaskAssignmentCriteria;
     taskAssignees?: UserLoginInfo[] | null;
     taskSource?: TaskSource | null;
     processingTime?: number | null;
     data?: Record<string, unknown> | null;
 }
+/**
+ * Defines how a task assignment is distributed.
+ *
+ * Defaults to {@link TaskAssignmentCriteria.SingleUser} (a direct single-user
+ * assignment) when not specified. The group-based criteria tell Action Center
+ * how to distribute the task across the members of a directory group.
+ */
+declare enum TaskAssignmentCriteria {
+    /** Assigned to a single user, like a direct assignment. */
+    SingleUser = "SingleUser",
+    /** Assigned to the group member with the fewest pending tasks. */
+    Workload = "Workload",
+    /** Assigned to all users in the group. */
+    AllUsers = "AllUsers",
+    /** Assigned in a round-robin manner across the group's members. */
+    RoundRobin = "RoundRobin"
+}
 /**
  * Options for task assignment operations when called from a task instance
- * Requires either userId or userNameOrEmail, but not both
+ * Requires either userId or userNameOrEmail, but not both. Optionally accepts
+ * an assignment criteria; defaults to a single-user assignment, set a group
+ * criteria (e.g. {@link TaskAssignmentCriteria.AllUsers}) for a directory group.
  */
-type TaskAssignOptions = {
+type TaskAssignOptions = ({
     userId: number;
     userNameOrEmail?: never;
 } | {
     userId?: never;
     userNameOrEmail: string;
+}) & {
+    /**
+     * How the assignment is distributed. Optional — defaults to
+     * {@link TaskAssignmentCriteria.SingleUser} (a direct single-user assignment).
+     * Set a group criteria (e.g. {@link TaskAssignmentCriteria.AllUsers}) to
+     * distribute the task across a directory group's members.
+     */
+    assignmentCriteria?: TaskAssignmentCriteria;
 };
 /**
  * Options for task assignment operations when called from the service