@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
@@ -2,7 +2,7 @@ import { createAuth, createTransporter, getAlgoliaAgent, createIterablePromise,
2
2
  import { createHttpRequester } from '@algolia/requester-node-http';
3
3
 
4
4
  // 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.
5
- const apiClientVersion = '5.0.0-alpha.73';
5
+ const apiClientVersion = '5.0.0-alpha.76';
6
6
  function getDefaultHosts(appId) {
7
7
  return [
8
8
  {
@@ -249,9 +249,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
249
249
  });
250
250
  },
251
251
  /**
252
- * Add a new API Key with specific permissions/restrictions.
252
+ * 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.
253
253
  *
254
- * @summary Create an API key.
254
+ * @summary Add API key.
255
255
  * @param apiKey - The apiKey object.
256
256
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
257
257
  */
@@ -275,13 +275,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
275
275
  return transporter.request(request, requestOptions);
276
276
  },
277
277
  /**
278
- * 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.
278
+ * 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).
279
279
  *
280
- * @summary Add or replace an object.
280
+ * @summary Add or update a record (using objectID).
281
281
  * @param addOrUpdateObject - The addOrUpdateObject object.
282
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
283
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
284
- * @param addOrUpdateObject.body - The Algolia object.
282
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
283
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
284
+ * @param addOrUpdateObject.body - Algolia record.
285
285
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
286
286
  */
287
287
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -309,10 +309,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
309
309
  return transporter.request(request, requestOptions);
310
310
  },
311
311
  /**
312
- * Add a single source to the list of allowed sources.
312
+ * Add a source to the list of allowed sources.
313
313
  *
314
- * @summary Add a single source.
315
- * @param source - The source to add.
314
+ * @summary Add a source.
315
+ * @param source - Source to add.
316
316
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
317
317
  */
318
318
  appendSource(source, requestOptions) {
@@ -335,9 +335,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
335
335
  return transporter.request(request, requestOptions);
336
336
  },
337
337
  /**
338
- * 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.
338
+ * 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.
339
339
  *
340
- * @summary Assign or Move userID.
340
+ * @summary Assign or move a user ID.
341
341
  * @param assignUserId - The assignUserId object.
342
342
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
343
343
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -369,11 +369,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
369
369
  return transporter.request(request, requestOptions);
370
370
  },
371
371
  /**
372
- * Perform multiple write operations targeting one index, in a single API call.
372
+ * 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.
373
373
  *
374
- * @summary Batch operations to one index.
374
+ * @summary Batch write operations on one index.
375
375
  * @param batch - The batch object.
376
- * @param batch.indexName - The index in which to perform the request.
376
+ * @param batch.indexName - Index on which to perform the request.
377
377
  * @param batch.batchWriteParams - The batchWriteParams object.
378
378
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
379
379
  */
@@ -400,7 +400,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
400
400
  return transporter.request(request, requestOptions);
401
401
  },
402
402
  /**
403
- * 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.
403
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
404
404
  *
405
405
  * @summary Batch assign userIDs.
406
406
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -437,11 +437,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
437
437
  return transporter.request(request, requestOptions);
438
438
  },
439
439
  /**
440
- * Send a batch of dictionary entries.
440
+ * Add or remove a batch of dictionary entries.
441
441
  *
442
442
  * @summary Batch dictionary entries.
443
443
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
444
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
444
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
445
445
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
446
446
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
447
447
  */
@@ -468,11 +468,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
468
468
  return transporter.request(request, requestOptions);
469
469
  },
470
470
  /**
471
- * 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.
471
+ * 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.
472
472
  *
473
- * @summary Retrieve all index content.
473
+ * @summary Get all records from an index.
474
474
  * @param browse - The browse object.
475
- * @param browse.indexName - The index in which to perform the request.
475
+ * @param browse.indexName - Index on which to perform the request.
476
476
  * @param browse.browseParams - The browseParams object.
477
477
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
478
478
  */
@@ -493,12 +493,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
493
493
  return transporter.request(request, requestOptions);
494
494
  },
495
495
  /**
496
- * Remove all synonyms from an index.
496
+ * Delete all synonyms in the index.
497
497
  *
498
- * @summary Clear all synonyms.
498
+ * @summary Delete all synonyms.
499
499
  * @param clearAllSynonyms - The clearAllSynonyms object.
500
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
501
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
500
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
501
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
502
502
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
503
503
  */
504
504
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -520,11 +520,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
520
520
  return transporter.request(request, requestOptions);
521
521
  },
522
522
  /**
523
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
523
+ * Delete the records but leave settings and index-specific API keys untouched.
524
524
  *
525
- * @summary Clear all objects from an index.
525
+ * @summary Delete all records from an index.
526
526
  * @param clearObjects - The clearObjects object.
527
- * @param clearObjects.indexName - The index in which to perform the request.
527
+ * @param clearObjects.indexName - Index on which to perform the request.
528
528
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
529
529
  */
530
530
  clearObjects({ indexName }, requestOptions) {
@@ -543,12 +543,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
543
543
  return transporter.request(request, requestOptions);
544
544
  },
545
545
  /**
546
- * Delete all Rules in the index.
546
+ * Delete all rules in the index.
547
547
  *
548
- * @summary Clear Rules.
548
+ * @summary Delete all rules.
549
549
  * @param clearRules - The clearRules object.
550
- * @param clearRules.indexName - The index in which to perform the request.
551
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
550
+ * @param clearRules.indexName - Index on which to perform the request.
551
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
552
552
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
553
553
  */
554
554
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -574,8 +574,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
574
574
  *
575
575
  * @summary Send requests to the Algolia REST API.
576
576
  * @param del - The del object.
577
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
578
- * @param del.parameters - Query parameters to be applied to the current query.
577
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
578
+ * @param del.parameters - Query parameters to apply to the current query.
579
579
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
580
580
  */
581
581
  del({ path, parameters }, requestOptions) {
@@ -594,11 +594,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
594
594
  return transporter.request(request, requestOptions);
595
595
  },
596
596
  /**
597
- * Delete an existing API Key.
597
+ * Delete an existing API key. The request must be authenticated with the admin API key.
598
598
  *
599
- * @summary Delete an API key.
599
+ * @summary Delete API key.
600
600
  * @param deleteApiKey - The deleteApiKey object.
601
- * @param deleteApiKey.key - API Key string.
601
+ * @param deleteApiKey.key - API key.
602
602
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
603
603
  */
604
604
  deleteApiKey({ key }, requestOptions) {
@@ -617,11 +617,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
617
617
  return transporter.request(request, requestOptions);
618
618
  },
619
619
  /**
620
- * 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.
620
+ * 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.
621
621
  *
622
- * @summary Delete all records matching the query.
622
+ * @summary Delete all records matching a query.
623
623
  * @param deleteBy - The deleteBy object.
624
- * @param deleteBy.indexName - The index in which to perform the request.
624
+ * @param deleteBy.indexName - Index on which to perform the request.
625
625
  * @param deleteBy.deleteByParams - The deleteByParams object.
626
626
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
627
627
  */
@@ -649,7 +649,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
649
649
  *
650
650
  * @summary Delete index.
651
651
  * @param deleteIndex - The deleteIndex object.
652
- * @param deleteIndex.indexName - The index in which to perform the request.
652
+ * @param deleteIndex.indexName - Index on which to perform the request.
653
653
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
654
654
  */
655
655
  deleteIndex({ indexName }, requestOptions) {
@@ -668,12 +668,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
668
668
  return transporter.request(request, requestOptions);
669
669
  },
670
670
  /**
671
- * Delete an existing object.
671
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
672
672
  *
673
- * @summary Delete an object.
673
+ * @summary Delete a record.
674
674
  * @param deleteObject - The deleteObject object.
675
- * @param deleteObject.indexName - The index in which to perform the request.
676
- * @param deleteObject.objectID - Unique identifier of an object.
675
+ * @param deleteObject.indexName - Index on which to perform the request.
676
+ * @param deleteObject.objectID - Unique record (object) identifier.
677
677
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
678
678
  */
679
679
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -697,13 +697,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
697
697
  return transporter.request(request, requestOptions);
698
698
  },
699
699
  /**
700
- * Delete the Rule with the specified objectID.
700
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
701
701
  *
702
702
  * @summary Delete a rule.
703
703
  * @param deleteRule - The deleteRule object.
704
- * @param deleteRule.indexName - The index in which to perform the request.
705
- * @param deleteRule.objectID - Unique identifier of an object.
706
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
704
+ * @param deleteRule.indexName - Index on which to perform the request.
705
+ * @param deleteRule.objectID - Unique identifier of a rule object.
706
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
707
707
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
708
708
  */
709
709
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -730,11 +730,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
730
730
  return transporter.request(request, requestOptions);
731
731
  },
732
732
  /**
733
- * Remove a single source from the list of allowed sources.
733
+ * Remove a source from the list of allowed sources.
734
734
  *
735
- * @summary Remove a single source.
735
+ * @summary Remove a source.
736
736
  * @param deleteSource - The deleteSource object.
737
- * @param deleteSource.source - The IP range of the source.
737
+ * @param deleteSource.source - IP address range of the source.
738
738
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
739
739
  */
740
740
  deleteSource({ source }, requestOptions) {
@@ -753,13 +753,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
753
753
  return transporter.request(request, requestOptions);
754
754
  },
755
755
  /**
756
- * Delete a single synonyms set, identified by the given objectID.
756
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
757
757
  *
758
- * @summary Delete synonym.
758
+ * @summary Delete a synonym.
759
759
  * @param deleteSynonym - The deleteSynonym object.
760
- * @param deleteSynonym.indexName - The index in which to perform the request.
761
- * @param deleteSynonym.objectID - Unique identifier of an object.
762
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
760
+ * @param deleteSynonym.indexName - Index on which to perform the request.
761
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
762
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
763
763
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
764
764
  */
765
765
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -790,8 +790,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
790
790
  *
791
791
  * @summary Send requests to the Algolia REST API.
792
792
  * @param get - The get object.
793
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
794
- * @param get.parameters - Query parameters to be applied to the current query.
793
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
794
+ * @param get.parameters - Query parameters to apply to the current query.
795
795
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
796
796
  */
797
797
  get({ path, parameters }, requestOptions) {
@@ -810,11 +810,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
810
810
  return transporter.request(request, requestOptions);
811
811
  },
812
812
  /**
813
- * Get the permissions of an API key.
813
+ * 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.
814
814
  *
815
- * @summary Get an API key.
815
+ * @summary Get API key permissions.
816
816
  * @param getApiKey - The getApiKey object.
817
- * @param getApiKey.key - API Key string.
817
+ * @param getApiKey.key - API key.
818
818
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
819
819
  */
820
820
  getApiKey({ key }, requestOptions) {
@@ -833,7 +833,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
833
833
  return transporter.request(request, requestOptions);
834
834
  },
835
835
  /**
836
- * List dictionaries supported per language.
836
+ * 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.
837
837
  *
838
838
  * @summary List available languages.
839
839
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -851,9 +851,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
851
851
  return transporter.request(request, requestOptions);
852
852
  },
853
853
  /**
854
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
854
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
855
855
  *
856
- * @summary Retrieve dictionaries settings.
856
+ * @summary Get stop word settings.
857
857
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
858
858
  */
859
859
  getDictionarySettings(requestOptions) {
@@ -869,13 +869,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
869
869
  return transporter.request(request, requestOptions);
870
870
  },
871
871
  /**
872
- * Return the latest log entries.
872
+ * 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).
873
873
  *
874
874
  * @summary Return the latest log entries.
875
875
  * @param getLogs - The getLogs object.
876
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
877
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
878
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
876
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
877
+ * @param getLogs.length - Maximum number of entries to retrieve.
878
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
879
879
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
880
880
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
881
881
  */
@@ -904,13 +904,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
904
904
  return transporter.request(request, requestOptions);
905
905
  },
906
906
  /**
907
- * Retrieve one object from the index.
907
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
908
908
  *
909
- * @summary Retrieve an object.
909
+ * @summary Get a record.
910
910
  * @param getObject - The getObject object.
911
- * @param getObject.indexName - The index in which to perform the request.
912
- * @param getObject.objectID - Unique identifier of an object.
913
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
911
+ * @param getObject.indexName - Index on which to perform the request.
912
+ * @param getObject.objectID - Unique record (object) identifier.
913
+ * @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.
914
914
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
915
915
  */
916
916
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -937,10 +937,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
937
937
  return transporter.request(request, requestOptions);
938
938
  },
939
939
  /**
940
- * Retrieve one or more objects, potentially from different indices, in a single API call.
940
+ * 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.
941
941
  *
942
- * @summary Retrieve one or more objects.
943
- * @param getObjectsParams - The Algolia object.
942
+ * @summary Get multiple records.
943
+ * @param getObjectsParams - Request object.
944
944
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
945
945
  */
946
946
  getObjects(getObjectsParams, requestOptions) {
@@ -965,12 +965,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
965
965
  return transporter.request(request, requestOptions);
966
966
  },
967
967
  /**
968
- * Retrieve the Rule with the specified objectID.
968
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
969
969
  *
970
970
  * @summary Get a rule.
971
971
  * @param getRule - The getRule object.
972
- * @param getRule.indexName - The index in which to perform the request.
973
- * @param getRule.objectID - Unique identifier of an object.
972
+ * @param getRule.indexName - Index on which to perform the request.
973
+ * @param getRule.objectID - Unique identifier of a rule object.
974
974
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
975
975
  */
976
976
  getRule({ indexName, objectID }, requestOptions) {
@@ -994,11 +994,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
994
994
  return transporter.request(request, requestOptions);
995
995
  },
996
996
  /**
997
- * Retrieve settings of an index.
997
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
998
998
  *
999
- * @summary Retrieve settings of an index.
999
+ * @summary Get index settings.
1000
1000
  * @param getSettings - The getSettings object.
1001
- * @param getSettings.indexName - The index in which to perform the request.
1001
+ * @param getSettings.indexName - Index on which to perform the request.
1002
1002
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1003
1003
  */
1004
1004
  getSettings({ indexName }, requestOptions) {
@@ -1017,9 +1017,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1017
1017
  return transporter.request(request, requestOptions);
1018
1018
  },
1019
1019
  /**
1020
- * List all allowed sources.
1020
+ * Get all allowed sources (IP addresses).
1021
1021
  *
1022
- * @summary List all allowed sources.
1022
+ * @summary Get all allowed IP addresses.
1023
1023
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1024
1024
  */
1025
1025
  getSources(requestOptions) {
@@ -1035,12 +1035,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1035
1035
  return transporter.request(request, requestOptions);
1036
1036
  },
1037
1037
  /**
1038
- * Fetch a synonym object identified by its objectID.
1038
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
1039
1039
  *
1040
- * @summary Get synonym.
1040
+ * @summary Get a synonym object.
1041
1041
  * @param getSynonym - The getSynonym object.
1042
- * @param getSynonym.indexName - The index in which to perform the request.
1043
- * @param getSynonym.objectID - Unique identifier of an object.
1042
+ * @param getSynonym.indexName - Index on which to perform the request.
1043
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
1044
1044
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1045
1045
  */
1046
1046
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -1064,12 +1064,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1064
1064
  return transporter.request(request, requestOptions);
1065
1065
  },
1066
1066
  /**
1067
- * Check the current status of a given task.
1067
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
1068
1068
  *
1069
- * @summary Check the status of a task.
1069
+ * @summary Check a task\'s status.
1070
1070
  * @param getTask - The getTask object.
1071
- * @param getTask.indexName - The index in which to perform the request.
1072
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
1071
+ * @param getTask.indexName - Index on which to perform the request.
1072
+ * @param getTask.taskID - Unique task identifier.
1073
1073
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1074
1074
  */
1075
1075
  getTask({ indexName, taskID }, requestOptions) {
@@ -1093,7 +1093,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1093
1093
  return transporter.request(request, requestOptions);
1094
1094
  },
1095
1095
  /**
1096
- * 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.
1096
+ * 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.
1097
1097
  *
1098
1098
  * @summary Get top userID.
1099
1099
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1111,7 +1111,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1111
1111
  return transporter.request(request, requestOptions);
1112
1112
  },
1113
1113
  /**
1114
- * 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.
1114
+ * 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.
1115
1115
  *
1116
1116
  * @summary Get userID.
1117
1117
  * @param getUserId - The getUserId object.
@@ -1134,11 +1134,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1134
1134
  return transporter.request(request, requestOptions);
1135
1135
  },
1136
1136
  /**
1137
- * 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.
1137
+ * 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.
1138
1138
  *
1139
- * @summary Get migration status.
1139
+ * @summary Get migration and user mapping status.
1140
1140
  * @param hasPendingMappings - The hasPendingMappings object.
1141
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
1141
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
1142
1142
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1143
1143
  */
1144
1144
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -1157,9 +1157,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1157
1157
  return transporter.request(request, requestOptions);
1158
1158
  },
1159
1159
  /**
1160
- * List API keys, along with their associated rights.
1160
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
1161
1161
  *
1162
- * @summary List API Keys.
1162
+ * @summary List API keys.
1163
1163
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1164
1164
  */
1165
1165
  listApiKeys(requestOptions) {
@@ -1175,7 +1175,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1175
1175
  return transporter.request(request, requestOptions);
1176
1176
  },
1177
1177
  /**
1178
- * 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.
1178
+ * List the available clusters in a multi-cluster setup.
1179
1179
  *
1180
1180
  * @summary List clusters.
1181
1181
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1193,20 +1193,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1193
1193
  return transporter.request(request, requestOptions);
1194
1194
  },
1195
1195
  /**
1196
- * List existing indexes from an application.
1196
+ * List indices in an Algolia application.
1197
1197
  *
1198
- * @summary List existing indexes.
1198
+ * @summary List indices.
1199
1199
  * @param listIndices - The listIndices object.
1200
- * @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).
1200
+ * @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.
1201
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
1201
1202
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1202
1203
  */
1203
- listIndices({ page } = {}, requestOptions = undefined) {
1204
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
1204
1205
  const requestPath = '/1/indexes';
1205
1206
  const headers = {};
1206
1207
  const queryParameters = {};
1207
1208
  if (page !== undefined) {
1208
1209
  queryParameters.page = page.toString();
1209
1210
  }
1211
+ if (hitsPerPage !== undefined) {
1212
+ queryParameters.hitsPerPage = hitsPerPage.toString();
1213
+ }
1210
1214
  const request = {
1211
1215
  method: 'GET',
1212
1216
  path: requestPath,
@@ -1216,12 +1220,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1216
1220
  return transporter.request(request, requestOptions);
1217
1221
  },
1218
1222
  /**
1219
- * 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.
1223
+ * 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.
1220
1224
  *
1221
1225
  * @summary List userIDs.
1222
1226
  * @param listUserIds - The listUserIds object.
1223
- * @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).
1224
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
1227
+ * @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.
1228
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
1225
1229
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1226
1230
  */
1227
1231
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -1243,9 +1247,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1243
1247
  return transporter.request(request, requestOptions);
1244
1248
  },
1245
1249
  /**
1246
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
1250
+ * 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.
1247
1251
  *
1248
- * @summary Batch operations to many indices.
1252
+ * @summary Batch write operations on multiple indices.
1249
1253
  * @param batchParams - The batchParams object.
1250
1254
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1251
1255
  */
@@ -1269,11 +1273,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1269
1273
  return transporter.request(request, requestOptions);
1270
1274
  },
1271
1275
  /**
1272
- * Performs a copy or a move operation on a index.
1276
+ * 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/).
1273
1277
  *
1274
- * @summary Copy/move index.
1278
+ * @summary Copy, move, or rename an index.
1275
1279
  * @param operationIndex - The operationIndex object.
1276
- * @param operationIndex.indexName - The index in which to perform the request.
1280
+ * @param operationIndex.indexName - Index on which to perform the request.
1277
1281
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
1278
1282
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1279
1283
  */
@@ -1303,14 +1307,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1303
1307
  return transporter.request(request, requestOptions);
1304
1308
  },
1305
1309
  /**
1306
- * 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.
1310
+ * 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.
1307
1311
  *
1308
- * @summary Partially update an object.
1312
+ * @summary Update record attributes.
1309
1313
  * @param partialUpdateObject - The partialUpdateObject object.
1310
- * @param partialUpdateObject.indexName - The index in which to perform the request.
1311
- * @param partialUpdateObject.objectID - Unique identifier of an object.
1312
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
1313
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
1314
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
1315
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
1316
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
1317
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
1314
1318
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1315
1319
  */
1316
1320
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -1345,9 +1349,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1345
1349
  *
1346
1350
  * @summary Send requests to the Algolia REST API.
1347
1351
  * @param post - The post object.
1348
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1349
- * @param post.parameters - Query parameters to be applied to the current query.
1350
- * @param post.body - The parameters to send with the custom request.
1352
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1353
+ * @param post.parameters - Query parameters to apply to the current query.
1354
+ * @param post.body - Parameters to send with the custom request.
1351
1355
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1352
1356
  */
1353
1357
  post({ path, parameters, body }, requestOptions) {
@@ -1371,9 +1375,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1371
1375
  *
1372
1376
  * @summary Send requests to the Algolia REST API.
1373
1377
  * @param put - The put object.
1374
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1375
- * @param put.parameters - Query parameters to be applied to the current query.
1376
- * @param put.body - The parameters to send with the custom request.
1378
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1379
+ * @param put.parameters - Query parameters to apply to the current query.
1380
+ * @param put.body - Parameters to send with the custom request.
1377
1381
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1378
1382
  */
1379
1383
  put({ path, parameters, body }, requestOptions) {
@@ -1393,7 +1397,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1393
1397
  return transporter.request(request, requestOptions);
1394
1398
  },
1395
1399
  /**
1396
- * 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.
1400
+ * Remove a userID and its associated data from the multi-clusters.
1397
1401
  *
1398
1402
  * @summary Remove userID.
1399
1403
  * @param removeUserId - The removeUserId object.
@@ -1418,9 +1422,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1418
1422
  /**
1419
1423
  * Replace all allowed sources.
1420
1424
  *
1421
- * @summary Replace all allowed sources.
1425
+ * @summary Replace all sources.
1422
1426
  * @param replaceSources - The replaceSources object.
1423
- * @param replaceSources.source - The sources to allow.
1427
+ * @param replaceSources.source - Allowed sources.
1424
1428
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1425
1429
  */
1426
1430
  replaceSources({ source }, requestOptions) {
@@ -1440,11 +1444,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1440
1444
  return transporter.request(request, requestOptions);
1441
1445
  },
1442
1446
  /**
1443
- * Restore a deleted API key, along with its associated rights.
1447
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
1444
1448
  *
1445
- * @summary Restore an API key.
1449
+ * @summary Restore API key.
1446
1450
  * @param restoreApiKey - The restoreApiKey object.
1447
- * @param restoreApiKey.key - API Key string.
1451
+ * @param restoreApiKey.key - API key.
1448
1452
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1449
1453
  */
1450
1454
  restoreApiKey({ key }, requestOptions) {
@@ -1463,11 +1467,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1463
1467
  return transporter.request(request, requestOptions);
1464
1468
  },
1465
1469
  /**
1466
- * Add an object to the index, automatically assigning it an object ID.
1470
+ * 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).
1467
1471
  *
1468
- * @summary Add an object to the index.
1472
+ * @summary Add or update a record.
1469
1473
  * @param saveObject - The saveObject object.
1470
- * @param saveObject.indexName - The index in which to perform the request.
1474
+ * @param saveObject.indexName - Index on which to perform the request.
1471
1475
  * @param saveObject.body - The Algolia record.
1472
1476
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1473
1477
  */
@@ -1491,14 +1495,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1491
1495
  return transporter.request(request, requestOptions);
1492
1496
  },
1493
1497
  /**
1494
- * Create or update the Rule with the specified objectID.
1498
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
1495
1499
  *
1496
- * @summary Save/Update a rule.
1500
+ * @summary Create or update a rule.
1497
1501
  * @param saveRule - The saveRule object.
1498
- * @param saveRule.indexName - The index in which to perform the request.
1499
- * @param saveRule.objectID - Unique identifier of an object.
1502
+ * @param saveRule.indexName - Index on which to perform the request.
1503
+ * @param saveRule.objectID - Unique identifier of a rule object.
1500
1504
  * @param saveRule.rule - The rule object.
1501
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1505
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1502
1506
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1503
1507
  */
1504
1508
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -1532,14 +1536,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1532
1536
  return transporter.request(request, requestOptions);
1533
1537
  },
1534
1538
  /**
1535
- * Create/update multiple rules objects at once.
1539
+ * Create or update multiple rules.
1536
1540
  *
1537
1541
  * @summary Save a batch of rules.
1538
1542
  * @param saveRules - The saveRules object.
1539
- * @param saveRules.indexName - The index in which to perform the request.
1543
+ * @param saveRules.indexName - Index on which to perform the request.
1540
1544
  * @param saveRules.rules - The rules object.
1541
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1542
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
1545
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1546
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
1543
1547
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1544
1548
  */
1545
1549
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -1568,14 +1572,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1568
1572
  return transporter.request(request, requestOptions);
1569
1573
  },
1570
1574
  /**
1571
- * Create a new synonym object or update the existing synonym object with the given object ID.
1575
+ * 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).
1572
1576
  *
1573
- * @summary Save synonym.
1577
+ * @summary Save a synonym.
1574
1578
  * @param saveSynonym - The saveSynonym object.
1575
- * @param saveSynonym.indexName - The index in which to perform the request.
1576
- * @param saveSynonym.objectID - Unique identifier of an object.
1579
+ * @param saveSynonym.indexName - Index on which to perform the request.
1580
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
1577
1581
  * @param saveSynonym.synonymHit - The synonymHit object.
1578
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1582
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1579
1583
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1580
1584
  */
1581
1585
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -1612,14 +1616,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1612
1616
  return transporter.request(request, requestOptions);
1613
1617
  },
1614
1618
  /**
1615
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
1619
+ * Create or update multiple synonyms.
1616
1620
  *
1617
1621
  * @summary Save a batch of synonyms.
1618
1622
  * @param saveSynonyms - The saveSynonyms object.
1619
- * @param saveSynonyms.indexName - The index in which to perform the request.
1623
+ * @param saveSynonyms.indexName - Index on which to perform the request.
1620
1624
  * @param saveSynonyms.synonymHit - The synonymHit object.
1621
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1622
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
1625
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1626
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
1623
1627
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1624
1628
  */
1625
1629
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -1649,10 +1653,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1649
1653
  return transporter.request(request, requestOptions);
1650
1654
  },
1651
1655
  /**
1652
- * Perform a search operation targeting one or many indices.
1656
+ * Send multiple search queries to one or more indices.
1653
1657
  *
1654
1658
  * @summary Search multiple indices.
1655
- * @param searchMethodParams - The `search` requests and strategy.
1659
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
1656
1660
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1657
1661
  */
1658
1662
  search(searchMethodParams, requestOptions) {
@@ -1699,11 +1703,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1699
1703
  return transporter.request(request, requestOptions);
1700
1704
  },
1701
1705
  /**
1702
- * Search the dictionary entries.
1706
+ * 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.
1703
1707
  *
1704
- * @summary Search a dictionary entries.
1708
+ * @summary Search dictionary entries.
1705
1709
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
1706
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
1710
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
1707
1711
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
1708
1712
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1709
1713
  */
@@ -1732,12 +1736,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1732
1736
  return transporter.request(request, requestOptions);
1733
1737
  },
1734
1738
  /**
1735
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
1739
+ * [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`.
1736
1740
  *
1737
- * @summary Search for values of a given facet.
1741
+ * @summary Search for facet values.
1738
1742
  * @param searchForFacetValues - The searchForFacetValues object.
1739
- * @param searchForFacetValues.indexName - The index in which to perform the request.
1740
- * @param searchForFacetValues.facetName - The facet name.
1743
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
1744
+ * @param searchForFacetValues.facetName - Facet name.
1741
1745
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
1742
1746
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1743
1747
  */
@@ -1765,11 +1769,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1765
1769
  return transporter.request(request, requestOptions);
1766
1770
  },
1767
1771
  /**
1768
- * Search for rules matching various criteria.
1772
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
1769
1773
  *
1770
1774
  * @summary Search for rules.
1771
1775
  * @param searchRules - The searchRules object.
1772
- * @param searchRules.indexName - The index in which to perform the request.
1776
+ * @param searchRules.indexName - Index on which to perform the request.
1773
1777
  * @param searchRules.searchRulesParams - The searchRulesParams object.
1774
1778
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1775
1779
  */
@@ -1792,11 +1796,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1792
1796
  return transporter.request(request, requestOptions);
1793
1797
  },
1794
1798
  /**
1795
- * Perform a search operation targeting one specific index.
1799
+ * Return records that match the query.
1796
1800
  *
1797
- * @summary Search in a single index.
1801
+ * @summary Search an index.
1798
1802
  * @param searchSingleIndex - The searchSingleIndex object.
1799
- * @param searchSingleIndex.indexName - The index in which to perform the request.
1803
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
1800
1804
  * @param searchSingleIndex.searchParams - The searchParams object.
1801
1805
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1802
1806
  */
@@ -1819,15 +1823,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1819
1823
  return transporter.request(request, requestOptions);
1820
1824
  },
1821
1825
  /**
1822
- * Search or browse all synonyms, optionally filtering them by type.
1826
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
1823
1827
  *
1824
- * @summary Search synonyms.
1828
+ * @summary Search for synonyms.
1825
1829
  * @param searchSynonyms - The searchSynonyms object.
1826
- * @param searchSynonyms.indexName - The index in which to perform the request.
1827
- * @param searchSynonyms.type - Only search for specific types of synonyms.
1828
- * @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).
1829
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
1830
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
1830
+ * @param searchSynonyms.indexName - Index on which to perform the request.
1831
+ * @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).
1832
+ * @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.
1833
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
1834
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
1831
1835
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1832
1836
  */
1833
1837
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -1858,9 +1862,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1858
1862
  return transporter.request(request, requestOptions);
1859
1863
  },
1860
1864
  /**
1861
- * 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.
1865
+ * 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).
1862
1866
  *
1863
- * @summary Search userID.
1867
+ * @summary Search for a user ID.
1864
1868
  * @param searchUserIdsParams - The searchUserIdsParams object.
1865
1869
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1866
1870
  */
@@ -1886,9 +1890,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1886
1890
  return transporter.request(request, requestOptions);
1887
1891
  },
1888
1892
  /**
1889
- * Set dictionaries settings.
1893
+ * Set stop word settings for a specific language.
1890
1894
  *
1891
- * @summary Set dictionaries settings.
1895
+ * @summary Set stop word settings.
1892
1896
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
1893
1897
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1894
1898
  */
@@ -1912,13 +1916,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1912
1916
  return transporter.request(request, requestOptions);
1913
1917
  },
1914
1918
  /**
1915
- * 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.
1919
+ * 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.
1916
1920
  *
1917
- * @summary Update settings of an index.
1921
+ * @summary Update index settings.
1918
1922
  * @param setSettings - The setSettings object.
1919
- * @param setSettings.indexName - The index in which to perform the request.
1923
+ * @param setSettings.indexName - Index on which to perform the request.
1920
1924
  * @param setSettings.indexSettings - The indexSettings object.
1921
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1925
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1922
1926
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1923
1927
  */
1924
1928
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -1944,11 +1948,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1944
1948
  return transporter.request(request, requestOptions);
1945
1949
  },
1946
1950
  /**
1947
- * Replace every permission of an existing API key.
1951
+ * 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.
1948
1952
  *
1949
1953
  * @summary Update an API key.
1950
1954
  * @param updateApiKey - The updateApiKey object.
1951
- * @param updateApiKey.key - API Key string.
1955
+ * @param updateApiKey.key - API key.
1952
1956
  * @param updateApiKey.apiKey - The apiKey object.
1953
1957
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1954
1958
  */