@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
@@ -1,12 +1,10 @@
1
1
  'use strict';
2
2
 
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
3
  var clientCommon = require('@algolia/client-common');
6
4
  var requesterNodeHttp = require('@algolia/requester-node-http');
7
5
 
8
6
  // 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.
9
- const apiClientVersion = '5.0.0-alpha.73';
7
+ const apiClientVersion = '5.0.0-alpha.76';
10
8
  function getDefaultHosts(appId) {
11
9
  return [
12
10
  {
@@ -253,9 +251,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
253
251
  });
254
252
  },
255
253
  /**
256
- * Add a new API Key with specific permissions/restrictions.
254
+ * 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.
257
255
  *
258
- * @summary Create an API key.
256
+ * @summary Add API key.
259
257
  * @param apiKey - The apiKey object.
260
258
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
261
259
  */
@@ -279,13 +277,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
279
277
  return transporter.request(request, requestOptions);
280
278
  },
281
279
  /**
282
- * 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.
280
+ * 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).
283
281
  *
284
- * @summary Add or replace an object.
282
+ * @summary Add or update a record (using objectID).
285
283
  * @param addOrUpdateObject - The addOrUpdateObject object.
286
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
287
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
288
- * @param addOrUpdateObject.body - The Algolia object.
284
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
285
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
286
+ * @param addOrUpdateObject.body - Algolia record.
289
287
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
290
288
  */
291
289
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -313,10 +311,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
313
311
  return transporter.request(request, requestOptions);
314
312
  },
315
313
  /**
316
- * Add a single source to the list of allowed sources.
314
+ * Add a source to the list of allowed sources.
317
315
  *
318
- * @summary Add a single source.
319
- * @param source - The source to add.
316
+ * @summary Add a source.
317
+ * @param source - Source to add.
320
318
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
321
319
  */
322
320
  appendSource(source, requestOptions) {
@@ -339,9 +337,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
339
337
  return transporter.request(request, requestOptions);
340
338
  },
341
339
  /**
342
- * 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.
340
+ * 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.
343
341
  *
344
- * @summary Assign or Move userID.
342
+ * @summary Assign or move a user ID.
345
343
  * @param assignUserId - The assignUserId object.
346
344
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
347
345
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -373,11 +371,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
373
371
  return transporter.request(request, requestOptions);
374
372
  },
375
373
  /**
376
- * Perform multiple write operations targeting one index, in a single API call.
374
+ * 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.
377
375
  *
378
- * @summary Batch operations to one index.
376
+ * @summary Batch write operations on one index.
379
377
  * @param batch - The batch object.
380
- * @param batch.indexName - The index in which to perform the request.
378
+ * @param batch.indexName - Index on which to perform the request.
381
379
  * @param batch.batchWriteParams - The batchWriteParams object.
382
380
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
383
381
  */
@@ -404,7 +402,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
404
402
  return transporter.request(request, requestOptions);
405
403
  },
406
404
  /**
407
- * 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.
405
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
408
406
  *
409
407
  * @summary Batch assign userIDs.
410
408
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -441,11 +439,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
441
439
  return transporter.request(request, requestOptions);
442
440
  },
443
441
  /**
444
- * Send a batch of dictionary entries.
442
+ * Add or remove a batch of dictionary entries.
445
443
  *
446
444
  * @summary Batch dictionary entries.
447
445
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
448
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
446
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
449
447
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
450
448
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
451
449
  */
@@ -472,11 +470,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
472
470
  return transporter.request(request, requestOptions);
473
471
  },
474
472
  /**
475
- * 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.
473
+ * 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.
476
474
  *
477
- * @summary Retrieve all index content.
475
+ * @summary Get all records from an index.
478
476
  * @param browse - The browse object.
479
- * @param browse.indexName - The index in which to perform the request.
477
+ * @param browse.indexName - Index on which to perform the request.
480
478
  * @param browse.browseParams - The browseParams object.
481
479
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
482
480
  */
@@ -497,12 +495,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
497
495
  return transporter.request(request, requestOptions);
498
496
  },
499
497
  /**
500
- * Remove all synonyms from an index.
498
+ * Delete all synonyms in the index.
501
499
  *
502
- * @summary Clear all synonyms.
500
+ * @summary Delete all synonyms.
503
501
  * @param clearAllSynonyms - The clearAllSynonyms object.
504
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
505
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
502
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
503
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
506
504
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
507
505
  */
508
506
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -524,11 +522,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
524
522
  return transporter.request(request, requestOptions);
525
523
  },
526
524
  /**
527
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
525
+ * Delete the records but leave settings and index-specific API keys untouched.
528
526
  *
529
- * @summary Clear all objects from an index.
527
+ * @summary Delete all records from an index.
530
528
  * @param clearObjects - The clearObjects object.
531
- * @param clearObjects.indexName - The index in which to perform the request.
529
+ * @param clearObjects.indexName - Index on which to perform the request.
532
530
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
533
531
  */
534
532
  clearObjects({ indexName }, requestOptions) {
@@ -547,12 +545,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
547
545
  return transporter.request(request, requestOptions);
548
546
  },
549
547
  /**
550
- * Delete all Rules in the index.
548
+ * Delete all rules in the index.
551
549
  *
552
- * @summary Clear Rules.
550
+ * @summary Delete all rules.
553
551
  * @param clearRules - The clearRules object.
554
- * @param clearRules.indexName - The index in which to perform the request.
555
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
552
+ * @param clearRules.indexName - Index on which to perform the request.
553
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
556
554
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
557
555
  */
558
556
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -578,8 +576,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
578
576
  *
579
577
  * @summary Send requests to the Algolia REST API.
580
578
  * @param del - The del object.
581
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
582
- * @param del.parameters - Query parameters to be applied to the current query.
579
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
580
+ * @param del.parameters - Query parameters to apply to the current query.
583
581
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
584
582
  */
585
583
  del({ path, parameters }, requestOptions) {
@@ -598,11 +596,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
598
596
  return transporter.request(request, requestOptions);
599
597
  },
600
598
  /**
601
- * Delete an existing API Key.
599
+ * Delete an existing API key. The request must be authenticated with the admin API key.
602
600
  *
603
- * @summary Delete an API key.
601
+ * @summary Delete API key.
604
602
  * @param deleteApiKey - The deleteApiKey object.
605
- * @param deleteApiKey.key - API Key string.
603
+ * @param deleteApiKey.key - API key.
606
604
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
607
605
  */
608
606
  deleteApiKey({ key }, requestOptions) {
@@ -621,11 +619,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
621
619
  return transporter.request(request, requestOptions);
622
620
  },
623
621
  /**
624
- * 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.
622
+ * 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.
625
623
  *
626
- * @summary Delete all records matching the query.
624
+ * @summary Delete all records matching a query.
627
625
  * @param deleteBy - The deleteBy object.
628
- * @param deleteBy.indexName - The index in which to perform the request.
626
+ * @param deleteBy.indexName - Index on which to perform the request.
629
627
  * @param deleteBy.deleteByParams - The deleteByParams object.
630
628
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
631
629
  */
@@ -653,7 +651,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
653
651
  *
654
652
  * @summary Delete index.
655
653
  * @param deleteIndex - The deleteIndex object.
656
- * @param deleteIndex.indexName - The index in which to perform the request.
654
+ * @param deleteIndex.indexName - Index on which to perform the request.
657
655
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
658
656
  */
659
657
  deleteIndex({ indexName }, requestOptions) {
@@ -672,12 +670,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
672
670
  return transporter.request(request, requestOptions);
673
671
  },
674
672
  /**
675
- * Delete an existing object.
673
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
676
674
  *
677
- * @summary Delete an object.
675
+ * @summary Delete a record.
678
676
  * @param deleteObject - The deleteObject object.
679
- * @param deleteObject.indexName - The index in which to perform the request.
680
- * @param deleteObject.objectID - Unique identifier of an object.
677
+ * @param deleteObject.indexName - Index on which to perform the request.
678
+ * @param deleteObject.objectID - Unique record (object) identifier.
681
679
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
682
680
  */
683
681
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -701,13 +699,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
701
699
  return transporter.request(request, requestOptions);
702
700
  },
703
701
  /**
704
- * Delete the Rule with the specified objectID.
702
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
705
703
  *
706
704
  * @summary Delete a rule.
707
705
  * @param deleteRule - The deleteRule object.
708
- * @param deleteRule.indexName - The index in which to perform the request.
709
- * @param deleteRule.objectID - Unique identifier of an object.
710
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
706
+ * @param deleteRule.indexName - Index on which to perform the request.
707
+ * @param deleteRule.objectID - Unique identifier of a rule object.
708
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
711
709
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
712
710
  */
713
711
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -734,11 +732,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
734
732
  return transporter.request(request, requestOptions);
735
733
  },
736
734
  /**
737
- * Remove a single source from the list of allowed sources.
735
+ * Remove a source from the list of allowed sources.
738
736
  *
739
- * @summary Remove a single source.
737
+ * @summary Remove a source.
740
738
  * @param deleteSource - The deleteSource object.
741
- * @param deleteSource.source - The IP range of the source.
739
+ * @param deleteSource.source - IP address range of the source.
742
740
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
743
741
  */
744
742
  deleteSource({ source }, requestOptions) {
@@ -757,13 +755,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
757
755
  return transporter.request(request, requestOptions);
758
756
  },
759
757
  /**
760
- * Delete a single synonyms set, identified by the given objectID.
758
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
761
759
  *
762
- * @summary Delete synonym.
760
+ * @summary Delete a synonym.
763
761
  * @param deleteSynonym - The deleteSynonym object.
764
- * @param deleteSynonym.indexName - The index in which to perform the request.
765
- * @param deleteSynonym.objectID - Unique identifier of an object.
766
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
762
+ * @param deleteSynonym.indexName - Index on which to perform the request.
763
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
764
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
767
765
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
768
766
  */
769
767
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -794,8 +792,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
794
792
  *
795
793
  * @summary Send requests to the Algolia REST API.
796
794
  * @param get - The get object.
797
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
798
- * @param get.parameters - Query parameters to be applied to the current query.
795
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
796
+ * @param get.parameters - Query parameters to apply to the current query.
799
797
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
800
798
  */
801
799
  get({ path, parameters }, requestOptions) {
@@ -814,11 +812,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
814
812
  return transporter.request(request, requestOptions);
815
813
  },
816
814
  /**
817
- * Get the permissions of an API key.
815
+ * 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.
818
816
  *
819
- * @summary Get an API key.
817
+ * @summary Get API key permissions.
820
818
  * @param getApiKey - The getApiKey object.
821
- * @param getApiKey.key - API Key string.
819
+ * @param getApiKey.key - API key.
822
820
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
823
821
  */
824
822
  getApiKey({ key }, requestOptions) {
@@ -837,7 +835,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
837
835
  return transporter.request(request, requestOptions);
838
836
  },
839
837
  /**
840
- * List dictionaries supported per language.
838
+ * 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.
841
839
  *
842
840
  * @summary List available languages.
843
841
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -855,9 +853,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
855
853
  return transporter.request(request, requestOptions);
856
854
  },
857
855
  /**
858
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
856
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
859
857
  *
860
- * @summary Retrieve dictionaries settings.
858
+ * @summary Get stop word settings.
861
859
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
862
860
  */
863
861
  getDictionarySettings(requestOptions) {
@@ -873,13 +871,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
873
871
  return transporter.request(request, requestOptions);
874
872
  },
875
873
  /**
876
- * Return the latest log entries.
874
+ * 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).
877
875
  *
878
876
  * @summary Return the latest log entries.
879
877
  * @param getLogs - The getLogs object.
880
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
881
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
882
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
878
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
879
+ * @param getLogs.length - Maximum number of entries to retrieve.
880
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
883
881
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
884
882
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
885
883
  */
@@ -908,13 +906,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
908
906
  return transporter.request(request, requestOptions);
909
907
  },
910
908
  /**
911
- * Retrieve one object from the index.
909
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
912
910
  *
913
- * @summary Retrieve an object.
911
+ * @summary Get a record.
914
912
  * @param getObject - The getObject object.
915
- * @param getObject.indexName - The index in which to perform the request.
916
- * @param getObject.objectID - Unique identifier of an object.
917
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
913
+ * @param getObject.indexName - Index on which to perform the request.
914
+ * @param getObject.objectID - Unique record (object) identifier.
915
+ * @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.
918
916
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
919
917
  */
920
918
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -941,10 +939,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
941
939
  return transporter.request(request, requestOptions);
942
940
  },
943
941
  /**
944
- * Retrieve one or more objects, potentially from different indices, in a single API call.
942
+ * 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.
945
943
  *
946
- * @summary Retrieve one or more objects.
947
- * @param getObjectsParams - The Algolia object.
944
+ * @summary Get multiple records.
945
+ * @param getObjectsParams - Request object.
948
946
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
949
947
  */
950
948
  getObjects(getObjectsParams, requestOptions) {
@@ -969,12 +967,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
969
967
  return transporter.request(request, requestOptions);
970
968
  },
971
969
  /**
972
- * Retrieve the Rule with the specified objectID.
970
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
973
971
  *
974
972
  * @summary Get a rule.
975
973
  * @param getRule - The getRule object.
976
- * @param getRule.indexName - The index in which to perform the request.
977
- * @param getRule.objectID - Unique identifier of an object.
974
+ * @param getRule.indexName - Index on which to perform the request.
975
+ * @param getRule.objectID - Unique identifier of a rule object.
978
976
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
979
977
  */
980
978
  getRule({ indexName, objectID }, requestOptions) {
@@ -998,11 +996,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
998
996
  return transporter.request(request, requestOptions);
999
997
  },
1000
998
  /**
1001
- * Retrieve settings of an index.
999
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
1002
1000
  *
1003
- * @summary Retrieve settings of an index.
1001
+ * @summary Get index settings.
1004
1002
  * @param getSettings - The getSettings object.
1005
- * @param getSettings.indexName - The index in which to perform the request.
1003
+ * @param getSettings.indexName - Index on which to perform the request.
1006
1004
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1007
1005
  */
1008
1006
  getSettings({ indexName }, requestOptions) {
@@ -1021,9 +1019,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1021
1019
  return transporter.request(request, requestOptions);
1022
1020
  },
1023
1021
  /**
1024
- * List all allowed sources.
1022
+ * Get all allowed sources (IP addresses).
1025
1023
  *
1026
- * @summary List all allowed sources.
1024
+ * @summary Get all allowed IP addresses.
1027
1025
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1028
1026
  */
1029
1027
  getSources(requestOptions) {
@@ -1039,12 +1037,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1039
1037
  return transporter.request(request, requestOptions);
1040
1038
  },
1041
1039
  /**
1042
- * Fetch a synonym object identified by its objectID.
1040
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
1043
1041
  *
1044
- * @summary Get synonym.
1042
+ * @summary Get a synonym object.
1045
1043
  * @param getSynonym - The getSynonym object.
1046
- * @param getSynonym.indexName - The index in which to perform the request.
1047
- * @param getSynonym.objectID - Unique identifier of an object.
1044
+ * @param getSynonym.indexName - Index on which to perform the request.
1045
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
1048
1046
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1049
1047
  */
1050
1048
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -1068,12 +1066,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1068
1066
  return transporter.request(request, requestOptions);
1069
1067
  },
1070
1068
  /**
1071
- * Check the current status of a given task.
1069
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
1072
1070
  *
1073
- * @summary Check the status of a task.
1071
+ * @summary Check a task\'s status.
1074
1072
  * @param getTask - The getTask object.
1075
- * @param getTask.indexName - The index in which to perform the request.
1076
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
1073
+ * @param getTask.indexName - Index on which to perform the request.
1074
+ * @param getTask.taskID - Unique task identifier.
1077
1075
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1078
1076
  */
1079
1077
  getTask({ indexName, taskID }, requestOptions) {
@@ -1097,7 +1095,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1097
1095
  return transporter.request(request, requestOptions);
1098
1096
  },
1099
1097
  /**
1100
- * 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.
1098
+ * 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.
1101
1099
  *
1102
1100
  * @summary Get top userID.
1103
1101
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1115,7 +1113,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1115
1113
  return transporter.request(request, requestOptions);
1116
1114
  },
1117
1115
  /**
1118
- * 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.
1116
+ * 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.
1119
1117
  *
1120
1118
  * @summary Get userID.
1121
1119
  * @param getUserId - The getUserId object.
@@ -1138,11 +1136,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1138
1136
  return transporter.request(request, requestOptions);
1139
1137
  },
1140
1138
  /**
1141
- * 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.
1139
+ * 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.
1142
1140
  *
1143
- * @summary Get migration status.
1141
+ * @summary Get migration and user mapping status.
1144
1142
  * @param hasPendingMappings - The hasPendingMappings object.
1145
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
1143
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
1146
1144
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1147
1145
  */
1148
1146
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -1161,9 +1159,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1161
1159
  return transporter.request(request, requestOptions);
1162
1160
  },
1163
1161
  /**
1164
- * List API keys, along with their associated rights.
1162
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
1165
1163
  *
1166
- * @summary List API Keys.
1164
+ * @summary List API keys.
1167
1165
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1168
1166
  */
1169
1167
  listApiKeys(requestOptions) {
@@ -1179,7 +1177,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1179
1177
  return transporter.request(request, requestOptions);
1180
1178
  },
1181
1179
  /**
1182
- * 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.
1180
+ * List the available clusters in a multi-cluster setup.
1183
1181
  *
1184
1182
  * @summary List clusters.
1185
1183
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -1197,20 +1195,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1197
1195
  return transporter.request(request, requestOptions);
1198
1196
  },
1199
1197
  /**
1200
- * List existing indexes from an application.
1198
+ * List indices in an Algolia application.
1201
1199
  *
1202
- * @summary List existing indexes.
1200
+ * @summary List indices.
1203
1201
  * @param listIndices - The listIndices object.
1204
- * @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).
1202
+ * @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.
1203
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
1205
1204
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1206
1205
  */
1207
- listIndices({ page } = {}, requestOptions = undefined) {
1206
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
1208
1207
  const requestPath = '/1/indexes';
1209
1208
  const headers = {};
1210
1209
  const queryParameters = {};
1211
1210
  if (page !== undefined) {
1212
1211
  queryParameters.page = page.toString();
1213
1212
  }
1213
+ if (hitsPerPage !== undefined) {
1214
+ queryParameters.hitsPerPage = hitsPerPage.toString();
1215
+ }
1214
1216
  const request = {
1215
1217
  method: 'GET',
1216
1218
  path: requestPath,
@@ -1220,12 +1222,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1220
1222
  return transporter.request(request, requestOptions);
1221
1223
  },
1222
1224
  /**
1223
- * 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.
1225
+ * 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.
1224
1226
  *
1225
1227
  * @summary List userIDs.
1226
1228
  * @param listUserIds - The listUserIds object.
1227
- * @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).
1228
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
1229
+ * @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.
1230
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
1229
1231
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1230
1232
  */
1231
1233
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -1247,9 +1249,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1247
1249
  return transporter.request(request, requestOptions);
1248
1250
  },
1249
1251
  /**
1250
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
1252
+ * 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.
1251
1253
  *
1252
- * @summary Batch operations to many indices.
1254
+ * @summary Batch write operations on multiple indices.
1253
1255
  * @param batchParams - The batchParams object.
1254
1256
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1255
1257
  */
@@ -1273,11 +1275,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1273
1275
  return transporter.request(request, requestOptions);
1274
1276
  },
1275
1277
  /**
1276
- * Performs a copy or a move operation on a index.
1278
+ * 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/).
1277
1279
  *
1278
- * @summary Copy/move index.
1280
+ * @summary Copy, move, or rename an index.
1279
1281
  * @param operationIndex - The operationIndex object.
1280
- * @param operationIndex.indexName - The index in which to perform the request.
1282
+ * @param operationIndex.indexName - Index on which to perform the request.
1281
1283
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
1282
1284
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1283
1285
  */
@@ -1307,14 +1309,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1307
1309
  return transporter.request(request, requestOptions);
1308
1310
  },
1309
1311
  /**
1310
- * 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.
1312
+ * 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.
1311
1313
  *
1312
- * @summary Partially update an object.
1314
+ * @summary Update record attributes.
1313
1315
  * @param partialUpdateObject - The partialUpdateObject object.
1314
- * @param partialUpdateObject.indexName - The index in which to perform the request.
1315
- * @param partialUpdateObject.objectID - Unique identifier of an object.
1316
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
1317
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
1316
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
1317
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
1318
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
1319
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
1318
1320
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1319
1321
  */
1320
1322
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -1349,9 +1351,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1349
1351
  *
1350
1352
  * @summary Send requests to the Algolia REST API.
1351
1353
  * @param post - The post object.
1352
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1353
- * @param post.parameters - Query parameters to be applied to the current query.
1354
- * @param post.body - The parameters to send with the custom request.
1354
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1355
+ * @param post.parameters - Query parameters to apply to the current query.
1356
+ * @param post.body - Parameters to send with the custom request.
1355
1357
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1356
1358
  */
1357
1359
  post({ path, parameters, body }, requestOptions) {
@@ -1375,9 +1377,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1375
1377
  *
1376
1378
  * @summary Send requests to the Algolia REST API.
1377
1379
  * @param put - The put object.
1378
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1379
- * @param put.parameters - Query parameters to be applied to the current query.
1380
- * @param put.body - The parameters to send with the custom request.
1380
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1381
+ * @param put.parameters - Query parameters to apply to the current query.
1382
+ * @param put.body - Parameters to send with the custom request.
1381
1383
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1382
1384
  */
1383
1385
  put({ path, parameters, body }, requestOptions) {
@@ -1397,7 +1399,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1397
1399
  return transporter.request(request, requestOptions);
1398
1400
  },
1399
1401
  /**
1400
- * 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.
1402
+ * Remove a userID and its associated data from the multi-clusters.
1401
1403
  *
1402
1404
  * @summary Remove userID.
1403
1405
  * @param removeUserId - The removeUserId object.
@@ -1422,9 +1424,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1422
1424
  /**
1423
1425
  * Replace all allowed sources.
1424
1426
  *
1425
- * @summary Replace all allowed sources.
1427
+ * @summary Replace all sources.
1426
1428
  * @param replaceSources - The replaceSources object.
1427
- * @param replaceSources.source - The sources to allow.
1429
+ * @param replaceSources.source - Allowed sources.
1428
1430
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1429
1431
  */
1430
1432
  replaceSources({ source }, requestOptions) {
@@ -1444,11 +1446,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1444
1446
  return transporter.request(request, requestOptions);
1445
1447
  },
1446
1448
  /**
1447
- * Restore a deleted API key, along with its associated rights.
1449
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
1448
1450
  *
1449
- * @summary Restore an API key.
1451
+ * @summary Restore API key.
1450
1452
  * @param restoreApiKey - The restoreApiKey object.
1451
- * @param restoreApiKey.key - API Key string.
1453
+ * @param restoreApiKey.key - API key.
1452
1454
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1453
1455
  */
1454
1456
  restoreApiKey({ key }, requestOptions) {
@@ -1467,11 +1469,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1467
1469
  return transporter.request(request, requestOptions);
1468
1470
  },
1469
1471
  /**
1470
- * Add an object to the index, automatically assigning it an object ID.
1472
+ * 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).
1471
1473
  *
1472
- * @summary Add an object to the index.
1474
+ * @summary Add or update a record.
1473
1475
  * @param saveObject - The saveObject object.
1474
- * @param saveObject.indexName - The index in which to perform the request.
1476
+ * @param saveObject.indexName - Index on which to perform the request.
1475
1477
  * @param saveObject.body - The Algolia record.
1476
1478
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1477
1479
  */
@@ -1495,14 +1497,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1495
1497
  return transporter.request(request, requestOptions);
1496
1498
  },
1497
1499
  /**
1498
- * Create or update the Rule with the specified objectID.
1500
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
1499
1501
  *
1500
- * @summary Save/Update a rule.
1502
+ * @summary Create or update a rule.
1501
1503
  * @param saveRule - The saveRule object.
1502
- * @param saveRule.indexName - The index in which to perform the request.
1503
- * @param saveRule.objectID - Unique identifier of an object.
1504
+ * @param saveRule.indexName - Index on which to perform the request.
1505
+ * @param saveRule.objectID - Unique identifier of a rule object.
1504
1506
  * @param saveRule.rule - The rule object.
1505
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1507
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1506
1508
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1507
1509
  */
1508
1510
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -1536,14 +1538,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1536
1538
  return transporter.request(request, requestOptions);
1537
1539
  },
1538
1540
  /**
1539
- * Create/update multiple rules objects at once.
1541
+ * Create or update multiple rules.
1540
1542
  *
1541
1543
  * @summary Save a batch of rules.
1542
1544
  * @param saveRules - The saveRules object.
1543
- * @param saveRules.indexName - The index in which to perform the request.
1545
+ * @param saveRules.indexName - Index on which to perform the request.
1544
1546
  * @param saveRules.rules - The rules object.
1545
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1546
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
1547
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1548
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
1547
1549
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1548
1550
  */
1549
1551
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -1572,14 +1574,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1572
1574
  return transporter.request(request, requestOptions);
1573
1575
  },
1574
1576
  /**
1575
- * Create a new synonym object or update the existing synonym object with the given object ID.
1577
+ * 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).
1576
1578
  *
1577
- * @summary Save synonym.
1579
+ * @summary Save a synonym.
1578
1580
  * @param saveSynonym - The saveSynonym object.
1579
- * @param saveSynonym.indexName - The index in which to perform the request.
1580
- * @param saveSynonym.objectID - Unique identifier of an object.
1581
+ * @param saveSynonym.indexName - Index on which to perform the request.
1582
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
1581
1583
  * @param saveSynonym.synonymHit - The synonymHit object.
1582
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1584
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1583
1585
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1584
1586
  */
1585
1587
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -1616,14 +1618,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1616
1618
  return transporter.request(request, requestOptions);
1617
1619
  },
1618
1620
  /**
1619
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
1621
+ * Create or update multiple synonyms.
1620
1622
  *
1621
1623
  * @summary Save a batch of synonyms.
1622
1624
  * @param saveSynonyms - The saveSynonyms object.
1623
- * @param saveSynonyms.indexName - The index in which to perform the request.
1625
+ * @param saveSynonyms.indexName - Index on which to perform the request.
1624
1626
  * @param saveSynonyms.synonymHit - The synonymHit object.
1625
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1626
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
1627
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1628
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
1627
1629
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1628
1630
  */
1629
1631
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -1653,10 +1655,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1653
1655
  return transporter.request(request, requestOptions);
1654
1656
  },
1655
1657
  /**
1656
- * Perform a search operation targeting one or many indices.
1658
+ * Send multiple search queries to one or more indices.
1657
1659
  *
1658
1660
  * @summary Search multiple indices.
1659
- * @param searchMethodParams - The `search` requests and strategy.
1661
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
1660
1662
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1661
1663
  */
1662
1664
  search(searchMethodParams, requestOptions) {
@@ -1703,11 +1705,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1703
1705
  return transporter.request(request, requestOptions);
1704
1706
  },
1705
1707
  /**
1706
- * Search the dictionary entries.
1708
+ * 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.
1707
1709
  *
1708
- * @summary Search a dictionary entries.
1710
+ * @summary Search dictionary entries.
1709
1711
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
1710
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
1712
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
1711
1713
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
1712
1714
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1713
1715
  */
@@ -1736,12 +1738,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1736
1738
  return transporter.request(request, requestOptions);
1737
1739
  },
1738
1740
  /**
1739
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
1741
+ * [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`.
1740
1742
  *
1741
- * @summary Search for values of a given facet.
1743
+ * @summary Search for facet values.
1742
1744
  * @param searchForFacetValues - The searchForFacetValues object.
1743
- * @param searchForFacetValues.indexName - The index in which to perform the request.
1744
- * @param searchForFacetValues.facetName - The facet name.
1745
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
1746
+ * @param searchForFacetValues.facetName - Facet name.
1745
1747
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
1746
1748
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1747
1749
  */
@@ -1769,11 +1771,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1769
1771
  return transporter.request(request, requestOptions);
1770
1772
  },
1771
1773
  /**
1772
- * Search for rules matching various criteria.
1774
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
1773
1775
  *
1774
1776
  * @summary Search for rules.
1775
1777
  * @param searchRules - The searchRules object.
1776
- * @param searchRules.indexName - The index in which to perform the request.
1778
+ * @param searchRules.indexName - Index on which to perform the request.
1777
1779
  * @param searchRules.searchRulesParams - The searchRulesParams object.
1778
1780
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1779
1781
  */
@@ -1796,11 +1798,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1796
1798
  return transporter.request(request, requestOptions);
1797
1799
  },
1798
1800
  /**
1799
- * Perform a search operation targeting one specific index.
1801
+ * Return records that match the query.
1800
1802
  *
1801
- * @summary Search in a single index.
1803
+ * @summary Search an index.
1802
1804
  * @param searchSingleIndex - The searchSingleIndex object.
1803
- * @param searchSingleIndex.indexName - The index in which to perform the request.
1805
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
1804
1806
  * @param searchSingleIndex.searchParams - The searchParams object.
1805
1807
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1806
1808
  */
@@ -1823,15 +1825,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1823
1825
  return transporter.request(request, requestOptions);
1824
1826
  },
1825
1827
  /**
1826
- * Search or browse all synonyms, optionally filtering them by type.
1828
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
1827
1829
  *
1828
- * @summary Search synonyms.
1830
+ * @summary Search for synonyms.
1829
1831
  * @param searchSynonyms - The searchSynonyms object.
1830
- * @param searchSynonyms.indexName - The index in which to perform the request.
1831
- * @param searchSynonyms.type - Only search for specific types of synonyms.
1832
- * @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).
1833
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
1834
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
1832
+ * @param searchSynonyms.indexName - Index on which to perform the request.
1833
+ * @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).
1834
+ * @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.
1835
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
1836
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
1835
1837
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1836
1838
  */
1837
1839
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -1862,9 +1864,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1862
1864
  return transporter.request(request, requestOptions);
1863
1865
  },
1864
1866
  /**
1865
- * 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.
1867
+ * 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).
1866
1868
  *
1867
- * @summary Search userID.
1869
+ * @summary Search for a user ID.
1868
1870
  * @param searchUserIdsParams - The searchUserIdsParams object.
1869
1871
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1870
1872
  */
@@ -1890,9 +1892,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1890
1892
  return transporter.request(request, requestOptions);
1891
1893
  },
1892
1894
  /**
1893
- * Set dictionaries settings.
1895
+ * Set stop word settings for a specific language.
1894
1896
  *
1895
- * @summary Set dictionaries settings.
1897
+ * @summary Set stop word settings.
1896
1898
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
1897
1899
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1898
1900
  */
@@ -1916,13 +1918,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1916
1918
  return transporter.request(request, requestOptions);
1917
1919
  },
1918
1920
  /**
1919
- * 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.
1921
+ * 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.
1920
1922
  *
1921
- * @summary Update settings of an index.
1923
+ * @summary Update index settings.
1922
1924
  * @param setSettings - The setSettings object.
1923
- * @param setSettings.indexName - The index in which to perform the request.
1925
+ * @param setSettings.indexName - Index on which to perform the request.
1924
1926
  * @param setSettings.indexSettings - The indexSettings object.
1925
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1927
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1926
1928
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1927
1929
  */
1928
1930
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -1948,11 +1950,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1948
1950
  return transporter.request(request, requestOptions);
1949
1951
  },
1950
1952
  /**
1951
- * Replace every permission of an existing API key.
1953
+ * 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.
1952
1954
  *
1953
1955
  * @summary Update an API key.
1954
1956
  * @param updateApiKey - The updateApiKey object.
1955
- * @param updateApiKey.key - API Key string.
1957
+ * @param updateApiKey.key - API key.
1956
1958
  * @param updateApiKey.apiKey - The apiKey object.
1957
1959
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1958
1960
  */