algoliasearch 5.0.0-alpha.98 → 5.0.0-beta.1

package/dist/algoliasearch.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
+var crypto = require('crypto');
 var clientCommon = require('@algolia/client-common');
 var requesterNodeHttp = require('@algolia/requester-node-http');
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion$4 = '5.0.0-alpha.98';
+const apiClientVersion$4 = '5.0.0-beta.1';
 const REGIONS$2 = ['de', 'us'];
 function getDefaultHosts$3(region) {
     const url = !region
@@ -64,9 +65,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             transporter.algoliaAgent.add({ segment, version });
         },
         /**
-         * Creates an A/B test.
+         * Creates a new A/B test.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Create an A/B test.
          * @param addABTestsRequest - The addABTestsRequest object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -98,7 +101,6 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customDelete - The customDelete object.
          * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customDelete.parameters - Query parameters to apply to the current query.
@@ -108,7 +110,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -122,7 +124,6 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customGet - The customGet object.
          * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customGet.parameters - Query parameters to apply to the current query.
@@ -132,7 +133,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customGet`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -146,7 +147,6 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPost - The customPost object.
          * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPost.parameters - Query parameters to apply to the current query.
@@ -157,7 +157,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPost`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -172,7 +172,6 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPut - The customPut object.
          * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPut.parameters - Query parameters to apply to the current query.
@@ -183,7 +182,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPut`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -196,11 +195,13 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
+         * Deletes an A/B test by its ID.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Delete an A/B test.
          * @param deleteABTest - The deleteABTest object.
-         * @param deleteABTest.id - Unique A/B test ID.
+         * @param deleteABTest.id - Unique A/B test identifier.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteABTest({ id }, requestOptions) {
@@ -219,11 +220,13 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get specific details for an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
+         * Retrieves the details for an A/B test by its ID.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get A/B test details.
          * @param getABTest - The getABTest object.
-         * @param getABTest.id - Unique A/B test ID.
+         * @param getABTest.id - Unique A/B test identifier.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getABTest({ id }, requestOptions) {
@@ -242,14 +245,16 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * List all A/B tests.
+         * Lists all A/B tests you configured for this application.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary List all A/B tests.
          * @param listABTests - The listABTests object.
-         * @param listABTests.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param listABTests.limit - Number of records to return (page size).
-         * @param listABTests.indexPrefix - Only return A/B tests for indices starting with this prefix.
-         * @param listABTests.indexSuffix - Only return A/B tests for indices ending with this suffix.
+         * @param listABTests.offset - Position of the first item to return.
+         * @param listABTests.limit - Number of items to return.
+         * @param listABTests.indexPrefix - Index name prefix. Only A/B tests for indices starting with this string are included in the response.
+         * @param listABTests.indexSuffix - Index name suffix. Only A/B tests for indices ending with this string are included in the response.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         listABTests({ offset, limit, indexPrefix, indexSuffix } = {}, requestOptions = undefined) {
@@ -277,11 +282,13 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * If stopped, the test is over and can\'t be restarted. There is now only one index, receiving 100% of all search requests. The data gathered for stopped A/B tests is retained. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
+         * Stops an A/B test by its ID.  You can\'t restart stopped A/B tests.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Stop an A/B test.
          * @param stopABTest - The stopABTest object.
-         * @param stopABTest.id - Unique A/B test ID.
+         * @param stopABTest.id - Unique A/B test identifier.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         stopABTest({ id }, requestOptions) {
@@ -303,7 +310,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion$3 = '5.0.0-alpha.98';
+const apiClientVersion$3 = '5.0.0-beta.1';
 const REGIONS$1 = ['de', 'us'];
 function getDefaultHosts$2(region) {
     const url = !region
@@ -365,7 +372,6 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customDelete - The customDelete object.
          * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customDelete.parameters - Query parameters to apply to the current query.
@@ -375,7 +381,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -389,7 +395,6 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customGet - The customGet object.
          * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customGet.parameters - Query parameters to apply to the current query.
@@ -399,7 +404,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customGet`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -413,7 +418,6 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPost - The customPost object.
          * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPost.parameters - Query parameters to apply to the current query.
@@ -424,7 +428,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPost`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -439,7 +443,6 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPut - The customPut object.
          * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPut.parameters - Query parameters to apply to the current query.
@@ -450,7 +453,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPut`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -463,14 +466,56 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the average click position for the complete time range and for individual days. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
+         * Retrieves the add-to-cart rate for all of your searches with at least one add-to-cart event, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
+         *
+         * @param getAddToCartRate - The getAddToCartRate object.
+         * @param getAddToCartRate.index - Index name.
+         * @param getAddToCartRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getAddToCartRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getAddToCartRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getAddToCartRate({ index, startDate, endDate, tags }, requestOptions) {
+            if (!index) {
+                throw new Error('Parameter `index` is required when calling `getAddToCartRate`.');
+            }
+            const requestPath = '/2/conversions/addToCartRate';
+            const headers = {};
+            const queryParameters = {};
+            if (index !== undefined) {
+                queryParameters.index = index.toString();
+            }
+            if (startDate !== undefined) {
+                queryParameters.startDate = startDate.toString();
+            }
+            if (endDate !== undefined) {
+                queryParameters.endDate = endDate.toString();
+            }
+            if (tags !== undefined) {
+                queryParameters.tags = tags.toString();
+            }
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
+        /**
+         * Retrieves the average click position of your search results, including a daily breakdown.  The average click position is the average of all clicked search results\' positions. For example, if users only ever click on the first result for any search, the average click position is 1. By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get average click position.
          * @param getAverageClickPosition - The getAverageClickPosition object.
-         * @param getAverageClickPosition.index - Index name to target.
-         * @param getAverageClickPosition.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getAverageClickPosition.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getAverageClickPosition.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getAverageClickPosition.index - Index name.
+         * @param getAverageClickPosition.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getAverageClickPosition.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getAverageClickPosition.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -501,14 +546,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Show the number of clicks events and their associated position in the search results.  > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
+         * Retrieves the positions in the search results and their associated number of clicks.  This lets you check how many clicks the first, second, or tenth search results receive.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get click positions.
          * @param getClickPositions - The getClickPositions object.
-         * @param getClickPositions.index - Index name to target.
-         * @param getClickPositions.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getClickPositions.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getClickPositions.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getClickPositions.index - Index name.
+         * @param getClickPositions.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getClickPositions.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getClickPositions.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -539,14 +586,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
+         * Retrieves the click-through rate for all of your searches with at least one click event, including a daily breakdown  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get click-through rate (CTR).
          * @param getClickThroughRate - The getClickThroughRate object.
-         * @param getClickThroughRate.index - Index name to target.
-         * @param getClickThroughRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getClickThroughRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getClickThroughRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getClickThroughRate.index - Index name.
+         * @param getClickThroughRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getClickThroughRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getClickThroughRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -577,19 +626,21 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
+         * Retrieves the conversion rate for all of your searches with at least one conversion event, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get conversion rate (CR).
-         * @param getConversationRate - The getConversationRate object.
-         * @param getConversationRate.index - Index name to target.
-         * @param getConversationRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getConversationRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getConversationRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getConversionRate - The getConversionRate object.
+         * @param getConversionRate.index - Index name.
+         * @param getConversionRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getConversionRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getConversionRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
+        getConversionRate({ index, startDate, endDate, tags }, requestOptions) {
             if (!index) {
-                throw new Error('Parameter `index` is required when calling `getConversationRate`.');
+                throw new Error('Parameter `index` is required when calling `getConversionRate`.');
             }
             const requestPath = '/2/conversions/conversionRate';
             const headers = {};
@@ -615,14 +666,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the rate at which searches don\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
+         * Retrieves the fraction of searches that didn\'t lead to any click within a time range, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get no click rate.
          * @param getNoClickRate - The getNoClickRate object.
-         * @param getNoClickRate.index - Index name to target.
-         * @param getNoClickRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getNoClickRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getNoClickRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getNoClickRate.index - Index name.
+         * @param getNoClickRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getNoClickRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getNoClickRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -653,14 +706,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the rate at which searches didn\'t return any results.
+         * Retrieves the fraction of searches that didn\'t return any results within a time range, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get no results rate.
          * @param getNoResultsRate - The getNoResultsRate object.
-         * @param getNoResultsRate.index - Index name to target.
-         * @param getNoResultsRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getNoResultsRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getNoResultsRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getNoResultsRate.index - Index name.
+         * @param getNoResultsRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getNoResultsRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getNoResultsRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -691,14 +746,96 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the number of searches within a time range.
+         * Retrieves the purchase rate for all of your searches with at least one purchase event, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
+         *
+         * @param getPurchaseRate - The getPurchaseRate object.
+         * @param getPurchaseRate.index - Index name.
+         * @param getPurchaseRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getPurchaseRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getPurchaseRate.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getPurchaseRate({ index, startDate, endDate, tags }, requestOptions) {
+            if (!index) {
+                throw new Error('Parameter `index` is required when calling `getPurchaseRate`.');
+            }
+            const requestPath = '/2/conversions/purchaseRate';
+            const headers = {};
+            const queryParameters = {};
+            if (index !== undefined) {
+                queryParameters.index = index.toString();
+            }
+            if (startDate !== undefined) {
+                queryParameters.startDate = startDate.toString();
+            }
+            if (endDate !== undefined) {
+                queryParameters.endDate = endDate.toString();
+            }
+            if (tags !== undefined) {
+                queryParameters.tags = tags.toString();
+            }
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
+        /**
+         * Retrieves revenue-related metrics, such as the total revenue or the average order value.  To retrieve revenue-related metrics, sent purchase events. By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
+         *
+         * @param getRevenue - The getRevenue object.
+         * @param getRevenue.index - Index name.
+         * @param getRevenue.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getRevenue.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getRevenue.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getRevenue({ index, startDate, endDate, tags }, requestOptions) {
+            if (!index) {
+                throw new Error('Parameter `index` is required when calling `getRevenue`.');
+            }
+            const requestPath = '/2/conversions/revenue';
+            const headers = {};
+            const queryParameters = {};
+            if (index !== undefined) {
+                queryParameters.index = index.toString();
+            }
+            if (startDate !== undefined) {
+                queryParameters.startDate = startDate.toString();
+            }
+            if (endDate !== undefined) {
+                queryParameters.endDate = endDate.toString();
+            }
+            if (tags !== undefined) {
+                queryParameters.tags = tags.toString();
+            }
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
+        /**
+         * Retrieves the number of searches within a time range, including a daily breakdown.  By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get number of searches.
          * @param getSearchesCount - The getSearchesCount object.
-         * @param getSearchesCount.index - Index name to target.
-         * @param getSearchesCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getSearchesCount.index - Index name.
+         * @param getSearchesCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesCount.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -729,16 +866,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
+         * Retrieves the most popular searches that didn\'t lead to any clicks, from the 1,000 most frequent searches.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top searches with no clicks.
          * @param getSearchesNoClicks - The getSearchesNoClicks object.
-         * @param getSearchesNoClicks.index - Index name to target.
-         * @param getSearchesNoClicks.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesNoClicks.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesNoClicks.limit - Number of records to return (page size).
-         * @param getSearchesNoClicks.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getSearchesNoClicks.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getSearchesNoClicks.index - Index name.
+         * @param getSearchesNoClicks.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesNoClicks.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesNoClicks.limit - Number of items to return.
+         * @param getSearchesNoClicks.offset - Position of the first item to return.
+         * @param getSearchesNoClicks.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -775,16 +914,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
+         * Retrieves the most popular searches that didn\'t return any results.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top searches with no results.
          * @param getSearchesNoResults - The getSearchesNoResults object.
-         * @param getSearchesNoResults.index - Index name to target.
-         * @param getSearchesNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getSearchesNoResults.limit - Number of records to return (page size).
-         * @param getSearchesNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getSearchesNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getSearchesNoResults.index - Index name.
+         * @param getSearchesNoResults.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getSearchesNoResults.limit - Number of items to return.
+         * @param getSearchesNoResults.offset - Position of the first item to return.
+         * @param getSearchesNoResults.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -821,11 +962,13 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the latest update time of the Analytics API for an index. If the index has been recently created or no search has been performed yet, `updatedAt` will be `null`. > **Note**: The Analytics API is updated every 5 minutes.
+         * Retrieves the time when the Analytics data for the specified index was last updated.  The Analytics data is updated every 5 minutes.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get Analytics API status.
          * @param getStatus - The getStatus object.
-         * @param getStatus.index - Index name to target.
+         * @param getStatus.index - Index name.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getStatus({ index }, requestOptions) {
@@ -847,16 +990,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns top countries. Limited to the 1,000 most frequent ones.
+         * Retrieves the countries with the most searches to your index.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top countries.
          * @param getTopCountries - The getTopCountries object.
-         * @param getTopCountries.index - Index name to target.
-         * @param getTopCountries.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopCountries.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopCountries.limit - Number of records to return (page size).
-         * @param getTopCountries.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopCountries.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getTopCountries.index - Index name.
+         * @param getTopCountries.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopCountries.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopCountries.limit - Number of items to return.
+         * @param getTopCountries.offset - Position of the first item to return.
+         * @param getTopCountries.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -893,17 +1038,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the most popular [filterable attributes](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/) in the 1,000 most recently used filters.
+         * Retrieves the most frequently used filter attributes.  These are attributes of your records that you included in the `attributesForFaceting` setting.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top filterable attributes.
          * @param getTopFilterAttributes - The getTopFilterAttributes object.
-         * @param getTopFilterAttributes.index - Index name to target.
-         * @param getTopFilterAttributes.search - User query.
-         * @param getTopFilterAttributes.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFilterAttributes.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFilterAttributes.limit - Number of records to return (page size).
-         * @param getTopFilterAttributes.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopFilterAttributes.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getTopFilterAttributes.index - Index name.
+         * @param getTopFilterAttributes.search - Search query.
+         * @param getTopFilterAttributes.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFilterAttributes.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFilterAttributes.limit - Number of items to return.
+         * @param getTopFilterAttributes.offset - Position of the first item to return.
+         * @param getTopFilterAttributes.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -943,18 +1090,20 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
+         * Retrieves the most frequent filter (facet) values for a filter attribute.  These are attributes of your records that you included in the `attributesForFaceting` setting.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top filter values for an attribute.
          * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
          * @param getTopFilterForAttribute.attribute - Attribute name.
-         * @param getTopFilterForAttribute.index - Index name to target.
-         * @param getTopFilterForAttribute.search - User query.
-         * @param getTopFilterForAttribute.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFilterForAttribute.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFilterForAttribute.limit - Number of records to return (page size).
-         * @param getTopFilterForAttribute.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopFilterForAttribute.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getTopFilterForAttribute.index - Index name.
+         * @param getTopFilterForAttribute.search - Search query.
+         * @param getTopFilterForAttribute.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFilterForAttribute.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFilterForAttribute.limit - Number of items to return.
+         * @param getTopFilterForAttribute.offset - Position of the first item to return.
+         * @param getTopFilterForAttribute.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -997,17 +1146,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
+         * Retrieves the most frequently used filters for a search that didn\'t return any results.  To get the most frequent searches without results, use the [Retrieve searches without results](#tag/search/operation/getSearchesNoResults) operation.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top filters for a no result search.
          * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
-         * @param getTopFiltersNoResults.index - Index name to target.
-         * @param getTopFiltersNoResults.search - User query.
-         * @param getTopFiltersNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFiltersNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopFiltersNoResults.limit - Number of records to return (page size).
-         * @param getTopFiltersNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopFiltersNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getTopFiltersNoResults.index - Index name.
+         * @param getTopFiltersNoResults.search - Search query.
+         * @param getTopFiltersNoResults.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFiltersNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopFiltersNoResults.limit - Number of items to return.
+         * @param getTopFiltersNoResults.offset - Position of the first item to return.
+         * @param getTopFiltersNoResults.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1047,21 +1198,24 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the most popular clicked results in the last 1,000 searches.
+         * Retrieves the object IDs of the most frequent search results.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top hits.
          * @param getTopHits - The getTopHits object.
-         * @param getTopHits.index - Index name to target.
-         * @param getTopHits.search - User query.
-         * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
-         * @param getTopHits.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopHits.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopHits.limit - Number of records to return (page size).
-         * @param getTopHits.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopHits.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
-         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
-         */
-        getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
+         * @param getTopHits.index - Index name.
+         * @param getTopHits.search - Search query.
+         * @param getTopHits.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
+         * @param getTopHits.revenueAnalytics - Whether to include revenue-related metrics in the response.  If true, metrics related to click and conversion events are also included in the response.
+         * @param getTopHits.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopHits.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopHits.limit - Number of items to return.
+         * @param getTopHits.offset - Position of the first item to return.
+         * @param getTopHits.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
             if (!index) {
                 throw new Error('Parameter `index` is required when calling `getTopHits`.');
             }
@@ -1077,6 +1231,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (clickAnalytics !== undefined) {
                 queryParameters.clickAnalytics = clickAnalytics.toString();
             }
+            if (revenueAnalytics !== undefined) {
+                queryParameters.revenueAnalytics = revenueAnalytics.toString();
+            }
             if (startDate !== undefined) {
                 queryParameters.startDate = startDate.toString();
             }
@@ -1101,22 +1258,25 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
+         * Returns the most popular search terms.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get top searches.
          * @param getTopSearches - The getTopSearches object.
-         * @param getTopSearches.index - Index name to target.
-         * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
-         * @param getTopSearches.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopSearches.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getTopSearches.orderBy - Reorder the results.
+         * @param getTopSearches.index - Index name.
+         * @param getTopSearches.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
+         * @param getTopSearches.revenueAnalytics - Whether to include revenue-related metrics in the response.  If true, metrics related to click and conversion events are also included in the response.
+         * @param getTopSearches.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopSearches.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getTopSearches.orderBy - Attribute by which to order the response items.  If the `clickAnalytics` parameter is false, only `searchCount` is available.
          * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
-         * @param getTopSearches.limit - Number of records to return (page size).
-         * @param getTopSearches.offset - Position of the starting record. Used for paging. 0 is the first record.
-         * @param getTopSearches.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getTopSearches.limit - Number of items to return.
+         * @param getTopSearches.offset - Position of the first item to return.
+         * @param getTopSearches.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
+        getTopSearches({ index, clickAnalytics, revenueAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
             if (!index) {
                 throw new Error('Parameter `index` is required when calling `getTopSearches`.');
             }
@@ -1129,6 +1289,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (clickAnalytics !== undefined) {
                 queryParameters.clickAnalytics = clickAnalytics.toString();
             }
+            if (revenueAnalytics !== undefined) {
+                queryParameters.revenueAnalytics = revenueAnalytics.toString();
+            }
             if (startDate !== undefined) {
                 queryParameters.startDate = startDate.toString();
             }
@@ -1159,14 +1322,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return the count of unique users.
+         * Retrieves the number of unique users within a time range, including a daily breakdown.  Since this endpoint returns the number of unique users, the sum of the daily values might be different from the total number.  By default, Algolia distinguishes search users by their IP address, _unless_ you include a pseudonymous user identifier in your search requests with the `userToken` API parameter or `x-algolia-usertoken` request header. By default, the analyzed period includes the last eight days including the current day.
+         *
+         * Required API Key ACLs:
+         * - analytics.
          *
-         * @summary Get user count.
          * @param getUsersCount - The getUsersCount object.
-         * @param getUsersCount.index - Index name to target.
-         * @param getUsersCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getUsersCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
-         * @param getUsersCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
+         * @param getUsersCount.index - Index name.
+         * @param getUsersCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getUsersCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
+         * @param getUsersCount.tags - Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1200,7 +1365,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion$2 = '5.0.0-alpha.98';
+const apiClientVersion$2 = '5.0.0-beta.1';
 const REGIONS = ['eu', 'us'];
 function getDefaultHosts$1(region) {
     const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1260,7 +1425,6 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customDelete - The customDelete object.
          * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customDelete.parameters - Query parameters to apply to the current query.
@@ -1270,7 +1434,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -1284,7 +1448,6 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customGet - The customGet object.
          * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customGet.parameters - Query parameters to apply to the current query.
@@ -1294,7 +1457,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customGet`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -1308,7 +1471,6 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPost - The customPost object.
          * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPost.parameters - Query parameters to apply to the current query.
@@ -1319,7 +1481,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPost`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -1334,7 +1496,6 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPut - The customPut object.
          * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPut.parameters - Query parameters to apply to the current query.
@@ -1345,7 +1506,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPut`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -1358,11 +1519,13 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete the user profile and all its associated data.  Returns, as part of the response, a date until which the data can safely be considered as deleted for the given user. This means if you send events for the given user before this date, they will be ignored. Any data received after the deletedUntil date will start building a new user profile.  It might take a couple hours for the deletion request to be fully processed.
+         * Deletes a user profile.  The response includes a date and time when the user profile can safely be considered deleted.
+         *
+         * Required API Key ACLs:
+         * - recommendation.
          *
-         * @summary Delete a user profile.
          * @param deleteUserProfile - The deleteUserProfile object.
-         * @param deleteUserProfile.userToken - UserToken representing the user for which to fetch the Personalization profile.
+         * @param deleteUserProfile.userToken - Unique identifier representing a user for which to fetch the personalization profile.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteUserProfile({ userToken }, requestOptions) {
@@ -1381,9 +1544,11 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             return transporter.request(request, requestOptions);
         },
         /**
-         * The strategy contains information on the events and facets that impact user profiles and personalized search results.
+         * Retrieves the current personalization strategy.
+         *
+         * Required API Key ACLs:
+         * - recommendation.
          *
-         * @summary Get the current strategy.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getPersonalizationStrategy(requestOptions) {
@@ -1399,11 +1564,13 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the user profile built from Personalization strategy.  The profile is structured by facet name used in the strategy. Each facet value is mapped to its score. Each score represents the user affinity for a specific facet value given the userToken past events and the Personalization strategy defined. Scores are bounded to 20. The last processed event timestamp is provided using the ISO 8601 format for debugging purposes.
+         * Retrieves a user profile and their affinities for different facets.
+         *
+         * Required API Key ACLs:
+         * - recommendation.
          *
-         * @summary Get a user profile.
          * @param getUserTokenProfile - The getUserTokenProfile object.
-         * @param getUserTokenProfile.userToken - UserToken representing the user for which to fetch the Personalization profile.
+         * @param getUserTokenProfile.userToken - Unique identifier representing a user for which to fetch the personalization profile.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getUserTokenProfile({ userToken }, requestOptions) {
@@ -1422,9 +1589,11 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
             return transporter.request(request, requestOptions);
         },
         /**
-         * A strategy defines the events and facets that impact user profiles and personalized search results.
+         * Creates a new personalization strategy.
+         *
+         * Required API Key ACLs:
+         * - recommendation.
          *
-         * @summary Set a new strategy.
          * @param personalizationStrategyParams - The personalizationStrategyParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1457,7 +1626,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
 }
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion$1 = '5.0.0-alpha.98';
+const apiClientVersion$1 = '5.0.0-beta.1';
 function getDefaultHosts(appId) {
     return [
         {
@@ -1543,7 +1712,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for a task to be published (completed) for a given `indexName` and `taskID`.
          *
          * @summary Helper method that waits for a task to be published (completed).
-         * @param waitForTaskOptions - The waitForTaskOptions object.
+         * @param waitForTaskOptions - The `waitForTaskOptions` object.
          * @param waitForTaskOptions.indexName - The `indexName` where the operation was performed.
          * @param waitForTaskOptions.taskID - The `taskID` returned in the method response.
          * @param waitForTaskOptions.maxRetries - The maximum number of retries. 50 by default.
@@ -1567,7 +1736,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for an API key to be added, updated or deleted based on a given `operation`.
          *
          * @summary Helper method that waits for an API key task to be processed.
-         * @param waitForApiKeyOptions - The waitForApiKeyOptions object.
+         * @param waitForApiKeyOptions - The `waitForApiKeyOptions` object.
          * @param waitForApiKeyOptions.operation - The `operation` that was done on a `key`.
          * @param waitForApiKeyOptions.key - The `key` that has been added, deleted or updated.
          * @param waitForApiKeyOptions.apiKey - Necessary to know if an `update` operation has been processed, compare fields of the response with it.
@@ -1620,7 +1789,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `browse` method of the client to allow aggregating objects of an index.
          *
          * @summary Helper method that iterates on the `browse` method.
-         * @param browseObjects - The browseObjects object.
+         * @param browseObjects - The `browseObjects` object.
          * @param browseObjects.indexName - The index in which to perform the request.
          * @param browseObjects.browseParams - The `browse` parameters.
          * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is no `cursor` in the response.
@@ -1646,11 +1815,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchRules` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchRules` method.
-         * @param browseObjects - The browseObjects object.
-         * @param browseObjects.indexName - The index in which to perform the request.
-         * @param browseObjects.searchRulesParams - The `searchRules` method parameters.
-         * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is less hits returned than the number of maximum hits (1000).
-         * @param browseObjects.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
+         * @param browseRules - The `browseRules` object.
+         * @param browseRules.indexName - The index in which to perform the request.
+         * @param browseRules.searchRulesParams - The `searchRules` method parameters.
+         * @param browseRules.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is less hits returned than the number of maximum hits (1000).
+         * @param browseRules.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
          * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `searchRules` method and merged with the transporter requestOptions.
          */
         browseRules({ indexName, searchRulesParams, ...browseRulesOptions }, requestOptions) {
@@ -1678,11 +1847,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchSynonyms` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchSynonyms` method.
-         * @param browseObjects - The browseObjects object.
-         * @param browseObjects.indexName - The index in which to perform the request.
-         * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is less hits returned than the number of maximum hits (1000).
-         * @param browseObjects.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
-         * @param browseObjects.searchSynonymsParams - The `searchSynonyms` method parameters.
+         * @param browseSynonyms - The `browseSynonyms` object.
+         * @param browseSynonyms.indexName - The index in which to perform the request.
+         * @param browseSynonyms.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is less hits returned than the number of maximum hits (1000).
+         * @param browseSynonyms.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
+         * @param browseSynonyms.searchSynonymsParams - The `searchSynonyms` method parameters.
          * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `searchSynonyms` method and merged with the transporter requestOptions.
          */
         browseSynonyms({ indexName, searchSynonymsParams, ...browseSynonymsOptions }, requestOptions) {
@@ -1692,16 +1861,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                 hitsPerPage: 1000,
             };
             return clientCommon.createIterablePromise({
-                func: (previousResponse) => {
-                    return this.searchSynonyms({
+                func: (_) => {
+                    const resp = this.searchSynonyms({
                         indexName,
                         searchSynonymsParams: {
                             ...params,
-                            page: previousResponse
-                                ? previousResponse.page + 1
-                                : params.page,
+                            page: params.page,
                         },
                     }, requestOptions);
+                    params.page += 1;
+                    return resp;
                 },
                 validate: (response) => response.nbHits < params.hitsPerPage,
                 ...browseSynonymsOptions,
@@ -1730,9 +1899,76 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return this.search(searchMethodParams, requestOptions);
         },
         /**
-         * Add a new API key with specific permissions and restrictions. The request must be authenticated with the admin API key. The response returns an API key string.
+         * Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests.
+         *
+         * @summary Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests.
+         * @param chunkedBatch - The `chunkedBatch` object.
+         * @param chunkedBatch.indexName - The `indexName` to replace `objects` in.
+         * @param chunkedBatch.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param chunkedBatch.action - The `batch` `action` to perform on the given array of `objects`, defaults to `addObject`.
+         * @param chunkedBatch.waitForTasks - Whether or not we should wait until every `batch` tasks has been processed, this operation may slow the total execution time of this method but is more reliable.
+         * @param chunkedBatch.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `length(objects) / batchSize`. Defaults to 1000.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        async chunkedBatch({ indexName, objects, action = 'addObject', waitForTasks, batchSize = 1000, }, requestOptions) {
+            let requests = [];
+            const responses = [];
+            for (const [i, obj] of objects.entries()) {
+                requests.push({ action, body: obj });
+                if (i % batchSize === 0) {
+                    responses.push(await this.batch({ indexName, batchWriteParams: { requests } }, requestOptions));
+                    requests = [];
+                }
+            }
+            if (waitForTasks) {
+                for (const resp of responses) {
+                    await this.waitForTask({ indexName, taskID: resp.taskID });
+                }
+            }
+            return responses;
+        },
+        /**
+         * Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
+         *
+         * @summary Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
+         * @param replaceAllObjects - The `replaceAllObjects` object.
+         * @param replaceAllObjects.indexName - The `indexName` to replace `objects` in.
+         * @param replaceAllObjects.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param replaceAllObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `length(objects) / batchSize`. Defaults to 1000.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        async replaceAllObjects({ indexName, objects, batchSize }, requestOptions) {
+            const randomSuffix = Math.random().toString(36).substring(7);
+            const tmpIndexName = `${indexName}_tmp_${randomSuffix}`;
+            const copyOperationResponse = await this.operationIndex({
+                indexName,
+                operationIndexParams: {
+                    operation: 'copy',
+                    destination: tmpIndexName,
+                    scope: ['settings', 'rules', 'synonyms'],
+                },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName,
+                taskID: copyOperationResponse.taskID,
+            });
+            const batchResponses = await this.chunkedBatch({ indexName: tmpIndexName, objects, waitForTasks: true, batchSize }, requestOptions);
+            const moveOperationResponse = await this.operationIndex({
+                indexName: tmpIndexName,
+                operationIndexParams: { operation: 'move', destination: indexName },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName,
+                taskID: moveOperationResponse.taskID,
+            });
+            return { copyOperationResponse, batchResponses, moveOperationResponse };
+        },
+        /**
+         * Creates a new API key with specific permissions and restrictions.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Add API key.
          * @param apiKey - The apiKey object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1756,13 +1992,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * If you use an existing `objectID`, the existing record will be replaced with the new one.  To update only some attributes of an existing record, use the [`partial` operation](#tag/Records/operation/partialUpdateObject) instead.  To add multiple records to your index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
+         * If a record with the specified object ID exists, the existing record is replaced. Otherwise, a new record is added to the index.  To update _some_ attributes of an existing record, use the [`partial` operation](#tag/Records/operation/partialUpdateObject) instead. To add, update, or replace multiple records, use the [`batch` operation](#tag/Records/operation/batch).
+         *
+         * Required API Key ACLs:
+         * - addObject.
          *
-         * @summary Add or update a record (using objectID).
          * @param addOrUpdateObject - The addOrUpdateObject object.
-         * @param addOrUpdateObject.indexName - Index on which to perform the request.
-         * @param addOrUpdateObject.objectID - Unique record (object) identifier.
-         * @param addOrUpdateObject.body - Algolia record.
+         * @param addOrUpdateObject.indexName - Name of the index on which to perform the operation.
+         * @param addOrUpdateObject.objectID - Unique record identifier.
+         * @param addOrUpdateObject.body - The record, a schemaless object with attributes that are useful in the context of search and discovery.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -1790,9 +2028,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Add a source to the list of allowed sources.
+         * Adds a source to the list of allowed sources.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Add a source.
          * @param source - Source to add.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1816,11 +2056,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Assign or move a user ID to a cluster. The time it takes to move a user is proportional to the amount of data linked to the user ID.
+         * Assigns or moves a user ID to a cluster.  The time it takes to move a user is proportional to the amount of data linked to the user ID.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Assign or move a user ID.
          * @param assignUserId - The assignUserId object.
-         * @param assignUserId.xAlgoliaUserID - UserID to assign.
+         * @param assignUserId.xAlgoliaUserID - Unique identifier of the user who makes the search request.
          * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1850,11 +2092,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * To reduce the time spent on network round trips, you can perform several write actions in a single API call. Actions are applied in the order they are specified. The supported `action`s are equivalent to the individual operations of the same name.
+         * Adds, updates, or deletes records in one index with a single API request.  Batching index updates reduces latency and increases data integrity.  - Actions are applied in the order they\'re specified. - Actions are equivalent to the individual API requests of the same name.
          *
-         * @summary Batch write operations on one index.
          * @param batch - The batch object.
-         * @param batch.indexName - Index on which to perform the request.
+         * @param batch.indexName - Name of the index on which to perform the operation.
          * @param batch.batchWriteParams - The batchWriteParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1881,11 +2122,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
+         * Assigns multiple user IDs to a cluster.  **You can\'t move users with this operation**.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Batch assign userIDs.
          * @param batchAssignUserIds - The batchAssignUserIds object.
-         * @param batchAssignUserIds.xAlgoliaUserID - UserID to assign.
+         * @param batchAssignUserIds.xAlgoliaUserID - Unique identifier of the user who makes the search request.
          * @param batchAssignUserIds.batchAssignUserIdsParams - The batchAssignUserIdsParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1918,11 +2161,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Add or remove a batch of dictionary entries.
+         * Adds or deletes multiple entries from your plurals, segmentation, or stop word dictionaries.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Batch dictionary entries.
          * @param batchDictionaryEntries - The batchDictionaryEntries object.
-         * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
+         * @param batchDictionaryEntries.dictionaryName - Dictionary type in which to search.
          * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1949,11 +2194,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Retrieve up to 1,000 records per call. Supports full-text search and filters. For better performance, it doesn\'t support: - The `distinct` query parameter - Sorting by typos, proximity, words, or geographical distance.
+         * Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn\'t collect data when using `browse`. - Records are ranked by attributes and custom ranking. - Deduplication (`distinct`) is turned off. - There\'s no ranking for: typo-tolerance, number of matched words, proximity, geo distance.
+         *
+         * Required API Key ACLs:
+         * - browse.
          *
-         * @summary Get all records from an index.
          * @param browse - The browse object.
-         * @param browse.indexName - Index on which to perform the request.
+         * @param browse.indexName - Name of the index on which to perform the operation.
          * @param browse.browseParams - The browseParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1974,11 +2221,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete the records but leave settings and index-specific API keys untouched.
+         * Deletes only the records from an index while keeping settings, synonyms, and rules.
+         *
+         * Required API Key ACLs:
+         * - deleteIndex.
          *
-         * @summary Delete all records from an index.
          * @param clearObjects - The clearObjects object.
-         * @param clearObjects.indexName - Index on which to perform the request.
+         * @param clearObjects.indexName - Name of the index on which to perform the operation.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         clearObjects({ indexName }, requestOptions) {
@@ -1997,12 +2246,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete all rules in the index.
+         * Deletes all rules from the index.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Delete all rules.
          * @param clearRules - The clearRules object.
-         * @param clearRules.indexName - Index on which to perform the request.
-         * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param clearRules.indexName - Name of the index on which to perform the operation.
+         * @param clearRules.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -2024,12 +2275,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete all synonyms in the index.
+         * Deletes all synonyms from the index.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Delete all synonyms.
          * @param clearSynonyms - The clearSynonyms object.
-         * @param clearSynonyms.indexName - Index on which to perform the request.
-         * @param clearSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param clearSynonyms.indexName - Name of the index on which to perform the operation.
+         * @param clearSynonyms.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         clearSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -2053,7 +2306,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customDelete - The customDelete object.
          * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customDelete.parameters - Query parameters to apply to the current query.
@@ -2063,7 +2315,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -2077,7 +2329,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customGet - The customGet object.
          * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customGet.parameters - Query parameters to apply to the current query.
@@ -2087,7 +2338,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customGet`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -2101,7 +2352,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPost - The customPost object.
          * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPost.parameters - Query parameters to apply to the current query.
@@ -2112,7 +2362,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPost`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -2127,7 +2377,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         /**
          * This method allow you to send requests to the Algolia REST API.
          *
-         * @summary Send requests to the Algolia REST API.
          * @param customPut - The customPut object.
          * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
          * @param customPut.parameters - Query parameters to apply to the current query.
@@ -2138,7 +2387,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPut`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -2151,9 +2400,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete an existing API key. The request must be authenticated with the admin API key.
+         * Deletes the API key.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Delete API key.
          * @param deleteApiKey - The deleteApiKey object.
          * @param deleteApiKey.key - API key.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2174,11 +2425,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * This operation doesn\'t support all the query options, only its filters (numeric, facet, or tag) and geo queries. It doesn\'t accept empty filters or queries.
+         * This operation doesn\'t accept empty queries or filters.  It\'s more efficient to get a list of object IDs with the [`browse` operation](#tag/Search/operation/browse), and then delete the records using the [`batch` operation](tag/Records/operation/batch).
+         *
+         * Required API Key ACLs:
+         * - deleteIndex.
          *
-         * @summary Delete all records matching a query.
          * @param deleteBy - The deleteBy object.
-         * @param deleteBy.indexName - Index on which to perform the request.
+         * @param deleteBy.indexName - Name of the index on which to perform the operation.
          * @param deleteBy.deleteByParams - The deleteByParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2202,11 +2455,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete an existing index.
+         * Deletes an index and all its settings.  - Deleting an index doesn\'t delete its analytics data. - If you try to delete a non-existing index, the operation is ignored without warning. - If the index you want to delete has replica indices, the replicas become independent indices. - If the index you want to delete is a replica index, you must first unlink it from its primary index before you can delete it.   For more information, see [Delete replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/deleting-replicas/).
+         *
+         * Required API Key ACLs:
+         * - deleteIndex.
          *
-         * @summary Delete index.
          * @param deleteIndex - The deleteIndex object.
-         * @param deleteIndex.indexName - Index on which to perform the request.
+         * @param deleteIndex.indexName - Name of the index on which to perform the operation.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteIndex({ indexName }, requestOptions) {
@@ -2225,12 +2480,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
+         * Deletes a record by its object ID.  To delete more than one record, use the [`batch` operation](#tag/Records/operation/batch). To delete records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy).
+         *
+         * Required API Key ACLs:
+         * - deleteObject.
          *
-         * @summary Delete a record.
          * @param deleteObject - The deleteObject object.
-         * @param deleteObject.indexName - Index on which to perform the request.
-         * @param deleteObject.objectID - Unique record (object) identifier.
+         * @param deleteObject.indexName - Name of the index on which to perform the operation.
+         * @param deleteObject.objectID - Unique record identifier.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteObject({ indexName, objectID }, requestOptions) {
@@ -2254,13 +2511,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
+         * Deletes a rule by its ID. To find the object ID for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Delete a rule.
          * @param deleteRule - The deleteRule object.
-         * @param deleteRule.indexName - Index on which to perform the request.
+         * @param deleteRule.indexName - Name of the index on which to perform the operation.
          * @param deleteRule.objectID - Unique identifier of a rule object.
-         * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param deleteRule.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2287,9 +2546,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Remove a source from the list of allowed sources.
+         * Deletes a source from the list of allowed sources.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Remove a source.
          * @param deleteSource - The deleteSource object.
          * @param deleteSource.source - IP address range of the source.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2310,13 +2571,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
+         * Deletes a synonym by its ID. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Delete a synonym.
          * @param deleteSynonym - The deleteSynonym object.
-         * @param deleteSynonym.indexName - Index on which to perform the request.
+         * @param deleteSynonym.indexName - Name of the index on which to perform the operation.
          * @param deleteSynonym.objectID - Unique identifier of a synonym object.
-         * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param deleteSynonym.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2343,9 +2606,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the permissions and restrictions of a specific API key. When authenticating with the admin API key, you can request information for any of your application\'s keys. When authenticating with other API keys, you can only retrieve information for that key.
+         * Gets the permissions and restrictions of an API key.  When authenticating with the admin API key, you can request information for any of your application\'s keys. When authenticating with other API keys, you can only retrieve information for that key.
          *
-         * @summary Get API key permissions.
          * @param getApiKey - The getApiKey object.
          * @param getApiKey.key - API key.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2366,9 +2628,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Lists Algolia\'s [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/) and any customizations applied to each language\'s [stop word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/), [plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/), and [segmentation (compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/) features.
+         * Lists supported languages with their supported dictionary types and number of custom entries.
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary List available languages.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getDictionaryLanguages(requestOptions) {
@@ -2384,9 +2648,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
+         * Retrieves the languages for which standard dictionary entries are turned off.
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Get stop word settings.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getDictionarySettings(requestOptions) {
@@ -2402,14 +2668,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * The request must be authenticated by an API key with the [`logs` ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are held for the last seven days. There\'s also a logging limit of 1,000 API calls per server. This request counts towards your [operations quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-) but doesn\'t appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search Network (DSN) cluster, target the [DSN\'s endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
+         * The request must be authenticated by an API key with the [`logs` ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl).  - Logs are held for the last seven days. - Up to 1,000 API requests per server are logged. - This request counts towards your [operations quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-) but doesn\'t appear in the logs itself.
+         *
+         * Required API Key ACLs:
+         * - logs.
          *
-         * @summary Return the latest log entries.
          * @param getLogs - The getLogs object.
-         * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
+         * @param getLogs.offset - First log entry to retrieve. The most recent entries are listed first.
          * @param getLogs.length - Maximum number of entries to retrieve.
-         * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
-         * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
+         * @param getLogs.indexName - Index for which to retrieve log entries. By default, log entries are retrieved for all indices.
+         * @param getLogs.type - Type of log entries to retrieve. By default, all log entries are retrieved.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getLogs({ offset, length, indexName, type } = {}, requestOptions = undefined) {
@@ -2437,13 +2705,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
+         * Retrieves one record by its object ID.  To retrieve more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
+         *
+         * Required API Key ACLs:
+         * - search.
          *
-         * @summary Get a record.
          * @param getObject - The getObject object.
-         * @param getObject.indexName - Index on which to perform the request.
-         * @param getObject.objectID - Unique record (object) identifier.
-         * @param getObject.attributesToRetrieve - Attributes to include with the records in the response. This is useful to reduce the size of the API response. By default, all retrievable attributes are returned. `objectID` is always retrieved, even when not specified. [`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/) won\'t be retrieved unless the request is authenticated with the admin API key.
+         * @param getObject.indexName - Name of the index on which to perform the operation.
+         * @param getObject.objectID - Unique record identifier.
+         * @param getObject.attributesToRetrieve - Attributes to include with the records in the response. This is useful to reduce the size of the API response. By default, all retrievable attributes are returned.  `objectID` is always retrieved.  Attributes included in `unretrievableAttributes` won\'t be retrieved unless the request is authenticated with the admin API key.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -2470,9 +2740,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Retrieve one or more records, potentially from different indices, in a single API operation. Results will be received in the same order as the requests.
+         * Retrieves one or more records, potentially from different indices.  Records are returned in the same order as the requests.
+         *
+         * Required API Key ACLs:
+         * - search.
          *
-         * @summary Get multiple records.
          * @param getObjectsParams - Request object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2498,11 +2770,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
+         * Retrieves a rule by its ID. To find the object ID of rules, use the [`search` operation](#tag/Rules/operation/searchRules).
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Get a rule.
          * @param getRule - The getRule object.
-         * @param getRule.indexName - Index on which to perform the request.
+         * @param getRule.indexName - Name of the index on which to perform the operation.
          * @param getRule.objectID - Unique identifier of a rule object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2527,11 +2801,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
+         * Retrieves an object with non-null index settings.
+         *
+         * Required API Key ACLs:
+         * - search.
          *
-         * @summary Get index settings.
          * @param getSettings - The getSettings object.
-         * @param getSettings.indexName - Index on which to perform the request.
+         * @param getSettings.indexName - Name of the index on which to perform the operation.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSettings({ indexName }, requestOptions) {
@@ -2550,9 +2826,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get all allowed sources (IP addresses).
+         * Retrieves all allowed IP addresses with access to your application.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Get all allowed IP addresses.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSources(requestOptions) {
@@ -2568,11 +2846,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
+         * Retrieves a syonym by its ID. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Get a synonym object.
          * @param getSynonym - The getSynonym object.
-         * @param getSynonym.indexName - Index on which to perform the request.
+         * @param getSynonym.indexName - Name of the index on which to perform the operation.
          * @param getSynonym.objectID - Unique identifier of a synonym object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2597,11 +2877,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
+         * Checks the status of a given task.  Indexing tasks are asynchronous. When you add, update, or delete records or indices, a task is created on a queue and completed depending on the load on the server.  The indexing tasks\' responses include a task ID that you can use to check the status.
+         *
+         * Required API Key ACLs:
+         * - addObject.
          *
-         * @summary Check a task\'s status.
          * @param getTask - The getTask object.
-         * @param getTask.indexName - Index on which to perform the request.
+         * @param getTask.indexName - Name of the index on which to perform the operation.
          * @param getTask.taskID - Unique task identifier.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2626,9 +2908,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the IDs of the 10 users with the highest number of records per cluster. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         * Get the IDs of the 10 users with the highest number of records per cluster.  Since it can take a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Get top userID.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTopUserIds(requestOptions) {
@@ -2644,11 +2928,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Returns the userID data stored in the mapping. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         * Returns the user ID data stored in the mapping.  Since it can take a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Get userID.
          * @param getUserId - The getUserId object.
-         * @param getUserId.userID - UserID to assign.
+         * @param getUserId.userID - Unique identifier of the user who makes the search request.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getUserId({ userID }, requestOptions) {
@@ -2669,9 +2955,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         /**
          * To determine when the time-consuming process of creating a large batch of users or migrating users from one cluster to another is complete, this operation retrieves the status of the process.
          *
-         * @summary Get migration and user mapping status.
+         * Required API Key ACLs:
+         * - admin.
+         *
          * @param hasPendingMappings - The hasPendingMappings object.
-         * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
+         * @param hasPendingMappings.getClusters - Whether to include the cluster\'s pending mapping state in the response.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -2690,9 +2978,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * List all API keys associated with your Algolia application, including their permissions and restrictions.
+         * Lists all API keys associated with your Algolia application, including their permissions and restrictions.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary List API keys.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         listApiKeys(requestOptions) {
@@ -2708,9 +2998,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * List the available clusters in a multi-cluster setup.
+         * Lists the available clusters in a multi-cluster setup.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary List clusters.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         listClusters(requestOptions) {
@@ -2726,12 +3018,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * List indices in an Algolia application.
+         * Lists all indices in the current Algolia application.  The request follows any index restrictions of the API key you use to make the request.
+         *
+         * Required API Key ACLs:
+         * - listIndexes.
          *
-         * @summary List indices.
          * @param listIndices - The listIndices object.
-         * @param listIndices.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
-         * @param listIndices.hitsPerPage - Maximum number of hits per page.
+         * @param listIndices.page - Requested page of the API response. If `null`, the API response is not paginated.
+         * @param listIndices.hitsPerPage - Number of hits per page.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -2753,12 +3047,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         * Lists the userIDs assigned to a multi-cluster application.  Since it can take a few seconds to get the data from the different clusters, the response isn\'t real-time.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary List userIDs.
          * @param listUserIds - The listUserIds object.
-         * @param listUserIds.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
-         * @param listUserIds.hitsPerPage - Maximum number of hits per page.
+         * @param listUserIds.page - Requested page of the API response. If `null`, the API response is not paginated.
+         * @param listUserIds.hitsPerPage - Number of hits per page.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -2780,9 +3076,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * To reduce the time spent on network round trips, you can perform several write actions in a single request. It\'s a multi-index version of the [`batch` operation](#tag/Records/operation/batch). Actions are applied in the order they are specified. The supported actions are equivalent to the individual operations of the same name.
+         * Adds, updates, or deletes records in multiple indices with a single API request.  - Actions are applied in the order they are specified. - Actions are equivalent to the individual API requests of the same name.
          *
-         * @summary Batch write operations on multiple indices.
          * @param batchParams - The batchParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2806,11 +3101,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * This `operation`, _copy_ or _move_, will copy or move a source index\'s (`IndexName`) records, settings, synonyms, and rules to a `destination` index. If the destination index exists, it will be replaced, except for index-specific API keys and analytics data. If the destination index doesn\'t exist, it will be created.  The choice between moving or copying an index depends on your needs. Choose:  - **Move** to rename an index. - **Copy** to create a new index with the same records and configuration as an existing one.  > **Note**: When considering copying or moving, be aware of the [rate limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits) on these processes and the [impact on your analytics data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
+         * Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for index-specific API keys and analytics data. - If the destination index doesn\'t exist yet, it\'ll be created.  **Copy**  - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
+         *
+         * Required API Key ACLs:
+         * - addObject.
          *
-         * @summary Copy, move, or rename an index.
          * @param operationIndex - The operationIndex object.
-         * @param operationIndex.indexName - Index on which to perform the request.
+         * @param operationIndex.indexName - Name of the index on which to perform the operation.
          * @param operationIndex.operationIndexParams - The operationIndexParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -2840,14 +3137,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Add new attributes or update current ones in an existing record. You can use any first-level attribute but not nested attributes. If you specify a [nested attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/), the engine treats it as a replacement for its first-level ancestor.
+         * Adds new attributes to a record, or update existing ones.  - If a record with the specified object ID doesn\'t exist,   a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn\'t exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes.   If you specify a nested attribute, the engine treats it as a replacement for its first-level ancestor.
+         *
+         * Required API Key ACLs:
+         * - addObject.
          *
-         * @summary Update record attributes.
          * @param partialUpdateObject - The partialUpdateObject object.
-         * @param partialUpdateObject.indexName - Index on which to perform the request.
-         * @param partialUpdateObject.objectID - Unique record (object) identifier.
-         * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
-         * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
+         * @param partialUpdateObject.indexName - Name of the index on which to perform the operation.
+         * @param partialUpdateObject.objectID - Unique record identifier.
+         * @param partialUpdateObject.attributesToUpdate - Attributes with their values.
+         * @param partialUpdateObject.createIfNotExists - Whether to create a new record if it doesn\'t exist.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -2878,11 +3177,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Remove a userID and its associated data from the multi-clusters.
+         * Deletes a user ID and its associated data from the clusters.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Remove userID.
          * @param removeUserId - The removeUserId object.
-         * @param removeUserId.userID - UserID to assign.
+         * @param removeUserId.userID - Unique identifier of the user who makes the search request.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         removeUserId({ userID }, requestOptions) {
@@ -2901,9 +3202,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Replace all allowed sources.
+         * Replaces the list of allowed sources.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Replace all sources.
          * @param replaceSources - The replaceSources object.
          * @param replaceSources.source - Allowed sources.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2925,9 +3228,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
+         * Restores a deleted API key.  Restoring resets the `validity` attribute to `0`.  Algolia stores up to 1,000 API keys per application. If you create more, the oldest API keys are deleted and can\'t be restored.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Restore API key.
          * @param restoreApiKey - The restoreApiKey object.
          * @param restoreApiKey.key - API key.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2948,12 +3253,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Add a record (object) to an index or replace it. If the record doesn\'t contain an `objectID`, Algolia automatically adds it. If you use an existing `objectID`, the existing record is replaced with the new one. To add multiple records to your index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
+         * Adds a record to an index or replace it.  - If the record doesn\'t have an object ID, a new record with an auto-generated object ID is added to your index. - If a record with the specified object ID exists, the existing record is replaced. - If a record with the specified object ID doesn\'t exist, a new record is added to your index. - If you add a record to an index that doesn\'t exist yet, a new index is created.  To update _some_ attributes of a record, use the [`partial` operation](#tag/Records/operation/partial). To add, update, or replace multiple records, use the [`batch` operation](#tag/Records/operation/batch).
+         *
+         * Required API Key ACLs:
+         * - addObject.
          *
-         * @summary Add or update a record.
          * @param saveObject - The saveObject object.
-         * @param saveObject.indexName - Index on which to perform the request.
-         * @param saveObject.body - The Algolia record.
+         * @param saveObject.indexName - Name of the index on which to perform the operation.
+         * @param saveObject.body - The record, a schemaless object with attributes that are useful in the context of search and discovery.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         saveObject({ indexName, body }, requestOptions) {
@@ -2976,14 +3283,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
+         * If a rule with the specified object ID doesn\'t exist, it\'s created. Otherwise, the existing rule is replaced.  To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Create or update a rule.
          * @param saveRule - The saveRule object.
-         * @param saveRule.indexName - Index on which to perform the request.
+         * @param saveRule.indexName - Name of the index on which to perform the operation.
          * @param saveRule.objectID - Unique identifier of a rule object.
          * @param saveRule.rule - The rule object.
-         * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param saveRule.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -3017,14 +3326,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Create or update multiple rules.
+         * Create or update multiple rules.  If a rule with the specified object ID doesn\'t exist, Algolia creates a new one. Otherwise, existing rules are replaced.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Save a batch of rules.
          * @param saveRules - The saveRules object.
-         * @param saveRules.indexName - Index on which to perform the request.
+         * @param saveRules.indexName - Name of the index on which to perform the operation.
          * @param saveRules.rules - The rules object.
-         * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
-         * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
+         * @param saveRules.forwardToReplicas - Whether changes are applied to replica indices.
+         * @param saveRules.clearExistingRules - Whether existing rules should be deleted before adding this batch.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -3053,14 +3364,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Add a [synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms) to an index or replace it. If the synonym `objectID` doesn\'t exist, Algolia adds a new one. If you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To add multiple synonyms in a single API request, use the [`batch` operation](#tag/Synonyms/operation/saveSynonyms).
+         * If a synonym with the specified object ID doesn\'t exist, Algolia adds a new one. Otherwise, the existing synonym is replaced. To add multiple synonyms in a single API request, use the [`batch` operation](#tag/Synonyms/operation/saveSynonyms).
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Save a synonym.
          * @param saveSynonym - The saveSynonym object.
-         * @param saveSynonym.indexName - Index on which to perform the request.
+         * @param saveSynonym.indexName - Name of the index on which to perform the operation.
          * @param saveSynonym.objectID - Unique identifier of a synonym object.
          * @param saveSynonym.synonymHit - The synonymHit object.
-         * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param saveSynonym.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -3097,14 +3410,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Create or update multiple synonyms.
+         * If a synonym with the `objectID` doesn\'t exist, Algolia adds a new one. Otherwise, existing synonyms are replaced.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Save a batch of synonyms.
          * @param saveSynonyms - The saveSynonyms object.
-         * @param saveSynonyms.indexName - Index on which to perform the request.
+         * @param saveSynonyms.indexName - Name of the index on which to perform the operation.
          * @param saveSynonyms.synonymHit - The synonymHit object.
-         * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
-         * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
+         * @param saveSynonyms.forwardToReplicas - Whether changes are applied to replica indices.
+         * @param saveSynonyms.replaceExistingSynonyms - Whether to replace all synonyms in the index with the ones sent with this request.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -3134,10 +3449,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Send multiple search queries to one or more indices.
+         * Sends multiple search request to one or more indices.  This can be useful in these cases:  - Different indices for different purposes, such as, one index for products, another one for marketing content. - Multiple searches to the same index—for example, with different filters.
          *
-         * @summary Search multiple indices.
-         * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
+         * Required API Key ACLs:
+         * - search.
+         *
+         * @param searchMethodParams - Muli-search request body. Results are returned in the same order as the requests.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         search(searchMethodParams, requestOptions) {
@@ -3184,11 +3501,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search for standard and [custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/) entries in the [stop words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/), [plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/), or [segmentation (compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/) dictionaries.
+         * Searches for standard and custom dictionary entries.
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Search dictionary entries.
          * @param searchDictionaryEntries - The searchDictionaryEntries object.
-         * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
+         * @param searchDictionaryEntries.dictionaryName - Dictionary type in which to search.
          * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3217,12 +3536,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * [Search for a facet\'s values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values), optionally restricting the returned values to those contained in records matching other search criteria. > **Note**: Pagination isn\'t supported (`page` and `hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
+         * Searches for values of a specified facet attribute.  - By default, facet values are sorted by decreasing count.   You can adjust this with the `sortFacetValueBy` parameter. - Searching for facet values doesn\'t work if you have **more than 65 searchable facets and searchable attributes combined**.
+         *
+         * Required API Key ACLs:
+         * - search.
          *
-         * @summary Search for facet values.
          * @param searchForFacetValues - The searchForFacetValues object.
-         * @param searchForFacetValues.indexName - Index on which to perform the request.
-         * @param searchForFacetValues.facetName - Facet name.
+         * @param searchForFacetValues.indexName - Name of the index on which to perform the operation.
+         * @param searchForFacetValues.facetName - Facet attribute in which to search for values.  This attribute must be included in the `attributesForFaceting` index setting with the `searchable()` modifier.
          * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3250,11 +3571,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
+         * Searches for rules in your index.
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Search for rules.
          * @param searchRules - The searchRules object.
-         * @param searchRules.indexName - Index on which to perform the request.
+         * @param searchRules.indexName - Name of the index on which to perform the operation.
          * @param searchRules.searchRulesParams - The searchRulesParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3277,11 +3600,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Return records that match the query.
+         * Searches a single index and return matching search results (_hits_).  This method lets you retrieve up to 1,000 hits. If you need more, use the [`browse` operation](#tag/Search/operation/browse) or increase the `paginatedLimitedTo` index setting.
+         *
+         * Required API Key ACLs:
+         * - search.
          *
-         * @summary Search an index.
          * @param searchSingleIndex - The searchSingleIndex object.
-         * @param searchSingleIndex.indexName - Index on which to perform the request.
+         * @param searchSingleIndex.indexName - Name of the index on which to perform the operation.
          * @param searchSingleIndex.searchParams - The searchParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3304,11 +3629,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
+         * Searches for synonyms in your index.
+         *
+         * Required API Key ACLs:
+         * - settings.
          *
-         * @summary Search for synonyms.
          * @param searchSynonyms - The searchSynonyms object.
-         * @param searchSynonyms.indexName - Index on which to perform the request.
+         * @param searchSynonyms.indexName - Name of the index on which to perform the operation.
          * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3331,9 +3658,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time. To ensure rapid updates, the user IDs index isn\'t built at the same time as the mapping. Instead, it\'s built every 12 hours, at the same time as the update of user ID usage. For example, if you add or move a user ID, the search will show an old value until the next time the mapping is rebuilt (every 12 hours).
+         * Since it can take a few seconds to get the data from the different clusters, the response isn\'t real-time.  To ensure rapid updates, the user IDs index isn\'t built at the same time as the mapping. Instead, it\'s built every 12 hours, at the same time as the update of user ID usage. For example, if you add or move a user ID, the search will show an old value until the next time the mapping is rebuilt (every 12 hours).
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Search for a user ID.
          * @param searchUserIdsParams - The searchUserIdsParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3359,9 +3688,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Set stop word settings for a specific language.
+         * Turns standard stop word dictionary entries on or off for a given language.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Set stop word settings.
          * @param dictionarySettingsParams - The dictionarySettingsParams object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -3385,13 +3716,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Update the specified [index settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null for a setting resets it to its default value.
+         * Update the specified index settings.  Index settings that you don\'t specify are left unchanged. Specify `null` to reset a setting to its default value.  For best performance, update the index settings before you add new records to your index.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
          *
-         * @summary Update index settings.
          * @param setSettings - The setSettings object.
-         * @param setSettings.indexName - Index on which to perform the request.
+         * @param setSettings.indexName - Name of the index on which to perform the operation.
          * @param setSettings.indexSettings - The indexSettings object.
-         * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @param setSettings.forwardToReplicas - Whether changes are applied to replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -3417,9 +3750,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Replace the permissions of an existing API key. Any unspecified parameter resets that permission to its default value. The request must be authenticated with the admin API key.
+         * Replaces the permissions of an existing API key.  Any unspecified attribute resets that attribute to its default value.
+         *
+         * Required API Key ACLs:
+         * - admin.
          *
-         * @summary Update an API key.
          * @param updateApiKey - The updateApiKey object.
          * @param updateApiKey.key - API key.
          * @param updateApiKey.apiKey - The apiKey object.
@@ -3523,6 +3858,36 @@ function algoliasearch(appId, apiKey, options) {
         initAnalytics,
         initPersonalization,
         initAbtesting,
+        /**
+         * Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         *
+         * @summary Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         * @param generateSecuredApiKey - The `generateSecuredApiKey` object.
+         * @param generateSecuredApiKey.parentApiKey - The base API key from which to generate the new secured one.
+         * @param generateSecuredApiKey.restrictions - A set of properties defining the restrictions of the secured API key.
+         */
+        generateSecuredApiKey({ parentApiKey, restrictions = {}, }) {
+            const queryParameters = clientCommon.serializeQueryParameters(restrictions);
+            return Buffer.from(crypto.createHmac('sha256', parentApiKey)
+                .update(queryParameters)
+                .digest('hex') + queryParameters).toString('base64');
+        },
+        /**
+         * Helper: Retrieves the remaining validity of the previous generated `securedApiKey`, the `ValidUntil` parameter must have been provided.
+         *
+         * @summary Helper: Retrieves the remaining validity of the previous generated `secured_api_key`, the `ValidUntil` parameter must have been provided.
+         * @param getSecuredApiKeyRemainingValidity - The `getSecuredApiKeyRemainingValidity` object.
+         * @param getSecuredApiKeyRemainingValidity.securedApiKey - The secured API key generated with the `generateSecuredApiKey` method.
+         */
+        getSecuredApiKeyRemainingValidity({ securedApiKey, }) {
+            const decodedString = Buffer.from(securedApiKey, 'base64').toString('ascii');
+            const regex = /validUntil=(\d+)/;
+            const match = decodedString.match(regex);
+            if (match === null) {
+                throw new Error('validUntil not found in given secured api key.');
+            }
+            return parseInt(match[1], 10) - Math.round(new Date().getTime() / 1000);
+        },
     };
 }