@algolia/client-search 5.0.0-alpha.73 → 5.0.0-alpha.76

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/dist/client-search.cjs.js +188 -186
  2. package/dist/client-search.esm.browser.js +188 -184
  3. package/dist/client-search.esm.node.js +188 -184
  4. package/dist/client-search.umd.js +2 -2
  5. package/dist/model/acl.d.ts +1 -1
  6. package/dist/model/action.d.ts +1 -1
  7. package/dist/model/addApiKeyResponse.d.ts +2 -2
  8. package/dist/model/anchoring.d.ts +1 -1
  9. package/dist/model/apiKey.d.ts +9 -9
  10. package/dist/model/aroundRadius.d.ts +1 -1
  11. package/dist/model/assignUserIdParams.d.ts +1 -1
  12. package/dist/model/baseGetApiKeyResponse.d.ts +2 -2
  13. package/dist/model/baseIndexSettings.d.ts +14 -14
  14. package/dist/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  15. package/dist/model/baseSearchResponse.d.ts +20 -20
  16. package/dist/model/baseSearchResponseRedirect.d.ts +1 -1
  17. package/dist/model/batchAssignUserIdsParams.d.ts +2 -2
  18. package/dist/model/batchDictionaryEntriesParams.d.ts +3 -3
  19. package/dist/model/batchParams.d.ts +1 -1
  20. package/dist/model/batchRequest.d.ts +1 -1
  21. package/dist/model/batchResponse.d.ts +2 -2
  22. package/dist/model/batchWriteParams.d.ts +1 -1
  23. package/dist/model/builtInOperation.d.ts +1 -1
  24. package/dist/model/builtInOperationType.d.ts +1 -1
  25. package/dist/model/clientMethodProps.d.ts +88 -84
  26. package/dist/model/clientMethodProps.d.ts.map +1 -1
  27. package/dist/model/consequence.d.ts +4 -4
  28. package/dist/model/consequenceHide.d.ts +2 -2
  29. package/dist/model/createdAtResponse.d.ts +2 -2
  30. package/dist/model/cursor.d.ts +1 -1
  31. package/dist/model/deleteApiKeyResponse.d.ts +1 -1
  32. package/dist/model/deleteByParams.d.ts +4 -4
  33. package/dist/model/deleteSourceResponse.d.ts +1 -1
  34. package/dist/model/deletedAtResponse.d.ts +3 -3
  35. package/dist/model/dictionaryEntry.d.ts +6 -6
  36. package/dist/model/dictionaryEntryState.d.ts +1 -1
  37. package/dist/model/dictionaryLanguage.d.ts +2 -2
  38. package/dist/model/dictionarySettingsParams.d.ts +1 -1
  39. package/dist/model/distinct.d.ts +1 -1
  40. package/dist/model/exactOnSingleWordQuery.d.ts +1 -1
  41. package/dist/model/facetFilters.d.ts +1 -1
  42. package/dist/model/facetHits.d.ts +3 -3
  43. package/dist/model/facetOrdering.d.ts +2 -2
  44. package/dist/model/facets.d.ts +1 -1
  45. package/dist/model/facetsStats.d.ts +4 -4
  46. package/dist/model/fetchedIndex.d.ts +1 -1
  47. package/dist/model/getObjectsParams.d.ts +1 -1
  48. package/dist/model/getObjectsRequest.d.ts +4 -4
  49. package/dist/model/getObjectsResponse.d.ts +1 -1
  50. package/dist/model/getTopUserIdsResponse.d.ts +2 -2
  51. package/dist/model/hasPendingMappingsResponse.d.ts +2 -2
  52. package/dist/model/highlightResultOption.d.ts +1 -1
  53. package/dist/model/hit.d.ts +1 -1
  54. package/dist/model/ignorePlurals.d.ts +1 -1
  55. package/dist/model/index.d.ts +1 -0
  56. package/dist/model/index.d.ts.map +1 -1
  57. package/dist/model/indexSettings.d.ts +1 -1
  58. package/dist/model/indexSettingsAsSearchParams.d.ts +30 -30
  59. package/dist/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  60. package/dist/model/languages.d.ts +1 -1
  61. package/dist/model/listApiKeysResponse.d.ts +1 -1
  62. package/dist/model/listClustersResponse.d.ts +2 -2
  63. package/dist/model/listIndicesResponse.d.ts +1 -1
  64. package/dist/model/listUserIdsResponse.d.ts +2 -2
  65. package/dist/model/log.d.ts +7 -7
  66. package/dist/model/logQuery.d.ts +1 -1
  67. package/dist/model/mode.d.ts +1 -1
  68. package/dist/model/multipleBatchRequest.d.ts +1 -1
  69. package/dist/model/multipleBatchResponse.d.ts +2 -2
  70. package/dist/model/numericFilters.d.ts +1 -1
  71. package/dist/model/operationIndexParams.d.ts +2 -2
  72. package/dist/model/operationType.d.ts +1 -1
  73. package/dist/model/optionalFilters.d.ts +1 -1
  74. package/dist/model/params.d.ts +1 -1
  75. package/dist/model/promoteObjectID.d.ts +3 -3
  76. package/dist/model/promoteObjectIDs.d.ts +3 -3
  77. package/dist/model/queryType.d.ts +1 -1
  78. package/dist/model/reRankingApplyFilter.d.ts +1 -1
  79. package/dist/model/redirectRuleIndexMetadata.d.ts +1 -1
  80. package/dist/model/redirectRuleIndexMetadataData.d.ts +1 -1
  81. package/dist/model/removeStopWords.d.ts +1 -1
  82. package/dist/model/removeUserIdResponse.d.ts +1 -1
  83. package/dist/model/removeWordsIfNoResults.d.ts +1 -1
  84. package/dist/model/renderingContent.d.ts +1 -1
  85. package/dist/model/replaceSourceResponse.d.ts +1 -1
  86. package/dist/model/rule.d.ts +5 -5
  87. package/dist/model/saveObjectResponse.d.ts +5 -2
  88. package/dist/model/saveObjectResponse.d.ts.map +1 -1
  89. package/dist/model/saveSynonymResponse.d.ts +3 -3
  90. package/dist/model/searchDictionaryEntriesParams.d.ts +5 -5
  91. package/dist/model/searchForFacetValuesRequest.d.ts +2 -2
  92. package/dist/model/searchForFacetsOptions.d.ts +3 -3
  93. package/dist/model/searchForHitsOptions.d.ts +1 -1
  94. package/dist/model/searchParamsQuery.d.ts +1 -1
  95. package/dist/model/searchParamsString.d.ts +1 -1
  96. package/dist/model/searchResponses.d.ts +2 -2
  97. package/dist/model/searchResponses.d.ts.map +1 -1
  98. package/dist/model/searchResult.d.ts +4 -0
  99. package/dist/model/searchResult.d.ts.map +1 -0
  100. package/dist/model/searchRulesParams.d.ts +7 -7
  101. package/dist/model/searchStrategy.d.ts +3 -0
  102. package/dist/model/searchStrategy.d.ts.map +1 -1
  103. package/dist/model/searchSynonymsParams.d.ts +1 -1
  104. package/dist/model/searchSynonymsResponse.d.ts +2 -2
  105. package/dist/model/searchTypeDefault.d.ts +1 -1
  106. package/dist/model/searchTypeFacet.d.ts +1 -1
  107. package/dist/model/searchUserIdsParams.d.ts +4 -4
  108. package/dist/model/searchUserIdsResponse.d.ts +5 -5
  109. package/dist/model/snippetResultOption.d.ts +1 -1
  110. package/dist/model/sortRemainingBy.d.ts +1 -1
  111. package/dist/model/source.d.ts +3 -3
  112. package/dist/model/standardEntries.d.ts +4 -4
  113. package/dist/model/synonymHit.d.ts +6 -6
  114. package/dist/model/synonymType.d.ts +1 -1
  115. package/dist/model/tagFilters.d.ts +1 -1
  116. package/dist/model/taskStatus.d.ts +3 -0
  117. package/dist/model/taskStatus.d.ts.map +1 -1
  118. package/dist/model/typoTolerance.d.ts +1 -1
  119. package/dist/model/updateApiKeyResponse.d.ts +2 -2
  120. package/dist/model/updatedAtResponse.d.ts +3 -3
  121. package/dist/model/updatedAtWithObjectIdResponse.d.ts +4 -4
  122. package/dist/model/updatedRuleResponse.d.ts +3 -3
  123. package/dist/model/userHit.d.ts +1 -1
  124. package/dist/model/userId.d.ts +2 -2
  125. package/dist/src/searchClient.d.ts +185 -184
  126. package/dist/src/searchClient.d.ts.map +1 -1
  127. package/model/acl.ts +1 -1
  128. package/model/action.ts +1 -1
  129. package/model/addApiKeyResponse.ts +2 -2
  130. package/model/anchoring.ts +1 -1
  131. package/model/apiKey.ts +9 -9
  132. package/model/aroundRadius.ts +1 -1
  133. package/model/assignUserIdParams.ts +1 -1
  134. package/model/baseGetApiKeyResponse.ts +2 -2
  135. package/model/baseIndexSettings.ts +14 -14
  136. package/model/baseSearchParamsWithoutQuery.ts +25 -25
  137. package/model/baseSearchResponse.ts +20 -20
  138. package/model/baseSearchResponseRedirect.ts +1 -1
  139. package/model/batchAssignUserIdsParams.ts +2 -2
  140. package/model/batchDictionaryEntriesParams.ts +3 -3
  141. package/model/batchParams.ts +1 -1
  142. package/model/batchRequest.ts +1 -1
  143. package/model/batchResponse.ts +2 -2
  144. package/model/batchWriteParams.ts +1 -1
  145. package/model/builtInOperation.ts +1 -1
  146. package/model/builtInOperationType.ts +1 -1
  147. package/model/clientMethodProps.ts +88 -84
  148. package/model/consequence.ts +4 -4
  149. package/model/consequenceHide.ts +2 -2
  150. package/model/createdAtResponse.ts +2 -2
  151. package/model/cursor.ts +1 -1
  152. package/model/deleteApiKeyResponse.ts +1 -1
  153. package/model/deleteByParams.ts +4 -4
  154. package/model/deleteSourceResponse.ts +1 -1
  155. package/model/deletedAtResponse.ts +3 -3
  156. package/model/dictionaryEntry.ts +6 -6
  157. package/model/dictionaryEntryState.ts +1 -1
  158. package/model/dictionaryLanguage.ts +2 -2
  159. package/model/dictionarySettingsParams.ts +1 -1
  160. package/model/distinct.ts +1 -1
  161. package/model/exactOnSingleWordQuery.ts +1 -1
  162. package/model/facetFilters.ts +1 -1
  163. package/model/facetHits.ts +3 -3
  164. package/model/facetOrdering.ts +2 -2
  165. package/model/facets.ts +1 -1
  166. package/model/facetsStats.ts +4 -4
  167. package/model/fetchedIndex.ts +1 -1
  168. package/model/getObjectsParams.ts +1 -1
  169. package/model/getObjectsRequest.ts +4 -4
  170. package/model/getObjectsResponse.ts +1 -1
  171. package/model/getTopUserIdsResponse.ts +2 -2
  172. package/model/hasPendingMappingsResponse.ts +2 -2
  173. package/model/highlightResultOption.ts +1 -1
  174. package/model/hit.ts +1 -1
  175. package/model/ignorePlurals.ts +1 -1
  176. package/model/index.ts +1 -0
  177. package/model/indexSettings.ts +1 -1
  178. package/model/indexSettingsAsSearchParams.ts +30 -30
  179. package/model/indexSettingsAsSearchParamsSemanticSearch.ts +2 -2
  180. package/model/languages.ts +1 -1
  181. package/model/listApiKeysResponse.ts +1 -1
  182. package/model/listClustersResponse.ts +2 -2
  183. package/model/listIndicesResponse.ts +1 -1
  184. package/model/listUserIdsResponse.ts +2 -2
  185. package/model/log.ts +7 -7
  186. package/model/logQuery.ts +1 -1
  187. package/model/mode.ts +1 -1
  188. package/model/multipleBatchRequest.ts +1 -1
  189. package/model/multipleBatchResponse.ts +2 -2
  190. package/model/numericFilters.ts +1 -1
  191. package/model/operationIndexParams.ts +2 -2
  192. package/model/operationType.ts +1 -1
  193. package/model/optionalFilters.ts +1 -1
  194. package/model/params.ts +1 -1
  195. package/model/promoteObjectID.ts +3 -3
  196. package/model/promoteObjectIDs.ts +3 -3
  197. package/model/queryType.ts +1 -1
  198. package/model/reRankingApplyFilter.ts +1 -1
  199. package/model/redirectRuleIndexMetadata.ts +1 -1
  200. package/model/redirectRuleIndexMetadataData.ts +1 -1
  201. package/model/removeStopWords.ts +1 -1
  202. package/model/removeUserIdResponse.ts +1 -1
  203. package/model/removeWordsIfNoResults.ts +1 -1
  204. package/model/renderingContent.ts +1 -1
  205. package/model/replaceSourceResponse.ts +1 -1
  206. package/model/rule.ts +5 -5
  207. package/model/saveObjectResponse.ts +5 -2
  208. package/model/saveSynonymResponse.ts +3 -3
  209. package/model/searchDictionaryEntriesParams.ts +5 -5
  210. package/model/searchForFacetValuesRequest.ts +2 -2
  211. package/model/searchForFacetsOptions.ts +3 -3
  212. package/model/searchForHitsOptions.ts +1 -1
  213. package/model/searchParamsQuery.ts +1 -1
  214. package/model/searchParamsString.ts +1 -1
  215. package/model/searchResponses.ts +2 -2
  216. package/model/searchResult.ts +8 -0
  217. package/model/searchRulesParams.ts +7 -7
  218. package/model/searchStrategy.ts +3 -0
  219. package/model/searchSynonymsParams.ts +1 -1
  220. package/model/searchSynonymsResponse.ts +2 -2
  221. package/model/searchTypeDefault.ts +1 -1
  222. package/model/searchTypeFacet.ts +1 -1
  223. package/model/searchUserIdsParams.ts +4 -4
  224. package/model/searchUserIdsResponse.ts +5 -5
  225. package/model/snippetResultOption.ts +1 -1
  226. package/model/sortRemainingBy.ts +1 -1
  227. package/model/source.ts +3 -3
  228. package/model/standardEntries.ts +4 -4
  229. package/model/synonymHit.ts +6 -6
  230. package/model/synonymType.ts +1 -1
  231. package/model/tagFilters.ts +1 -1
  232. package/model/taskStatus.ts +3 -0
  233. package/model/typoTolerance.ts +1 -1
  234. package/model/updateApiKeyResponse.ts +2 -2
  235. package/model/updatedAtResponse.ts +3 -3
  236. package/model/updatedAtWithObjectIdResponse.ts +4 -4
  237. package/model/updatedRuleResponse.ts +3 -3
  238. package/model/userHit.ts +1 -1
  239. package/model/userId.ts +2 -2
  240. package/package.json +8 -7
@@ -713,7 +713,7 @@ function createXhrRequester() {
713
713
  }
714
714
 
715
715
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
716
- const apiClientVersion = '5.0.0-alpha.73';
716
+ const apiClientVersion = '5.0.0-alpha.76';
717
717
  function getDefaultHosts(appId) {
718
718
  return [
719
719
  {
@@ -960,9 +960,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
960
960
  });
961
961
  },
962
962
  /**
963
- * Add a new API Key with specific permissions/restrictions.
963
+ * 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.
964
964
  *
965
- * @summary Create an API key.
965
+ * @summary Add API key.
966
966
  * @param apiKey - The apiKey object.
967
967
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
968
968
  */
@@ -986,13 +986,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
986
986
  return transporter.request(request, requestOptions);
987
987
  },
988
988
  /**
989
- * Add or replace an object with a given object ID. If the object does not exist, it will be created. If it already exists, it will be replaced.
989
+ * 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).
990
990
  *
991
- * @summary Add or replace an object.
991
+ * @summary Add or update a record (using objectID).
992
992
  * @param addOrUpdateObject - The addOrUpdateObject object.
993
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
994
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
995
- * @param addOrUpdateObject.body - The Algolia object.
993
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
994
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
995
+ * @param addOrUpdateObject.body - Algolia record.
996
996
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
997
997
  */
998
998
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -1020,10 +1020,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1020
1020
  return transporter.request(request, requestOptions);
1021
1021
  },
1022
1022
  /**
1023
- * Add a single source to the list of allowed sources.
1023
+ * Add a source to the list of allowed sources.
1024
1024
  *
1025
- * @summary Add a single source.
1026
- * @param source - The source to add.
1025
+ * @summary Add a source.
1026
+ * @param source - Source to add.
1027
1027
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1028
1028
  */
1029
1029
  appendSource(source, requestOptions) {
@@ -1046,9 +1046,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1046
1046
  return transporter.request(request, requestOptions);
1047
1047
  },
1048
1048
  /**
1049
- * Assign or Move a userID to a cluster. The time it takes to migrate (move) a user is proportional to the amount of data linked to the userID. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userID is directly usable.
1049
+ * 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.
1050
1050
  *
1051
- * @summary Assign or Move userID.
1051
+ * @summary Assign or move a user ID.
1052
1052
  * @param assignUserId - The assignUserId object.
1053
1053
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
1054
1054
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -1080,11 +1080,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1080
1080
  return transporter.request(request, requestOptions);
1081
1081
  },
1082
1082
  /**
1083
- * Perform multiple write operations targeting one index, in a single API call.
1083
+ * 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.
1084
1084
  *
1085
- * @summary Batch operations to one index.
1085
+ * @summary Batch write operations on one index.
1086
1086
  * @param batch - The batch object.
1087
- * @param batch.indexName - The index in which to perform the request.
1087
+ * @param batch.indexName - Index on which to perform the request.
1088
1088
  * @param batch.batchWriteParams - The batchWriteParams object.
1089
1089
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1090
1090
  */
@@ -1111,7 +1111,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1111
1111
  return transporter.request(request, requestOptions);
1112
1112
  },
1113
1113
  /**
1114
- * Assign multiple userIDs to a cluster. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userIDs are directly usable.
1114
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
1115
1115
  *
1116
1116
  * @summary Batch assign userIDs.
1117
1117
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -1148,11 +1148,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1148
1148
  return transporter.request(request, requestOptions);
1149
1149
  },
1150
1150
  /**
1151
- * Send a batch of dictionary entries.
1151
+ * Add or remove a batch of dictionary entries.
1152
1152
  *
1153
1153
  * @summary Batch dictionary entries.
1154
1154
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
1155
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
1155
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
1156
1156
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
1157
1157
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1158
1158
  */
@@ -1179,11 +1179,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1179
1179
  return transporter.request(request, requestOptions);
1180
1180
  },
1181
1181
  /**
1182
- * This method allows you to retrieve all index content. It can retrieve up to 1,000 records per call and supports full text search and filters. For performance reasons, some features are not supported, including `distinct`, sorting by `typos`, `words` or `geo distance`. When there is more content to be browsed, the response contains a cursor field. This cursor has to be passed to the subsequent call to browse in order to get the next page of results. When the end of the index has been reached, the cursor field is absent from the response.
1182
+ * 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.
1183
1183
  *
1184
- * @summary Retrieve all index content.
1184
+ * @summary Get all records from an index.
1185
1185
  * @param browse - The browse object.
1186
- * @param browse.indexName - The index in which to perform the request.
1186
+ * @param browse.indexName - Index on which to perform the request.
1187
1187
  * @param browse.browseParams - The browseParams object.
1188
1188
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1189
1189
  */
@@ -1204,12 +1204,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1204
1204
  return transporter.request(request, requestOptions);
1205
1205
  },
1206
1206
  /**
1207
- * Remove all synonyms from an index.
1207
+ * Delete all synonyms in the index.
1208
1208
  *
1209
- * @summary Clear all synonyms.
1209
+ * @summary Delete all synonyms.
1210
1210
  * @param clearAllSynonyms - The clearAllSynonyms object.
1211
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
1212
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1211
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
1212
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1213
1213
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1214
1214
  */
1215
1215
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -1231,11 +1231,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1231
1231
  return transporter.request(request, requestOptions);
1232
1232
  },
1233
1233
  /**
1234
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
1234
+ * Delete the records but leave settings and index-specific API keys untouched.
1235
1235
  *
1236
- * @summary Clear all objects from an index.
1236
+ * @summary Delete all records from an index.
1237
1237
  * @param clearObjects - The clearObjects object.
1238
- * @param clearObjects.indexName - The index in which to perform the request.
1238
+ * @param clearObjects.indexName - Index on which to perform the request.
1239
1239
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1240
1240
  */
1241
1241
  clearObjects({ indexName }, requestOptions) {
@@ -1254,12 +1254,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1254
1254
  return transporter.request(request, requestOptions);
1255
1255
  },
1256
1256
  /**
1257
- * Delete all Rules in the index.
1257
+ * Delete all rules in the index.
1258
1258
  *
1259
- * @summary Clear Rules.
1259
+ * @summary Delete all rules.
1260
1260
  * @param clearRules - The clearRules object.
1261
- * @param clearRules.indexName - The index in which to perform the request.
1262
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1261
+ * @param clearRules.indexName - Index on which to perform the request.
1262
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1263
1263
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1264
1264
  */
1265
1265
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -1285,8 +1285,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1285
1285
  *
1286
1286
  * @summary Send requests to the Algolia REST API.
1287
1287
  * @param del - The del object.
1288
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1289
- * @param del.parameters - Query parameters to be applied to the current query.
1288
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
1289
+ * @param del.parameters - Query parameters to apply to the current query.
1290
1290
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1291
1291
  */
1292
1292
  del({ path, parameters }, requestOptions) {
@@ -1305,11 +1305,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1305
1305
  return transporter.request(request, requestOptions);
1306
1306
  },
1307
1307
  /**
1308
- * Delete an existing API Key.
1308
+ * Delete an existing API key. The request must be authenticated with the admin API key.
1309
1309
  *
1310
- * @summary Delete an API key.
1310
+ * @summary Delete API key.
1311
1311
  * @param deleteApiKey - The deleteApiKey object.
1312
- * @param deleteApiKey.key - API Key string.
1312
+ * @param deleteApiKey.key - API key.
1313
1313
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1314
1314
  */
1315
1315
  deleteApiKey({ key }, requestOptions) {
@@ -1328,11 +1328,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1328
1328
  return transporter.request(request, requestOptions);
1329
1329
  },
1330
1330
  /**
1331
- * Remove all objects matching a filter (including geo filters). This method enables you to delete one or more objects based on filters (numeric, facet, tag or geo queries). It doesn\'t accept empty filters or a query.
1331
+ * 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.
1332
1332
  *
1333
- * @summary Delete all records matching the query.
1333
+ * @summary Delete all records matching a query.
1334
1334
  * @param deleteBy - The deleteBy object.
1335
- * @param deleteBy.indexName - The index in which to perform the request.
1335
+ * @param deleteBy.indexName - Index on which to perform the request.
1336
1336
  * @param deleteBy.deleteByParams - The deleteByParams object.
1337
1337
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1338
1338
  */
@@ -1360,7 +1360,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1360
1360
  *
1361
1361
  * @summary Delete index.
1362
1362
  * @param deleteIndex - The deleteIndex object.
1363
- * @param deleteIndex.indexName - The index in which to perform the request.
1363
+ * @param deleteIndex.indexName - Index on which to perform the request.
1364
1364
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1365
1365
  */
1366
1366
  deleteIndex({ indexName }, requestOptions) {
@@ -1379,12 +1379,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1379
1379
  return transporter.request(request, requestOptions);
1380
1380
  },
1381
1381
  /**
1382
- * Delete an existing object.
1382
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
1383
1383
  *
1384
- * @summary Delete an object.
1384
+ * @summary Delete a record.
1385
1385
  * @param deleteObject - The deleteObject object.
1386
- * @param deleteObject.indexName - The index in which to perform the request.
1387
- * @param deleteObject.objectID - Unique identifier of an object.
1386
+ * @param deleteObject.indexName - Index on which to perform the request.
1387
+ * @param deleteObject.objectID - Unique record (object) identifier.
1388
1388
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1389
1389
  */
1390
1390
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -1408,13 +1408,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1408
1408
  return transporter.request(request, requestOptions);
1409
1409
  },
1410
1410
  /**
1411
- * Delete the Rule with the specified objectID.
1411
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
1412
1412
  *
1413
1413
  * @summary Delete a rule.
1414
1414
  * @param deleteRule - The deleteRule object.
1415
- * @param deleteRule.indexName - The index in which to perform the request.
1416
- * @param deleteRule.objectID - Unique identifier of an object.
1417
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1415
+ * @param deleteRule.indexName - Index on which to perform the request.
1416
+ * @param deleteRule.objectID - Unique identifier of a rule object.
1417
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1418
1418
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1419
1419
  */
1420
1420
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -1441,11 +1441,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1441
1441
  return transporter.request(request, requestOptions);
1442
1442
  },
1443
1443
  /**
1444
- * Remove a single source from the list of allowed sources.
1444
+ * Remove a source from the list of allowed sources.
1445
1445
  *
1446
- * @summary Remove a single source.
1446
+ * @summary Remove a source.
1447
1447
  * @param deleteSource - The deleteSource object.
1448
- * @param deleteSource.source - The IP range of the source.
1448
+ * @param deleteSource.source - IP address range of the source.
1449
1449
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1450
1450
  */
1451
1451
  deleteSource({ source }, requestOptions) {
@@ -1464,13 +1464,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1464
1464
  return transporter.request(request, requestOptions);
1465
1465
  },
1466
1466
  /**
1467
- * Delete a single synonyms set, identified by the given objectID.
1467
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
1468
1468
  *
1469
- * @summary Delete synonym.
1469
+ * @summary Delete a synonym.
1470
1470
  * @param deleteSynonym - The deleteSynonym object.
1471
- * @param deleteSynonym.indexName - The index in which to perform the request.
1472
- * @param deleteSynonym.objectID - Unique identifier of an object.
1473
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1471
+ * @param deleteSynonym.indexName - Index on which to perform the request.
1472
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
1473
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1474
1474
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1475
1475
  */
1476
1476
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -1501,8 +1501,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1501
1501
  *
1502
1502
  * @summary Send requests to the Algolia REST API.
1503
1503
  * @param get - The get object.
1504
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1505
- * @param get.parameters - Query parameters to be applied to the current query.
1504
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
1505
+ * @param get.parameters - Query parameters to apply to the current query.
1506
1506
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1507
1507
  */
1508
1508
  get({ path, parameters }, requestOptions) {
@@ -1521,11 +1521,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1521
1521
  return transporter.request(request, requestOptions);
1522
1522
  },
1523
1523
  /**
1524
- * Get the permissions of an API key.
1524
+ * 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.
1525
1525
  *
1526
- * @summary Get an API key.
1526
+ * @summary Get API key permissions.
1527
1527
  * @param getApiKey - The getApiKey object.
1528
- * @param getApiKey.key - API Key string.
1528
+ * @param getApiKey.key - API key.
1529
1529
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1530
1530
  */
1531
1531
  getApiKey({ key }, requestOptions) {
@@ -1544,7 +1544,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1544
1544
  return transporter.request(request, requestOptions);
1545
1545
  },
1546
1546
  /**
1547
- * List dictionaries supported per language.
1547
+ * 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.
1548
1548
  *
1549
1549
  * @summary List available languages.
1550
1550
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1562,9 +1562,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1562
1562
  return transporter.request(request, requestOptions);
1563
1563
  },
1564
1564
  /**
1565
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
1565
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
1566
1566
  *
1567
- * @summary Retrieve dictionaries settings.
1567
+ * @summary Get stop word settings.
1568
1568
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1569
1569
  */
1570
1570
  getDictionarySettings(requestOptions) {
@@ -1580,13 +1580,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1580
1580
  return transporter.request(request, requestOptions);
1581
1581
  },
1582
1582
  /**
1583
- * Return the latest log entries.
1583
+ * 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).
1584
1584
  *
1585
1585
  * @summary Return the latest log entries.
1586
1586
  * @param getLogs - The getLogs object.
1587
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
1588
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
1589
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
1587
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
1588
+ * @param getLogs.length - Maximum number of entries to retrieve.
1589
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
1590
1590
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
1591
1591
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1592
1592
  */
@@ -1615,13 +1615,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1615
1615
  return transporter.request(request, requestOptions);
1616
1616
  },
1617
1617
  /**
1618
- * Retrieve one object from the index.
1618
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
1619
1619
  *
1620
- * @summary Retrieve an object.
1620
+ * @summary Get a record.
1621
1621
  * @param getObject - The getObject object.
1622
- * @param getObject.indexName - The index in which to perform the request.
1623
- * @param getObject.objectID - Unique identifier of an object.
1624
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
1622
+ * @param getObject.indexName - Index on which to perform the request.
1623
+ * @param getObject.objectID - Unique record (object) identifier.
1624
+ * @param getObject.attributesToRetrieve - Attributes to include with the records in the response. This is useful to reduce the size of the API response. By default, all retrievable attributes are returned. `objectID` is always retrieved, even when not specified. [`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/) won\'t be retrieved unless the request is authenticated with the admin API key.
1625
1625
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1626
1626
  */
1627
1627
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -1648,10 +1648,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1648
1648
  return transporter.request(request, requestOptions);
1649
1649
  },
1650
1650
  /**
1651
- * Retrieve one or more objects, potentially from different indices, in a single API call.
1651
+ * 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.
1652
1652
  *
1653
- * @summary Retrieve one or more objects.
1654
- * @param getObjectsParams - The Algolia object.
1653
+ * @summary Get multiple records.
1654
+ * @param getObjectsParams - Request object.
1655
1655
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1656
1656
  */
1657
1657
  getObjects(getObjectsParams, requestOptions) {
@@ -1676,12 +1676,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1676
1676
  return transporter.request(request, requestOptions);
1677
1677
  },
1678
1678
  /**
1679
- * Retrieve the Rule with the specified objectID.
1679
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
1680
1680
  *
1681
1681
  * @summary Get a rule.
1682
1682
  * @param getRule - The getRule object.
1683
- * @param getRule.indexName - The index in which to perform the request.
1684
- * @param getRule.objectID - Unique identifier of an object.
1683
+ * @param getRule.indexName - Index on which to perform the request.
1684
+ * @param getRule.objectID - Unique identifier of a rule object.
1685
1685
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1686
1686
  */
1687
1687
  getRule({ indexName, objectID }, requestOptions) {
@@ -1705,11 +1705,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1705
1705
  return transporter.request(request, requestOptions);
1706
1706
  },
1707
1707
  /**
1708
- * Retrieve settings of an index.
1708
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
1709
1709
  *
1710
- * @summary Retrieve settings of an index.
1710
+ * @summary Get index settings.
1711
1711
  * @param getSettings - The getSettings object.
1712
- * @param getSettings.indexName - The index in which to perform the request.
1712
+ * @param getSettings.indexName - Index on which to perform the request.
1713
1713
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1714
1714
  */
1715
1715
  getSettings({ indexName }, requestOptions) {
@@ -1728,9 +1728,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1728
1728
  return transporter.request(request, requestOptions);
1729
1729
  },
1730
1730
  /**
1731
- * List all allowed sources.
1731
+ * Get all allowed sources (IP addresses).
1732
1732
  *
1733
- * @summary List all allowed sources.
1733
+ * @summary Get all allowed IP addresses.
1734
1734
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1735
1735
  */
1736
1736
  getSources(requestOptions) {
@@ -1746,12 +1746,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1746
1746
  return transporter.request(request, requestOptions);
1747
1747
  },
1748
1748
  /**
1749
- * Fetch a synonym object identified by its objectID.
1749
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
1750
1750
  *
1751
- * @summary Get synonym.
1751
+ * @summary Get a synonym object.
1752
1752
  * @param getSynonym - The getSynonym object.
1753
- * @param getSynonym.indexName - The index in which to perform the request.
1754
- * @param getSynonym.objectID - Unique identifier of an object.
1753
+ * @param getSynonym.indexName - Index on which to perform the request.
1754
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
1755
1755
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1756
1756
  */
1757
1757
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -1775,12 +1775,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1775
1775
  return transporter.request(request, requestOptions);
1776
1776
  },
1777
1777
  /**
1778
- * Check the current status of a given task.
1778
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
1779
1779
  *
1780
- * @summary Check the status of a task.
1780
+ * @summary Check a task\'s status.
1781
1781
  * @param getTask - The getTask object.
1782
- * @param getTask.indexName - The index in which to perform the request.
1783
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
1782
+ * @param getTask.indexName - Index on which to perform the request.
1783
+ * @param getTask.taskID - Unique task identifier.
1784
1784
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1785
1785
  */
1786
1786
  getTask({ indexName, taskID }, requestOptions) {
@@ -1804,7 +1804,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1804
1804
  return transporter.request(request, requestOptions);
1805
1805
  },
1806
1806
  /**
1807
- * Get the top 10 userIDs with the highest number of records per cluster. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following array of userIDs and clusters.
1807
+ * 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.
1808
1808
  *
1809
1809
  * @summary Get top userID.
1810
1810
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1822,7 +1822,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1822
1822
  return transporter.request(request, requestOptions);
1823
1823
  },
1824
1824
  /**
1825
- * Returns the userID data stored in the mapping. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following userID data.
1825
+ * 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.
1826
1826
  *
1827
1827
  * @summary Get userID.
1828
1828
  * @param getUserId - The getUserId object.
@@ -1845,11 +1845,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1845
1845
  return transporter.request(request, requestOptions);
1846
1846
  },
1847
1847
  /**
1848
- * Get the status of your clusters\' migrations or user creations. Creating a large batch of users or migrating your multi-cluster may take quite some time. This method lets you retrieve the status of the migration, so you can know when it\'s done. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userIDs are directly usable.
1848
+ * To determine when the time-consuming process of creating a large batch of users or migrating users from one cluster to another is complete, this operation retrieves the status of the process.
1849
1849
  *
1850
- * @summary Get migration status.
1850
+ * @summary Get migration and user mapping status.
1851
1851
  * @param hasPendingMappings - The hasPendingMappings object.
1852
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
1852
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
1853
1853
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1854
1854
  */
1855
1855
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -1868,9 +1868,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1868
1868
  return transporter.request(request, requestOptions);
1869
1869
  },
1870
1870
  /**
1871
- * List API keys, along with their associated rights.
1871
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
1872
1872
  *
1873
- * @summary List API Keys.
1873
+ * @summary List API keys.
1874
1874
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1875
1875
  */
1876
1876
  listApiKeys(requestOptions) {
@@ -1886,7 +1886,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1886
1886
  return transporter.request(request, requestOptions);
1887
1887
  },
1888
1888
  /**
1889
- * List the clusters available in a multi-clusters setup for a single appID. Upon success, the response is 200 OK and contains the following clusters.
1889
+ * List the available clusters in a multi-cluster setup.
1890
1890
  *
1891
1891
  * @summary List clusters.
1892
1892
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1904,20 +1904,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1904
1904
  return transporter.request(request, requestOptions);
1905
1905
  },
1906
1906
  /**
1907
- * List existing indexes from an application.
1907
+ * List indices in an Algolia application.
1908
1908
  *
1909
- * @summary List existing indexes.
1909
+ * @summary List indices.
1910
1910
  * @param listIndices - The listIndices object.
1911
- * @param listIndices.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
1911
+ * @param listIndices.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
1912
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
1912
1913
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1913
1914
  */
1914
- listIndices({ page } = {}, requestOptions = undefined) {
1915
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
1915
1916
  const requestPath = '/1/indexes';
1916
1917
  const headers = {};
1917
1918
  const queryParameters = {};
1918
1919
  if (page !== undefined) {
1919
1920
  queryParameters.page = page.toString();
1920
1921
  }
1922
+ if (hitsPerPage !== undefined) {
1923
+ queryParameters.hitsPerPage = hitsPerPage.toString();
1924
+ }
1921
1925
  const request = {
1922
1926
  method: 'GET',
1923
1927
  path: requestPath,
@@ -1927,12 +1931,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1927
1931
  return transporter.request(request, requestOptions);
1928
1932
  },
1929
1933
  /**
1930
- * List the userIDs assigned to a multi-clusters appID. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following userIDs data.
1934
+ * 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.
1931
1935
  *
1932
1936
  * @summary List userIDs.
1933
1937
  * @param listUserIds - The listUserIds object.
1934
- * @param listUserIds.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
1935
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
1938
+ * @param listUserIds.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
1939
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
1936
1940
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1937
1941
  */
1938
1942
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -1954,9 +1958,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1954
1958
  return transporter.request(request, requestOptions);
1955
1959
  },
1956
1960
  /**
1957
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
1961
+ * 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.
1958
1962
  *
1959
- * @summary Batch operations to many indices.
1963
+ * @summary Batch write operations on multiple indices.
1960
1964
  * @param batchParams - The batchParams object.
1961
1965
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1962
1966
  */
@@ -1980,11 +1984,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1980
1984
  return transporter.request(request, requestOptions);
1981
1985
  },
1982
1986
  /**
1983
- * Performs a copy or a move operation on a index.
1987
+ * 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/).
1984
1988
  *
1985
- * @summary Copy/move index.
1989
+ * @summary Copy, move, or rename an index.
1986
1990
  * @param operationIndex - The operationIndex object.
1987
- * @param operationIndex.indexName - The index in which to perform the request.
1991
+ * @param operationIndex.indexName - Index on which to perform the request.
1988
1992
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
1989
1993
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1990
1994
  */
@@ -2014,14 +2018,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2014
2018
  return transporter.request(request, requestOptions);
2015
2019
  },
2016
2020
  /**
2017
- * Update one or more attributes of an existing object. This method lets you update only a part of an existing object, either by adding new attributes or updating existing ones. You can partially update several objects in a single method call. If the index targeted by this operation doesn\'t exist yet, it\'s automatically created.
2021
+ * 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.
2018
2022
  *
2019
- * @summary Partially update an object.
2023
+ * @summary Update record attributes.
2020
2024
  * @param partialUpdateObject - The partialUpdateObject object.
2021
- * @param partialUpdateObject.indexName - The index in which to perform the request.
2022
- * @param partialUpdateObject.objectID - Unique identifier of an object.
2023
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
2024
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
2025
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
2026
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
2027
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
2028
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
2025
2029
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2026
2030
  */
2027
2031
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -2056,9 +2060,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2056
2060
  *
2057
2061
  * @summary Send requests to the Algolia REST API.
2058
2062
  * @param post - The post object.
2059
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2060
- * @param post.parameters - Query parameters to be applied to the current query.
2061
- * @param post.body - The parameters to send with the custom request.
2063
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
2064
+ * @param post.parameters - Query parameters to apply to the current query.
2065
+ * @param post.body - Parameters to send with the custom request.
2062
2066
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2063
2067
  */
2064
2068
  post({ path, parameters, body }, requestOptions) {
@@ -2082,9 +2086,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2082
2086
  *
2083
2087
  * @summary Send requests to the Algolia REST API.
2084
2088
  * @param put - The put object.
2085
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2086
- * @param put.parameters - Query parameters to be applied to the current query.
2087
- * @param put.body - The parameters to send with the custom request.
2089
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
2090
+ * @param put.parameters - Query parameters to apply to the current query.
2091
+ * @param put.body - Parameters to send with the custom request.
2088
2092
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2089
2093
  */
2090
2094
  put({ path, parameters, body }, requestOptions) {
@@ -2104,7 +2108,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2104
2108
  return transporter.request(request, requestOptions);
2105
2109
  },
2106
2110
  /**
2107
- * Remove a userID and its associated data from the multi-clusters. Upon success, the response is 200 OK and a task is created to remove the userID data and mapping.
2111
+ * Remove a userID and its associated data from the multi-clusters.
2108
2112
  *
2109
2113
  * @summary Remove userID.
2110
2114
  * @param removeUserId - The removeUserId object.
@@ -2129,9 +2133,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2129
2133
  /**
2130
2134
  * Replace all allowed sources.
2131
2135
  *
2132
- * @summary Replace all allowed sources.
2136
+ * @summary Replace all sources.
2133
2137
  * @param replaceSources - The replaceSources object.
2134
- * @param replaceSources.source - The sources to allow.
2138
+ * @param replaceSources.source - Allowed sources.
2135
2139
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2136
2140
  */
2137
2141
  replaceSources({ source }, requestOptions) {
@@ -2151,11 +2155,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2151
2155
  return transporter.request(request, requestOptions);
2152
2156
  },
2153
2157
  /**
2154
- * Restore a deleted API key, along with its associated rights.
2158
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
2155
2159
  *
2156
- * @summary Restore an API key.
2160
+ * @summary Restore API key.
2157
2161
  * @param restoreApiKey - The restoreApiKey object.
2158
- * @param restoreApiKey.key - API Key string.
2162
+ * @param restoreApiKey.key - API key.
2159
2163
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2160
2164
  */
2161
2165
  restoreApiKey({ key }, requestOptions) {
@@ -2174,11 +2178,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2174
2178
  return transporter.request(request, requestOptions);
2175
2179
  },
2176
2180
  /**
2177
- * Add an object to the index, automatically assigning it an object ID.
2181
+ * 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).
2178
2182
  *
2179
- * @summary Add an object to the index.
2183
+ * @summary Add or update a record.
2180
2184
  * @param saveObject - The saveObject object.
2181
- * @param saveObject.indexName - The index in which to perform the request.
2185
+ * @param saveObject.indexName - Index on which to perform the request.
2182
2186
  * @param saveObject.body - The Algolia record.
2183
2187
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2184
2188
  */
@@ -2202,14 +2206,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2202
2206
  return transporter.request(request, requestOptions);
2203
2207
  },
2204
2208
  /**
2205
- * Create or update the Rule with the specified objectID.
2209
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
2206
2210
  *
2207
- * @summary Save/Update a rule.
2211
+ * @summary Create or update a rule.
2208
2212
  * @param saveRule - The saveRule object.
2209
- * @param saveRule.indexName - The index in which to perform the request.
2210
- * @param saveRule.objectID - Unique identifier of an object.
2213
+ * @param saveRule.indexName - Index on which to perform the request.
2214
+ * @param saveRule.objectID - Unique identifier of a rule object.
2211
2215
  * @param saveRule.rule - The rule object.
2212
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2216
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2213
2217
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2214
2218
  */
2215
2219
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -2243,14 +2247,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2243
2247
  return transporter.request(request, requestOptions);
2244
2248
  },
2245
2249
  /**
2246
- * Create/update multiple rules objects at once.
2250
+ * Create or update multiple rules.
2247
2251
  *
2248
2252
  * @summary Save a batch of rules.
2249
2253
  * @param saveRules - The saveRules object.
2250
- * @param saveRules.indexName - The index in which to perform the request.
2254
+ * @param saveRules.indexName - Index on which to perform the request.
2251
2255
  * @param saveRules.rules - The rules object.
2252
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2253
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
2256
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2257
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
2254
2258
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2255
2259
  */
2256
2260
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -2279,14 +2283,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2279
2283
  return transporter.request(request, requestOptions);
2280
2284
  },
2281
2285
  /**
2282
- * Create a new synonym object or update the existing synonym object with the given object ID.
2286
+ * 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).
2283
2287
  *
2284
- * @summary Save synonym.
2288
+ * @summary Save a synonym.
2285
2289
  * @param saveSynonym - The saveSynonym object.
2286
- * @param saveSynonym.indexName - The index in which to perform the request.
2287
- * @param saveSynonym.objectID - Unique identifier of an object.
2290
+ * @param saveSynonym.indexName - Index on which to perform the request.
2291
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
2288
2292
  * @param saveSynonym.synonymHit - The synonymHit object.
2289
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2293
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2290
2294
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2291
2295
  */
2292
2296
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -2323,14 +2327,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2323
2327
  return transporter.request(request, requestOptions);
2324
2328
  },
2325
2329
  /**
2326
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
2330
+ * Create or update multiple synonyms.
2327
2331
  *
2328
2332
  * @summary Save a batch of synonyms.
2329
2333
  * @param saveSynonyms - The saveSynonyms object.
2330
- * @param saveSynonyms.indexName - The index in which to perform the request.
2334
+ * @param saveSynonyms.indexName - Index on which to perform the request.
2331
2335
  * @param saveSynonyms.synonymHit - The synonymHit object.
2332
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2333
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
2336
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2337
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
2334
2338
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2335
2339
  */
2336
2340
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -2360,10 +2364,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2360
2364
  return transporter.request(request, requestOptions);
2361
2365
  },
2362
2366
  /**
2363
- * Perform a search operation targeting one or many indices.
2367
+ * Send multiple search queries to one or more indices.
2364
2368
  *
2365
2369
  * @summary Search multiple indices.
2366
- * @param searchMethodParams - The `search` requests and strategy.
2370
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
2367
2371
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2368
2372
  */
2369
2373
  search(searchMethodParams, requestOptions) {
@@ -2410,11 +2414,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2410
2414
  return transporter.request(request, requestOptions);
2411
2415
  },
2412
2416
  /**
2413
- * Search the dictionary entries.
2417
+ * 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.
2414
2418
  *
2415
- * @summary Search a dictionary entries.
2419
+ * @summary Search dictionary entries.
2416
2420
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
2417
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
2421
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
2418
2422
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
2419
2423
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2420
2424
  */
@@ -2443,12 +2447,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2443
2447
  return transporter.request(request, requestOptions);
2444
2448
  },
2445
2449
  /**
2446
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
2450
+ * [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`.
2447
2451
  *
2448
- * @summary Search for values of a given facet.
2452
+ * @summary Search for facet values.
2449
2453
  * @param searchForFacetValues - The searchForFacetValues object.
2450
- * @param searchForFacetValues.indexName - The index in which to perform the request.
2451
- * @param searchForFacetValues.facetName - The facet name.
2454
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
2455
+ * @param searchForFacetValues.facetName - Facet name.
2452
2456
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
2453
2457
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2454
2458
  */
@@ -2476,11 +2480,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2476
2480
  return transporter.request(request, requestOptions);
2477
2481
  },
2478
2482
  /**
2479
- * Search for rules matching various criteria.
2483
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
2480
2484
  *
2481
2485
  * @summary Search for rules.
2482
2486
  * @param searchRules - The searchRules object.
2483
- * @param searchRules.indexName - The index in which to perform the request.
2487
+ * @param searchRules.indexName - Index on which to perform the request.
2484
2488
  * @param searchRules.searchRulesParams - The searchRulesParams object.
2485
2489
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2486
2490
  */
@@ -2503,11 +2507,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2503
2507
  return transporter.request(request, requestOptions);
2504
2508
  },
2505
2509
  /**
2506
- * Perform a search operation targeting one specific index.
2510
+ * Return records that match the query.
2507
2511
  *
2508
- * @summary Search in a single index.
2512
+ * @summary Search an index.
2509
2513
  * @param searchSingleIndex - The searchSingleIndex object.
2510
- * @param searchSingleIndex.indexName - The index in which to perform the request.
2514
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
2511
2515
  * @param searchSingleIndex.searchParams - The searchParams object.
2512
2516
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2513
2517
  */
@@ -2530,15 +2534,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2530
2534
  return transporter.request(request, requestOptions);
2531
2535
  },
2532
2536
  /**
2533
- * Search or browse all synonyms, optionally filtering them by type.
2537
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
2534
2538
  *
2535
- * @summary Search synonyms.
2539
+ * @summary Search for synonyms.
2536
2540
  * @param searchSynonyms - The searchSynonyms object.
2537
- * @param searchSynonyms.indexName - The index in which to perform the request.
2538
- * @param searchSynonyms.type - Only search for specific types of synonyms.
2539
- * @param searchSynonyms.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
2540
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
2541
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
2541
+ * @param searchSynonyms.indexName - Index on which to perform the request.
2542
+ * @param searchSynonyms.type - Search for specific [types of synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
2543
+ * @param searchSynonyms.page - Returns the requested page number (the first page is 0). Page size is set by `hitsPerPage`. When null, there\'s no pagination.
2544
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
2545
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
2542
2546
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2543
2547
  */
2544
2548
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -2569,9 +2573,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2569
2573
  return transporter.request(request, requestOptions);
2570
2574
  },
2571
2575
  /**
2572
- * Search for userIDs. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds propagate to the different clusters. To keep updates moving quickly, the index of userIDs isn\'t built synchronously with the mapping. Instead, the index is built once every 12h, at the same time as the update of userID usage. For example, when you perform a modification like adding or moving a userID, the search will report an outdated value until the next rebuild of the mapping, which takes place every 12h. Upon success, the response is 200 OK and contains the following userIDs data.
2576
+ * 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).
2573
2577
  *
2574
- * @summary Search userID.
2578
+ * @summary Search for a user ID.
2575
2579
  * @param searchUserIdsParams - The searchUserIdsParams object.
2576
2580
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2577
2581
  */
@@ -2597,9 +2601,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2597
2601
  return transporter.request(request, requestOptions);
2598
2602
  },
2599
2603
  /**
2600
- * Set dictionaries settings.
2604
+ * Set stop word settings for a specific language.
2601
2605
  *
2602
- * @summary Set dictionaries settings.
2606
+ * @summary Set stop word settings.
2603
2607
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
2604
2608
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2605
2609
  */
@@ -2623,13 +2627,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2623
2627
  return transporter.request(request, requestOptions);
2624
2628
  },
2625
2629
  /**
2626
- * Update settings of an index. Only specified settings are overridden; unspecified settings are left unchanged. Specifying null for a setting resets it to its default value.
2630
+ * 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.
2627
2631
  *
2628
- * @summary Update settings of an index.
2632
+ * @summary Update index settings.
2629
2633
  * @param setSettings - The setSettings object.
2630
- * @param setSettings.indexName - The index in which to perform the request.
2634
+ * @param setSettings.indexName - Index on which to perform the request.
2631
2635
  * @param setSettings.indexSettings - The indexSettings object.
2632
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2636
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2633
2637
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2634
2638
  */
2635
2639
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -2655,11 +2659,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2655
2659
  return transporter.request(request, requestOptions);
2656
2660
  },
2657
2661
  /**
2658
- * Replace every permission of an existing API key.
2662
+ * 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.
2659
2663
  *
2660
2664
  * @summary Update an API key.
2661
2665
  * @param updateApiKey - The updateApiKey object.
2662
- * @param updateApiKey.key - API Key string.
2666
+ * @param updateApiKey.key - API key.
2663
2667
  * @param updateApiKey.apiKey - The apiKey object.
2664
2668
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2665
2669
  */