algolia 3.0.0.alpha.12 → 3.0.0.alpha.13

data/lib/algolia/api/search_client.rb

@@ -29,7 +29,7 @@ module Algolia
       new(config)
     end
 
-    # 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.
+    # Creates a new API key with specific permissions and restrictions.
     #
     # Required API Key ACLs:
     #   - admin
@@ -61,7 +61,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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.
+    # Creates a new API key with specific permissions and restrictions.
     #
     # Required API Key ACLs:
     #   - admin
@@ -73,13 +73,13 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::AddApiKeyResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param body [Object] Algolia record. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def add_or_update_object_with_http_info(index_name, object_id, body, request_options = {})
@@ -116,13 +116,13 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param body [Object] Algolia record. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtWithObjectIdResponse]
     def add_or_update_object(index_name, object_id, body, request_options = {})
@@ -130,7 +130,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtWithObjectIdResponse')
     end
 
-    # Add a source to the list of allowed sources.
+    # Adds a source to the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -162,7 +162,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Add a source to the list of allowed sources.
+    # Adds a source to the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -174,11 +174,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::CreatedAtResponse')
     end
 
-    # 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
-    # @param x_algolia_user_id [String] userID to assign. (required)
+    # @param x_algolia_user_id [String] User ID to assign. (required)
     # @param assign_user_id_params [AssignUserIdParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -218,11 +218,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param x_algolia_user_id [String] userID to assign. (required)
+    # @param x_algolia_user_id [String] User ID to assign. (required)
     # @param assign_user_id_params [AssignUserIdParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [CreatedAtResponse]
@@ -231,9 +231,9 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::CreatedAtResponse')
     end
 
-    # 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.
 
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param batch_write_params [BatchWriteParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -266,9 +266,9 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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.
 
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param batch_write_params [BatchWriteParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [BatchResponse]
@@ -277,11 +277,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::BatchResponse')
     end
 
-    # 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
-    # @param x_algolia_user_id [String] userID to assign. (required)
+    # @param x_algolia_user_id [String] User ID to assign. (required)
     # @param batch_assign_user_ids_params [BatchAssignUserIdsParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -321,11 +321,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param x_algolia_user_id [String] userID to assign. (required)
+    # @param x_algolia_user_id [String] User ID to assign. (required)
     # @param batch_assign_user_ids_params [BatchAssignUserIdsParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [CreatedAtResponse]
@@ -334,11 +334,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::CreatedAtResponse')
     end
 
-    # 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
-    # @param dictionary_name [DictionaryType] Dictionary to search in. (required)
+    # @param dictionary_name [DictionaryType] Dictionary type in which to search. (required)
     # @param batch_dictionary_entries_params [BatchDictionaryEntriesParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -371,11 +371,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param dictionary_name [DictionaryType] Dictionary to search in. (required)
+    # @param dictionary_name [DictionaryType] Dictionary type in which to search. (required)
     # @param batch_dictionary_entries_params [BatchDictionaryEntriesParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
@@ -384,11 +384,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param browse_params [BrowseParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -417,11 +417,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param browse_params [BrowseParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [BrowseResponse]
@@ -430,11 +430,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::BrowseResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def clear_objects_with_http_info(index_name, request_options = {})
@@ -462,11 +462,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def clear_objects(index_name, request_options = {})
@@ -474,12 +474,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # Delete all rules in the index.
+    # Deletes all rules from the index.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def clear_rules_with_http_info(index_name, forward_to_replicas = nil, request_options = {})
@@ -508,12 +508,12 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Delete all rules in the index.
+    # Deletes all rules from the index.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def clear_rules(index_name, forward_to_replicas = nil, request_options = {})
@@ -521,12 +521,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # Delete all synonyms in the index.
+    # Deletes all synonyms from the index.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def clear_synonyms_with_http_info(index_name, forward_to_replicas = nil, request_options = {})
@@ -555,12 +555,12 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Delete all synonyms in the index.
+    # Deletes all synonyms from the index.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def clear_synonyms(index_name, forward_to_replicas = nil, request_options = {})
@@ -744,7 +744,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Object')
     end
 
-    # Delete an existing API key. The request must be authenticated with the admin API key.
+    # Deletes the API key.
     #
     # Required API Key ACLs:
     #   - admin
@@ -776,7 +776,7 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # Delete an existing API key. The request must be authenticated with the admin API key.
+    # Deletes the API key.
     #
     # Required API Key ACLs:
     #   - admin
@@ -788,11 +788,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeleteApiKeyResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param delete_by_params [DeleteByParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -825,11 +825,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param delete_by_params [DeleteByParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [DeletedAtResponse]
@@ -838,11 +838,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeletedAtResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def delete_index_with_http_info(index_name, request_options = {})
@@ -870,11 +870,11 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [DeletedAtResponse]
     def delete_index(index_name, request_options = {})
@@ -882,12 +882,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeletedAtResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def delete_object_with_http_info(index_name, object_id, request_options = {})
@@ -920,12 +920,12 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [DeletedAtResponse]
     def delete_object(index_name, object_id, request_options = {})
@@ -933,13 +933,13 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeletedAtResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def delete_rule_with_http_info(index_name, object_id, forward_to_replicas = nil, request_options = {})
@@ -973,13 +973,13 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def delete_rule(index_name, object_id, forward_to_replicas = nil, request_options = {})
@@ -987,7 +987,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # Remove a source from the list of allowed sources.
+    # Deletes a source from the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1019,7 +1019,7 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # Remove a source from the list of allowed sources.
+    # Deletes a source from the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1031,13 +1031,13 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeleteSourceResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def delete_synonym_with_http_info(index_name, object_id, forward_to_replicas = nil, request_options = {})
@@ -1071,13 +1071,13 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [DeletedAtResponse]
     def delete_synonym(index_name, object_id, forward_to_replicas = nil, request_options = {})
@@ -1085,7 +1085,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::DeletedAtResponse')
     end
 
-    # 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.
 
     # @param key [String] API key. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
@@ -1115,7 +1115,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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.
 
     # @param key [String] API key. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
@@ -1125,7 +1125,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetApiKeyResponse')
     end
 
-    # 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
@@ -1151,7 +1151,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
@@ -1162,7 +1162,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::Hash<String, Languages>')
     end
 
-    # 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
@@ -1188,7 +1188,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
@@ -1199,14 +1199,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetDictionarySettingsResponse')
     end
 
-    # The request must be authenticated by an API key with the [&#x60;logs&#x60; ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are held for the last seven days. There&#39;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&#39;t appear in the logs itself. &gt; **Note**: To fetch the logs for a Distributed Search Network (DSN) cluster, target the [DSN&#39;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 [&#x60;logs&#x60; 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&#39;t appear in the logs itself.
     #
     # Required API Key ACLs:
     #   - logs
-    # @param offset [Integer] First log entry to retrieve. Sorted by decreasing date with 0 being the most recent. (default to 0)
+    # @param offset [Integer] First log entry to retrieve. The most recent entries are listed first. (default to 0)
     # @param length [Integer] Maximum number of entries to retrieve. (default to 10)
-    # @param index_name [String] Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
-    # @param type [LogType] Type of log entries to retrieve. When omitted, all log entries are retrieved. (default to 'all')
+    # @param index_name [String] Index for which to retrieve log entries. By default, log entries are retrieved for all indices.
+    # @param type [LogType] Type of log entries to retrieve. By default, all log entries are retrieved.  (default to 'all')
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def get_logs_with_http_info(offset = nil, length = nil, index_name = nil, type = nil, request_options = {})
@@ -1237,14 +1237,14 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param offset [Integer] First log entry to retrieve. Sorted by decreasing date with 0 being the most recent. (default to 0)
+    # @param offset [Integer] First log entry to retrieve. The most recent entries are listed first. (default to 0)
     # @param length [Integer] Maximum number of entries to retrieve. (default to 10)
-    # @param index_name [String] Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
-    # @param type [LogType] Type of log entries to retrieve. When omitted, all log entries are retrieved. (default to 'all')
+    # @param index_name [String] Index for which to retrieve log entries. By default, log entries are retrieved for all indices.
+    # @param type [LogType] Type of log entries to retrieve. By default, all log entries are retrieved.  (default to 'all')
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetLogsResponse]
     def get_logs(offset = nil, length = nil, index_name = nil, type = nil, request_options = {})
@@ -1252,13 +1252,13 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetLogsResponse')
     end
 
-    # To get more than one record, use the [&#x60;objects&#x60; operation](#tag/Records/operation/getObjects).
+    # Retrieves one record by its object ID.  To retrieve more than one record, use the [&#x60;objects&#x60; operation](#tag/Records/operation/getObjects).
     #
     # Required API Key ACLs:
     #   - search
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param attributes_to_retrieve [Array<String>] 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. &#x60;objectID&#x60; is always retrieved, even when not specified. [&#x60;unretrievableAttributes&#x60;](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/) won&#39;t be retrieved unless the request is authenticated with the admin API key.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param attributes_to_retrieve [Array<String>] 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.  &#x60;objectID&#x60; is always retrieved.  Attributes included in &#x60;unretrievableAttributes&#x60; won&#39;t be retrieved unless the request is authenticated with the admin API key.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def get_object_with_http_info(index_name, object_id, attributes_to_retrieve = nil, request_options = {})
@@ -1292,13 +1292,13 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param attributes_to_retrieve [Array<String>] 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. &#x60;objectID&#x60; is always retrieved, even when not specified. [&#x60;unretrievableAttributes&#x60;](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/) won&#39;t be retrieved unless the request is authenticated with the admin API key.
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param attributes_to_retrieve [Array<String>] 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.  &#x60;objectID&#x60; is always retrieved.  Attributes included in &#x60;unretrievableAttributes&#x60; won&#39;t be retrieved unless the request is authenticated with the admin API key.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Hash<String, String>]
     def get_object(index_name, object_id, attributes_to_retrieve = nil, request_options = {})
@@ -1306,7 +1306,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::Hash<String, String>')
     end
 
-    # 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
@@ -1338,7 +1338,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
@@ -1350,11 +1350,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetObjectsResponse')
     end
 
-    # Get a rule by its &#x60;objectID&#x60;. To find the &#x60;objectID&#x60; for rules, use the [&#x60;search&#x60; operation](#tag/Rules/operation/searchRules).
+    # Retrieves a rule by its ID. To find the object ID of rules, use the [&#x60;search&#x60; operation](#tag/Rules/operation/searchRules).
     #
     # Required API Key ACLs:
     #   - settings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1388,11 +1388,11 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Rule]
@@ -1401,11 +1401,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::Rule')
     end
 
-    # Return an object containing an index&#39;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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def get_settings_with_http_info(index_name, request_options = {})
@@ -1433,11 +1433,11 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [IndexSettings]
     def get_settings(index_name, request_options = {})
@@ -1445,7 +1445,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::IndexSettings')
     end
 
-    # Get all allowed sources (IP addresses).
+    # Retrieves all allowed IP addresses with access to your application.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1471,7 +1471,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # Get all allowed sources (IP addresses).
+    # Retrieves all allowed IP addresses with access to your application.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1482,11 +1482,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Array<Search::Source>')
     end
 
-    # Get a syonym by its &#x60;objectID&#x60;. To find the object IDs for your synonyms, use the [&#x60;search&#x60; operation](#tag/Synonyms/operation/searchSynonyms).
+    # Retrieves a syonym by its ID. To find the object IDs for your synonyms, use the [&#x60;search&#x60; operation](#tag/Synonyms/operation/searchSynonyms).
     #
     # Required API Key ACLs:
     #   - settings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1520,11 +1520,11 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SynonymHit]
@@ -1533,11 +1533,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SynonymHit')
     end
 
-    # Some operations, such as copying an index, will respond with a &#x60;taskID&#x60; 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&#39; responses include a task ID that you can use to check the status.
     #
     # Required API Key ACLs:
     #   - addObject
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param task_id [Integer] Unique task identifier. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1571,11 +1571,11 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param task_id [Integer] Unique task identifier. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTaskResponse]
@@ -1584,7 +1584,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetTaskResponse')
     end
 
-    # 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&#39;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&#39;t real-time.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1610,7 +1610,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
@@ -1621,11 +1621,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::GetTopUserIdsResponse')
     end
 
-    # 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&#39;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&#39;t real-time.
     #
     # Required API Key ACLs:
     #   - admin
-    # @param user_id [String] userID to assign. (required)
+    # @param user_id [String] User ID to assign. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def get_user_id_with_http_info(user_id, request_options = {})
@@ -1658,11 +1658,11 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param user_id [String] userID to assign. (required)
+    # @param user_id [String] User ID to assign. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UserId]
     def get_user_id(user_id, request_options = {})
@@ -1674,7 +1674,7 @@ module Algolia
     #
     # Required API Key ACLs:
     #   - admin
-    # @param get_clusters [Boolean] Indicates whether to include the cluster&#39;s pending mapping state in the response.
+    # @param get_clusters [Boolean] Whether to include the cluster&#39;s pending mapping state in the response.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def has_pending_mappings_with_http_info(get_clusters = nil, request_options = {})
@@ -1702,7 +1702,7 @@ module Algolia
     #
     # Required API Key ACLs:
     #   - admin
-    # @param get_clusters [Boolean] Indicates whether to include the cluster&#39;s pending mapping state in the response.
+    # @param get_clusters [Boolean] Whether to include the cluster&#39;s pending mapping state in the response.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [HasPendingMappingsResponse]
     def has_pending_mappings(get_clusters = nil, request_options = {})
@@ -1710,7 +1710,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::HasPendingMappingsResponse')
     end
 
-    # 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
@@ -1736,7 +1736,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
@@ -1747,7 +1747,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::ListApiKeysResponse')
     end
 
-    # List the available clusters in a multi-cluster setup.
+    # Lists the available clusters in a multi-cluster setup.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1773,7 +1773,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # List the available clusters in a multi-cluster setup.
+    # Lists the available clusters in a multi-cluster setup.
     #
     # Required API Key ACLs:
     #   - admin
@@ -1784,12 +1784,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::ListClustersResponse')
     end
 
-    # 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
-    # @param page [Integer] Returns the requested page number. The page size is determined by the &#x60;hitsPerPage&#x60; parameter. You can see the number of available pages in the &#x60;nbPages&#x60; response attribute. When &#x60;page&#x60; is null, the API response is not paginated.
-    # @param hits_per_page [Integer] Maximum number of hits per page. (default to 100)
+    # @param page [Integer] Requested page of the API response. If &#x60;null&#x60;, the API response is not paginated.
+    # @param hits_per_page [Integer] Number of hits per page. (default to 100)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def list_indices_with_http_info(page = nil, hits_per_page = nil, request_options = {})
@@ -1818,12 +1818,12 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param page [Integer] Returns the requested page number. The page size is determined by the &#x60;hitsPerPage&#x60; parameter. You can see the number of available pages in the &#x60;nbPages&#x60; response attribute. When &#x60;page&#x60; is null, the API response is not paginated.
-    # @param hits_per_page [Integer] Maximum number of hits per page. (default to 100)
+    # @param page [Integer] Requested page of the API response. If &#x60;null&#x60;, the API response is not paginated.
+    # @param hits_per_page [Integer] Number of hits per page. (default to 100)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [ListIndicesResponse]
     def list_indices(page = nil, hits_per_page = nil, request_options = {})
@@ -1831,12 +1831,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::ListIndicesResponse')
     end
 
-    # 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&#39;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&#39;t real-time.
     #
     # Required API Key ACLs:
     #   - admin
-    # @param page [Integer] Returns the requested page number. The page size is determined by the &#x60;hitsPerPage&#x60; parameter. You can see the number of available pages in the &#x60;nbPages&#x60; response attribute. When &#x60;page&#x60; is null, the API response is not paginated.
-    # @param hits_per_page [Integer] Maximum number of hits per page. (default to 100)
+    # @param page [Integer] Requested page of the API response. If &#x60;null&#x60;, the API response is not paginated.
+    # @param hits_per_page [Integer] Number of hits per page. (default to 100)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def list_user_ids_with_http_info(page = nil, hits_per_page = nil, request_options = {})
@@ -1865,12 +1865,12 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # 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
-    # @param page [Integer] Returns the requested page number. The page size is determined by the &#x60;hitsPerPage&#x60; parameter. You can see the number of available pages in the &#x60;nbPages&#x60; response attribute. When &#x60;page&#x60; is null, the API response is not paginated.
-    # @param hits_per_page [Integer] Maximum number of hits per page. (default to 100)
+    # @param page [Integer] Requested page of the API response. If &#x60;null&#x60;, the API response is not paginated.
+    # @param hits_per_page [Integer] Number of hits per page. (default to 100)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [ListUserIdsResponse]
     def list_user_ids(page = nil, hits_per_page = nil, request_options = {})
@@ -1878,7 +1878,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::ListUserIdsResponse')
     end
 
-    # To reduce the time spent on network round trips, you can perform several write actions in a single request. It&#39;s a multi-index version of the [&#x60;batch&#x60; 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.
 
     # @param batch_params [BatchParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
@@ -1908,7 +1908,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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.
 
     # @param batch_params [BatchParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
@@ -1918,11 +1918,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::MultipleBatchResponse')
     end
 
-    # This &#x60;operation&#x60;, _copy_ or _move_, will copy or move a source index&#39;s (&#x60;IndexName&#x60;) records, settings, synonyms, and rules to a &#x60;destination&#x60; index. If the destination index exists, it will be replaced, except for index-specific API keys and analytics data. If the destination index doesn&#39;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.  &gt; **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&#39;t exist yet, it&#39;ll be created.  **Copy**  - Copying a source index that doesn&#39;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&#39;t copy the &#x60;enableReRanking&#x60;, &#x60;mode&#x60;, and &#x60;replicas&#x60; settings. - You can&#39;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&#39;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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param operation_index_params [OperationIndexParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1955,11 +1955,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param operation_index_params [OperationIndexParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
@@ -1968,14 +1968,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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&#39;t exist,   a new record is added to the index **if** &#x60;createIfNotExists&#x60; is true. - If the index doesn&#39;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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param attributes_to_update [Hash<String, AttributeToUpdate>] Object with attributes to update. (required)
-    # @param create_if_not_exists [Boolean] Indicates whether to create a new record if it doesn&#39;t exist yet.  (default to true)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param attributes_to_update [Hash<String, AttributeToUpdate>] Attributes with their values. (required)
+    # @param create_if_not_exists [Boolean] Whether to create a new record if it doesn&#39;t exist. (default to true)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def partial_update_object_with_http_info(index_name, object_id, attributes_to_update, create_if_not_exists = nil, request_options = {})
@@ -2013,14 +2013,14 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param object_id [String] Unique record (object) identifier. (required)
-    # @param attributes_to_update [Hash<String, AttributeToUpdate>] Object with attributes to update. (required)
-    # @param create_if_not_exists [Boolean] Indicates whether to create a new record if it doesn&#39;t exist yet.  (default to true)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param object_id [String] Unique record identifier. (required)
+    # @param attributes_to_update [Hash<String, AttributeToUpdate>] Attributes with their values. (required)
+    # @param create_if_not_exists [Boolean] Whether to create a new record if it doesn&#39;t exist. (default to true)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtWithObjectIdResponse]
     def partial_update_object(index_name, object_id, attributes_to_update, create_if_not_exists = nil, request_options = {})
@@ -2028,11 +2028,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtWithObjectIdResponse')
     end
 
-    # 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
-    # @param user_id [String] userID to assign. (required)
+    # @param user_id [String] User ID to assign. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def remove_user_id_with_http_info(user_id, request_options = {})
@@ -2065,11 +2065,11 @@ module Algolia
       @api_client.call_api(:DELETE, path, new_options)
     end
 
-    # 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
-    # @param user_id [String] userID to assign. (required)
+    # @param user_id [String] User ID to assign. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [RemoveUserIdResponse]
     def remove_user_id(user_id, request_options = {})
@@ -2077,7 +2077,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::RemoveUserIdResponse')
     end
 
-    # Replace all allowed sources.
+    # Replaces the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -2109,7 +2109,7 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # Replace all allowed sources.
+    # Replaces the list of allowed sources.
     #
     # Required API Key ACLs:
     #   - admin
@@ -2121,7 +2121,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::ReplaceSourceResponse')
     end
 
-    # 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 &#x60;validity&#x60; attribute to &#x60;0&#x60;.  Algolia stores up to 1,000 API keys per application. If you create more, the oldest API keys are deleted and can&#39;t be restored.
     #
     # Required API Key ACLs:
     #   - admin
@@ -2153,7 +2153,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
@@ -2165,12 +2165,12 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::AddApiKeyResponse')
     end
 
-    # Add a record (object) to an index or replace it. If the record doesn&#39;t contain an &#x60;objectID&#x60;, Algolia automatically adds it. If you use an existing &#x60;objectID&#x60;, the existing record is replaced with the new one. To add multiple records to your index in a single API request, use the [&#x60;batch&#x60; operation](#tag/Records/operation/batch).
+    # Adds a record to an index or replace it.  - If the record doesn&#39;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&#39;t exist, a new record is added to your index. - If you add a record to an index that doesn&#39;t exist yet, a new index is created.  To update _some_ attributes of a record, use the [&#x60;partial&#x60; operation](#tag/Records/operation/partial). To add, update, or replace multiple records, use the [&#x60;batch&#x60; operation](#tag/Records/operation/batch).
     #
     # Required API Key ACLs:
     #   - addObject
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param body [Object] The Algolia record. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_object_with_http_info(index_name, body, request_options = {})
@@ -2202,12 +2202,12 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param body [Object] The Algolia record. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SaveObjectResponse]
     def save_object(index_name, body, request_options = {})
@@ -2215,14 +2215,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SaveObjectResponse')
     end
 
-    # To create or update more than one rule, use the [&#x60;batch&#x60; operation](#tag/Rules/operation/saveRules).
+    # If a rule with the specified object ID doesn&#39;t exist, it&#39;s created. Otherwise, the existing rule is replaced.  To create or update more than one rule, use the [&#x60;batch&#x60; operation](#tag/Rules/operation/saveRules).
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
     # @param rule [Rule]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_rule_with_http_info(index_name, object_id, rule, forward_to_replicas = nil, request_options = {})
@@ -2260,14 +2260,14 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a rule object. (required)
     # @param rule [Rule]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedRuleResponse]
     def save_rule(index_name, object_id, rule, forward_to_replicas = nil, request_options = {})
@@ -2275,14 +2275,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedRuleResponse')
     end
 
-    # Create or update multiple rules.
+    # Create or update multiple rules.  If a rule with the specified object ID doesn&#39;t exist, Algolia creates a new one. Otherwise, existing rules are replaced.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param rules [Array<Rule>]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
-    # @param clear_existing_rules [Boolean] Indicates whether existing rules should be deleted before adding this batch.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
+    # @param clear_existing_rules [Boolean] Whether existing rules should be deleted before adding this batch.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_rules_with_http_info(index_name, rules, forward_to_replicas = nil, clear_existing_rules = nil, request_options = {})
@@ -2316,14 +2316,14 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param rules [Array<Rule>]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
-    # @param clear_existing_rules [Boolean] Indicates whether existing rules should be deleted before adding this batch.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
+    # @param clear_existing_rules [Boolean] Whether existing rules should be deleted before adding this batch.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def save_rules(index_name, rules, forward_to_replicas = nil, clear_existing_rules = nil, request_options = {})
@@ -2331,14 +2331,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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 &#x60;objectID&#x60; doesn&#39;t exist, Algolia adds a new one. If you use an existing synonym &#x60;objectID&#x60;, the existing synonym is replaced with the new one. To add multiple synonyms in a single API request, use the [&#x60;batch&#x60; operation](#tag/Synonyms/operation/saveSynonyms).
+    # If a synonym with the specified object ID doesn&#39;t exist, Algolia adds a new one. Otherwise, the existing synonym is replaced. To add multiple synonyms in a single API request, use the [&#x60;batch&#x60; operation](#tag/Synonyms/operation/saveSynonyms).
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
     # @param synonym_hit [SynonymHit]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_synonym_with_http_info(index_name, object_id, synonym_hit, forward_to_replicas = nil, request_options = {})
@@ -2376,14 +2376,14 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique identifier of a synonym object. (required)
     # @param synonym_hit [SynonymHit]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SaveSynonymResponse]
     def save_synonym(index_name, object_id, synonym_hit, forward_to_replicas = nil, request_options = {})
@@ -2391,14 +2391,14 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SaveSynonymResponse')
     end
 
-    # Create or update multiple synonyms.
+    # If a synonym with the &#x60;objectID&#x60; doesn&#39;t exist, Algolia adds a new one. Otherwise, existing synonyms are replaced.
     #
     # Required API Key ACLs:
     #   - editSettings
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param synonym_hit [Array<SynonymHit>]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
-    # @param replace_existing_synonyms [Boolean] Indicates whether to replace all synonyms in the index with the ones sent with this request.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
+    # @param replace_existing_synonyms [Boolean] Whether to replace all synonyms in the index with the ones sent with this request.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_synonyms_with_http_info(index_name, synonym_hit, forward_to_replicas = nil, replace_existing_synonyms = nil, request_options = {})
@@ -2432,14 +2432,14 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param synonym_hit [Array<SynonymHit>]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
-    # @param replace_existing_synonyms [Boolean] Indicates whether to replace all synonyms in the index with the ones sent with this request.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
+    # @param replace_existing_synonyms [Boolean] Whether to replace all synonyms in the index with the ones sent with this request.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def save_synonyms(index_name, synonym_hit, forward_to_replicas = nil, replace_existing_synonyms = nil, request_options = {})
@@ -2447,11 +2447,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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.
     #
     # Required API Key ACLs:
     #   - search
-    # @param search_method_params [SearchMethodParams] Query requests and strategies. Results will be received in the same order as the queries. (required)
+    # @param search_method_params [SearchMethodParams] Muli-search request body. Results are returned in the same order as the requests. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def search_with_http_info(search_method_params, request_options = {})
@@ -2479,11 +2479,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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.
     #
     # Required API Key ACLs:
     #   - search
-    # @param search_method_params [SearchMethodParams] Query requests and strategies. Results will be received in the same order as the queries. (required)
+    # @param search_method_params [SearchMethodParams] Muli-search request body. Results are returned in the same order as the requests. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SearchResponses]
     def search(search_method_params, request_options = {})
@@ -2491,11 +2491,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchResponses')
     end
 
-    # 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
-    # @param dictionary_name [DictionaryType] Dictionary to search in. (required)
+    # @param dictionary_name [DictionaryType] Dictionary type in which to search. (required)
     # @param search_dictionary_entries_params [SearchDictionaryEntriesParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -2528,25 +2528,25 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param dictionary_name [DictionaryType] Dictionary to search in. (required)
+    # @param dictionary_name [DictionaryType] Dictionary type in which to search. (required)
     # @param search_dictionary_entries_params [SearchDictionaryEntriesParams]  (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
-    # @return [UpdatedAtResponse]
+    # @return [SearchDictionaryEntriesResponse]
     def search_dictionary_entries(dictionary_name, search_dictionary_entries_params, request_options = {})
       response = search_dictionary_entries_with_http_info(dictionary_name, search_dictionary_entries_params, request_options)
-      @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchDictionaryEntriesResponse')
     end
 
-    # [Search for a facet&#39;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. &gt; **Note**: Pagination isn&#39;t supported (&#x60;page&#x60; and &#x60;hitsPerPage&#x60; are ignored). By default, the engine returns a maximum of 10 values but you can adjust this with &#x60;maxFacetHits&#x60;.
+    # Searches for values of a specified facet attribute.  - By default, facet values are sorted by decreasing count.   You can adjust this with the &#x60;sortFacetValueBy&#x60; parameter. - Searching for facet values doesn&#39;t work if you have **more than 65 searchable facets and searchable attributes combined**.
     #
     # Required API Key ACLs:
     #   - search
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param facet_name [String] Facet name. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param facet_name [String] Facet attribute in which to search for values.  This attribute must be included in the &#x60;attributesForFaceting&#x60; index setting with the &#x60;searchable()&#x60; modifier.  (required)
     # @param search_for_facet_values_request [SearchForFacetValuesRequest]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -2580,12 +2580,12 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # [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
-    # @param index_name [String] Index on which to perform the request. (required)
-    # @param facet_name [String] Facet name. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
+    # @param facet_name [String] Facet attribute in which to search for values.  This attribute must be included in the &#x60;attributesForFaceting&#x60; index setting with the &#x60;searchable()&#x60; modifier.  (required)
     # @param search_for_facet_values_request [SearchForFacetValuesRequest]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SearchForFacetValuesResponse]
@@ -2594,11 +2594,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchForFacetValuesResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_rules_params [SearchRulesParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -2627,11 +2627,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_rules_params [SearchRulesParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SearchRulesResponse]
@@ -2640,11 +2640,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchRulesResponse')
     end
 
-    # 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 [&#x60;browse&#x60; operation](#tag/Search/operation/browse) or increase the &#x60;paginatedLimitedTo&#x60; index setting.
     #
     # Required API Key ACLs:
     #   - search
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_params [SearchParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -2673,11 +2673,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_params [SearchParams]
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SearchResponse]
@@ -2686,11 +2686,11 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchResponse')
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_synonyms_params [SearchSynonymsParams] Body of the &#x60;searchSynonyms&#x60; operation.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -2719,11 +2719,11 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param search_synonyms_params [SearchSynonymsParams] Body of the &#x60;searchSynonyms&#x60; operation.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SearchSynonymsResponse]
@@ -2732,7 +2732,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchSynonymsResponse')
     end
 
-    # Since it can take up to a few seconds to get the data from the different clusters, the response isn&#39;t real-time. To ensure rapid updates, the user IDs index isn&#39;t built at the same time as the mapping. Instead, it&#39;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&#39;t real-time.  To ensure rapid updates, the user IDs index isn&#39;t built at the same time as the mapping. Instead, it&#39;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
@@ -2764,7 +2764,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # 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
@@ -2776,7 +2776,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::SearchUserIdsResponse')
     end
 
-    # 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
@@ -2808,7 +2808,7 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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
@@ -2820,13 +2820,13 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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&#39;t specify are left unchanged. Specify &#x60;null&#x60; 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param index_settings [IndexSettings]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def set_settings_with_http_info(index_name, index_settings, forward_to_replicas = nil, request_options = {})
@@ -2859,13 +2859,13 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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
-    # @param index_name [String] Index on which to perform the request. (required)
+    # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param index_settings [IndexSettings]  (required)
-    # @param forward_to_replicas [Boolean] Indicates whether changed index settings are forwarded to the replica indices.
+    # @param forward_to_replicas [Boolean] Whether changes are applied to replica indices.
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtResponse]
     def set_settings(index_name, index_settings, forward_to_replicas = nil, request_options = {})
@@ -2873,7 +2873,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || 'Search::UpdatedAtResponse')
     end
 
-    # 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
@@ -2910,7 +2910,7 @@ module Algolia
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # 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