@uipath/uipath-typescript 1.4.0 → 1.4.1

package/dist/agents/index.mjs

@@ -937,6 +937,17 @@ const AGENTS_OFFSET_PARAMS = {
     /** No count param needed */
     COUNT_PARAM: undefined
 };
+/**
+ * Agents incidents pagination constants — the items array is the `data` field
+ * itself, total count is nested under the response envelope. Reuses
+ * AGENTS_OFFSET_PARAMS for request params (same 0-based page-number style).
+ */
+const AGENTS_INCIDENTS_PAGINATION = {
+    /** Dotted path to the items array in the incidents response envelope */
+    ITEMS_FIELD: 'data',
+    /** Total count path — same envelope location as the agents list. */
+    TOTAL_COUNT_FIELD: AGENTS_PAGINATION.TOTAL_COUNT_FIELD
+};
 /**
  * OData OFFSET pagination parameter names (ODATA-style)
  */
@@ -1141,12 +1152,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,
@@ -1171,7 +1188,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;
@@ -1181,11 +1198,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
             });
         }
@@ -1240,6 +1257,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: {
@@ -1257,6 +1275,7 @@ class PaginationHelpers {
             folderId,
             headers: config.headers,
             additionalParams: prefixedOptions,
+            queryParams: config.queryParams,
             transformFn: config.transformFn,
             method: config.method,
             options: {
@@ -1448,18 +1467,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
@@ -1595,6 +1613,14 @@ const INSIGHTS_RTM_BASE = 'insightsrtm_';
 const AGENTS_ENDPOINTS = {
     /** Paginated list of agents with consumption and health metadata. */
     GET_AGENTS: `${INSIGHTS_RTM_BASE}/Agents/agents`,
+    /** Paginated list of agent incidents (errors) over the requested window. */
+    GET_INCIDENTS: `${INSIGHTS_RTM_BASE}/Agents/incidents`,
+    /** Time-series of error counts grouped by agent over the requested window. */
+    GET_ERRORS_TIMELINE: `${INSIGHTS_RTM_BASE}/Agents/errors`,
+    /** Time-series of AGU consumption over the requested window. */
+    GET_CONSUMPTION_TIMELINE: `${INSIGHTS_RTM_BASE}/Agents/consumptionTimeline`,
+    /** Time-series of agent latency (per-percentile) over the requested window. */
+    GET_LATENCY_TIMELINE: `${INSIGHTS_RTM_BASE}/Agents/latencyTimeline`,
 };
 
 /**
@@ -1698,10 +1724,235 @@ class AgentService extends BaseService {
             },
         }, apiOptions);
     }
+    /**
+     * Retrieves agent errors (error-classes observed for agents) over the
+     * requested window.
+     *
+     * Returns a {@link PaginatedResponse} when pagination options (`pageSize`,
+     * `cursor`, or `jumpToPage`) are provided, otherwise a
+     * {@link NonPaginatedResponse}.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional pagination, sort/group, and filters
+     * @returns Promise resolving to a paginated or non-paginated list of {@link AgentError}
+     * @example
+     * ```typescript
+     * import { Agents, AgentErrorSortColumn } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // Non-paginated — errors in the window
+     * const result = await agents.getErrors(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2026-05-14T00:00:00Z'),
+     * );
+     * result.items.forEach((error) => {
+     *   console.log(`${error.type}: ${error.description} (count=${error.count})`);
+     * });
+     *
+     * // Paginated — sorted by execution count descending
+     * const page = await agents.getErrors(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2026-05-14T00:00:00Z'),
+     *   {
+     *     pageSize: 25,
+     *     orderBy: { column: AgentErrorSortColumn.ExecutionCount, desc: true },
+     *   },
+     * );
+     *
+     * if (page.hasNextPage && page.nextCursor) {
+     *   const next = await agents.getErrors(
+     *     new Date('2025-05-01T00:00:00Z'),
+     *     new Date('2026-05-14T00:00:00Z'),
+     *     { cursor: page.nextCursor },
+     *   );
+     * }
+     * ```
+     */
+    async getErrors(startTime, endTime, options) {
+        const apiOptions = { ...options, startTime: startTime.toISOString(), endTime: endTime.toISOString() };
+        return PaginationHelpers.getAll({
+            serviceAccess: this.createPaginationServiceAccess(),
+            getEndpoint: () => AGENTS_ENDPOINTS.GET_INCIDENTS,
+            method: HTTP_METHODS.POST,
+            excludeFromPrefix: Object.keys(apiOptions),
+            pagination: {
+                paginationType: PaginationType.OFFSET,
+                itemsField: AGENTS_INCIDENTS_PAGINATION.ITEMS_FIELD,
+                totalCountField: AGENTS_INCIDENTS_PAGINATION.TOTAL_COUNT_FIELD,
+                paginationParams: {
+                    pageSizeParam: AGENTS_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+                    offsetParam: AGENTS_OFFSET_PARAMS.OFFSET_PARAM,
+                    countParam: AGENTS_OFFSET_PARAMS.COUNT_PARAM,
+                    convertToSkip: false,
+                    zeroBased: true,
+                },
+            },
+        }, apiOptions);
+    }
+    /**
+     * Retrieves a time-series of error counts grouped by agent over the requested window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetErrorsTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // All errors in May 2025
+     * const result = await agents.getErrorsTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value} errors`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and top 5 agents
+     * const result = await agents.getErrorsTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentNames: ['JokeAgent', 'StoryAgent'],
+     *     limit: 5,
+     *   },
+     * );
+     * ```
+     */
+    async getErrorsTimeline(startTime, endTime, options) {
+        const body = this.buildAgentFilterBody(startTime, endTime, options);
+        const response = await this.post(AGENTS_ENDPOINTS.GET_ERRORS_TIMELINE, body);
+        return response.data.data;
+    }
+    /**
+     * Retrieves a time-series of AGU (Agent Units) consumption over the requested window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetConsumptionTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // AGU consumption timeline in May 2025
+     * const result = await agents.getConsumptionTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.timeSlice}: ${point.aguConsumption} AGU`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and agents
+     * const result = await agents.getConsumptionTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentNames: ['JokeAgent'],
+     *   },
+     * );
+     * ```
+     */
+    async getConsumptionTimeline(startTime, endTime, options) {
+        const body = this.buildAgentFilterBody(startTime, endTime, options);
+        const response = await this.post(AGENTS_ENDPOINTS.GET_CONSUMPTION_TIMELINE, body);
+        return response.data.data;
+    }
+    /**
+     * Retrieves a time-series of agent latency (milliseconds) over the requested
+     * window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetLatencyTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // Latency timeline in May 2025
+     * const result = await agents.getLatencyTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value} ms`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and a single agent
+     * const result = await agents.getLatencyTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentId: '<agentId>',
+     *   },
+     * );
+     * ```
+     */
+    async getLatencyTimeline(startTime, endTime, options) {
+        const body = this.buildAgentFilterBody(startTime, endTime, options);
+        const response = await this.post(AGENTS_ENDPOINTS.GET_LATENCY_TIMELINE, body);
+        return response.data.data;
+    }
+    /**
+     * Builds the common POST request body shared by the agent filter endpoints —
+     * the required time window plus any optional folder/agent/project/process
+     * filters. Undefined options are omitted so the server applies its defaults.
+     */
+    buildAgentFilterBody(startTime, endTime, options) {
+        const body = {
+            startTime: startTime.toISOString(),
+            endTime: endTime.toISOString(),
+        };
+        if (options?.folderKeys !== undefined)
+            body.folderKeys = options.folderKeys;
+        if (options?.agentNames !== undefined)
+            body.agentNames = options.agentNames;
+        if (options?.projectKeys !== undefined)
+            body.projectKeys = options.projectKeys;
+        if (options?.agentId !== undefined)
+            body.agentId = options.agentId;
+        if (options?.processVersion !== undefined)
+            body.processVersion = options.processVersion;
+        if (options?.limit !== undefined)
+            body.limit = options.limit;
+        return body;
+    }
 }
 __decorate([
     track('Agents.GetAll')
 ], AgentService.prototype, "getAll", null);
+__decorate([
+    track('Agents.GetErrors')
+], AgentService.prototype, "getErrors", null);
+__decorate([
+    track('Agents.GetErrorsTimeline')
+], AgentService.prototype, "getErrorsTimeline", null);
+__decorate([
+    track('Agents.GetConsumptionTimeline')
+], AgentService.prototype, "getConsumptionTimeline", null);
+__decorate([
+    track('Agents.GetLatencyTimeline')
+], AgentService.prototype, "getLatencyTimeline", null);
 
 /**
  * Columns available for ordering results.
@@ -1720,5 +1971,23 @@ var AgentListSortColumn;
     AgentListSortColumn["QuantityPLTU"] = "QuantityPLTU";
     AgentListSortColumn["FolderPath"] = "FolderPath";
 })(AgentListSortColumn || (AgentListSortColumn = {}));
+/**
+ * Columns available for ordering / grouping the agent errors list.
+ */
+var AgentErrorSortColumn;
+(function (AgentErrorSortColumn) {
+    AgentErrorSortColumn["AgentId"] = "AgentId";
+    AgentErrorSortColumn["AgentName"] = "AgentName";
+    AgentErrorSortColumn["ParentProcessName"] = "ParentProcessName";
+    AgentErrorSortColumn["ErrorTitle"] = "ErrorTitle";
+    AgentErrorSortColumn["FirstSeenStartTime"] = "FirstSeenStartTime";
+    AgentErrorSortColumn["ExecutionCount"] = "ExecutionCount";
+    AgentErrorSortColumn["Type"] = "Type";
+    AgentErrorSortColumn["FirstSeenFolderName"] = "FirstSeenFolderName";
+    AgentErrorSortColumn["FirstSeenFolderPath"] = "FirstSeenFolderPath";
+    AgentErrorSortColumn["LastSeenStartTime"] = "LastSeenStartTime";
+    AgentErrorSortColumn["LastSeenFolderName"] = "LastSeenFolderName";
+    AgentErrorSortColumn["LastSeenFolderPath"] = "LastSeenFolderPath";
+})(AgentErrorSortColumn || (AgentErrorSortColumn = {}));
 
-export { AgentListSortColumn, AgentService as Agents };
+export { AgentErrorSortColumn, AgentListSortColumn, AgentService as Agents };

package/dist/assets/index.cjs

@@ -1258,12 +1258,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,
@@ -1288,7 +1294,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;
@@ -1298,11 +1304,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
             });
         }
@@ -1357,6 +1363,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: {
@@ -1374,6 +1381,7 @@ class PaginationHelpers {
             folderId,
             headers: config.headers,
             additionalParams: prefixedOptions,
+            queryParams: config.queryParams,
             transformFn: config.transformFn,
             method: config.method,
             options: {
@@ -1565,18 +1573,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

package/dist/assets/index.mjs

@@ -1256,12 +1256,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,
@@ -1286,7 +1292,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;
@@ -1296,11 +1302,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
             });
         }
@@ -1355,6 +1361,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: {
@@ -1372,6 +1379,7 @@ class PaginationHelpers {
             folderId,
             headers: config.headers,
             additionalParams: prefixedOptions,
+            queryParams: config.queryParams,
             transformFn: config.transformFn,
             method: config.method,
             options: {
@@ -1563,18 +1571,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

package/dist/attachments/index.cjs

@@ -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