algoliasearch 5.0.0-alpha.73 → 5.0.0-alpha.75

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 (327) hide show
  1. package/dist/algoliasearch.cjs.js +342 -340
  2. package/dist/algoliasearch.esm.browser.js +342 -338
  3. package/dist/algoliasearch.esm.node.js +342 -338
  4. package/dist/algoliasearch.umd.js +2 -2
  5. package/dist/builds/browser.d.ts +2 -2
  6. package/dist/builds/node.d.ts +2 -2
  7. package/dist/client-abtesting/model/aBTest.d.ts +8 -12
  8. package/dist/client-abtesting/model/aBTest.d.ts.map +1 -1
  9. package/dist/client-abtesting/model/aBTestResponse.d.ts +3 -3
  10. package/dist/client-abtesting/model/abTestsVariant.d.ts +3 -3
  11. package/dist/client-abtesting/model/addABTestsRequest.d.ts +3 -3
  12. package/dist/client-abtesting/model/addABTestsRequest.d.ts.map +1 -1
  13. package/dist/client-abtesting/model/clientMethodProps.d.ts +16 -16
  14. package/dist/client-abtesting/model/customSearchParams.d.ts +3 -0
  15. package/dist/client-abtesting/model/customSearchParams.d.ts.map +1 -1
  16. package/dist/client-abtesting/model/listABTestsResponse.d.ts +3 -3
  17. package/dist/client-abtesting/model/variant.d.ts +14 -14
  18. package/dist/client-abtesting/src/abtestingClient.d.ts +27 -27
  19. package/dist/client-analytics/model/averageClickEvent.d.ts +3 -3
  20. package/dist/client-analytics/model/clickPosition.d.ts +2 -2
  21. package/dist/client-analytics/model/clickThroughRateEvent.d.ts +4 -4
  22. package/dist/client-analytics/model/clientMethodProps.d.ts +91 -91
  23. package/dist/client-analytics/model/conversionRateEvent.d.ts +4 -4
  24. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts +3 -3
  25. package/dist/client-analytics/model/getClickPositionsResponse.d.ts +1 -1
  26. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts +4 -4
  27. package/dist/client-analytics/model/getConversationRateResponse.d.ts +4 -4
  28. package/dist/client-analytics/model/getNoClickRateResponse.d.ts +4 -4
  29. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts +4 -4
  30. package/dist/client-analytics/model/getSearchesCountResponse.d.ts +2 -2
  31. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts +1 -1
  32. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts +1 -1
  33. package/dist/client-analytics/model/getStatusResponse.d.ts +1 -1
  34. package/dist/client-analytics/model/getTopCountriesResponse.d.ts +1 -1
  35. package/dist/client-analytics/model/getTopFilterAttribute.d.ts +2 -2
  36. package/dist/client-analytics/model/getTopFilterAttributesResponse.d.ts +1 -1
  37. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts +4 -4
  38. package/dist/client-analytics/model/getTopFilterForAttributeResponse.d.ts +1 -1
  39. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts +1 -1
  40. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts +3 -3
  41. package/dist/client-analytics/model/getTopFiltersNoResultsValues.d.ts +2 -2
  42. package/dist/client-analytics/model/getUsersCountResponse.d.ts +2 -2
  43. package/dist/client-analytics/model/noClickRateEvent.d.ts +4 -4
  44. package/dist/client-analytics/model/noResultsRateEvent.d.ts +4 -4
  45. package/dist/client-analytics/model/orderBy.d.ts +3 -0
  46. package/dist/client-analytics/model/orderBy.d.ts.map +1 -1
  47. package/dist/client-analytics/model/searchEvent.d.ts +2 -2
  48. package/dist/client-analytics/model/searchNoClickEvent.d.ts +3 -3
  49. package/dist/client-analytics/model/searchNoResultEvent.d.ts +3 -3
  50. package/dist/client-analytics/model/topCountry.d.ts +2 -2
  51. package/dist/client-analytics/model/topHit.d.ts +2 -2
  52. package/dist/client-analytics/model/topHitWithAnalytics.d.ts +7 -7
  53. package/dist/client-analytics/model/topHitsResponse.d.ts +1 -1
  54. package/dist/client-analytics/model/topHitsResponseWithAnalytics.d.ts +1 -1
  55. package/dist/client-analytics/model/topSearch.d.ts +3 -3
  56. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts +9 -9
  57. package/dist/client-analytics/model/topSearchesResponse.d.ts +1 -1
  58. package/dist/client-analytics/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  59. package/dist/client-analytics/model/userWithDate.d.ts +2 -2
  60. package/dist/client-analytics/src/analyticsClient.d.ts +114 -114
  61. package/dist/client-personalization/model/clientMethodProps.d.ts +10 -10
  62. package/dist/client-personalization/src/personalizationClient.d.ts +11 -11
  63. package/dist/client-search/model/acl.d.ts +1 -1
  64. package/dist/client-search/model/action.d.ts +1 -1
  65. package/dist/client-search/model/addApiKeyResponse.d.ts +2 -2
  66. package/dist/client-search/model/anchoring.d.ts +1 -1
  67. package/dist/client-search/model/apiKey.d.ts +9 -9
  68. package/dist/client-search/model/aroundRadius.d.ts +1 -1
  69. package/dist/client-search/model/assignUserIdParams.d.ts +1 -1
  70. package/dist/client-search/model/baseGetApiKeyResponse.d.ts +2 -2
  71. package/dist/client-search/model/baseIndexSettings.d.ts +14 -14
  72. package/dist/client-search/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  73. package/dist/client-search/model/baseSearchResponse.d.ts +20 -20
  74. package/dist/client-search/model/baseSearchResponseRedirect.d.ts +1 -1
  75. package/dist/client-search/model/batchAssignUserIdsParams.d.ts +2 -2
  76. package/dist/client-search/model/batchDictionaryEntriesParams.d.ts +3 -3
  77. package/dist/client-search/model/batchParams.d.ts +1 -1
  78. package/dist/client-search/model/batchRequest.d.ts +1 -1
  79. package/dist/client-search/model/batchResponse.d.ts +2 -2
  80. package/dist/client-search/model/batchWriteParams.d.ts +1 -1
  81. package/dist/client-search/model/builtInOperation.d.ts +1 -1
  82. package/dist/client-search/model/builtInOperationType.d.ts +1 -1
  83. package/dist/client-search/model/clientMethodProps.d.ts +88 -84
  84. package/dist/client-search/model/clientMethodProps.d.ts.map +1 -1
  85. package/dist/client-search/model/consequence.d.ts +4 -4
  86. package/dist/client-search/model/consequenceHide.d.ts +2 -2
  87. package/dist/client-search/model/createdAtResponse.d.ts +2 -2
  88. package/dist/client-search/model/cursor.d.ts +1 -1
  89. package/dist/client-search/model/deleteApiKeyResponse.d.ts +1 -1
  90. package/dist/client-search/model/deleteByParams.d.ts +4 -4
  91. package/dist/client-search/model/deleteSourceResponse.d.ts +1 -1
  92. package/dist/client-search/model/deletedAtResponse.d.ts +3 -3
  93. package/dist/client-search/model/dictionaryEntry.d.ts +6 -6
  94. package/dist/client-search/model/dictionaryEntryState.d.ts +1 -1
  95. package/dist/client-search/model/dictionaryLanguage.d.ts +2 -2
  96. package/dist/client-search/model/dictionarySettingsParams.d.ts +1 -1
  97. package/dist/client-search/model/distinct.d.ts +1 -1
  98. package/dist/client-search/model/exactOnSingleWordQuery.d.ts +1 -1
  99. package/dist/client-search/model/facetFilters.d.ts +1 -1
  100. package/dist/client-search/model/facetHits.d.ts +3 -3
  101. package/dist/client-search/model/facetOrdering.d.ts +2 -2
  102. package/dist/client-search/model/facets.d.ts +1 -1
  103. package/dist/client-search/model/facetsStats.d.ts +4 -4
  104. package/dist/client-search/model/fetchedIndex.d.ts +1 -1
  105. package/dist/client-search/model/getObjectsParams.d.ts +1 -1
  106. package/dist/client-search/model/getObjectsRequest.d.ts +4 -4
  107. package/dist/client-search/model/getObjectsResponse.d.ts +1 -1
  108. package/dist/client-search/model/getTopUserIdsResponse.d.ts +2 -2
  109. package/dist/client-search/model/hasPendingMappingsResponse.d.ts +2 -2
  110. package/dist/client-search/model/highlightResultOption.d.ts +1 -1
  111. package/dist/client-search/model/hit.d.ts +1 -1
  112. package/dist/client-search/model/ignorePlurals.d.ts +1 -1
  113. package/dist/client-search/model/indexSettings.d.ts +1 -1
  114. package/dist/client-search/model/indexSettingsAsSearchParams.d.ts +30 -30
  115. package/dist/client-search/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  116. package/dist/client-search/model/languages.d.ts +1 -1
  117. package/dist/client-search/model/listApiKeysResponse.d.ts +1 -1
  118. package/dist/client-search/model/listClustersResponse.d.ts +2 -2
  119. package/dist/client-search/model/listIndicesResponse.d.ts +1 -1
  120. package/dist/client-search/model/listUserIdsResponse.d.ts +2 -2
  121. package/dist/client-search/model/log.d.ts +7 -7
  122. package/dist/client-search/model/logQuery.d.ts +1 -1
  123. package/dist/client-search/model/mode.d.ts +1 -1
  124. package/dist/client-search/model/multipleBatchRequest.d.ts +1 -1
  125. package/dist/client-search/model/multipleBatchResponse.d.ts +2 -2
  126. package/dist/client-search/model/numericFilters.d.ts +1 -1
  127. package/dist/client-search/model/operationIndexParams.d.ts +2 -2
  128. package/dist/client-search/model/operationType.d.ts +1 -1
  129. package/dist/client-search/model/optionalFilters.d.ts +1 -1
  130. package/dist/client-search/model/params.d.ts +1 -1
  131. package/dist/client-search/model/promoteObjectID.d.ts +3 -3
  132. package/dist/client-search/model/promoteObjectIDs.d.ts +3 -3
  133. package/dist/client-search/model/queryType.d.ts +1 -1
  134. package/dist/client-search/model/reRankingApplyFilter.d.ts +1 -1
  135. package/dist/client-search/model/redirectRuleIndexMetadata.d.ts +1 -1
  136. package/dist/client-search/model/redirectRuleIndexMetadataData.d.ts +1 -1
  137. package/dist/client-search/model/removeStopWords.d.ts +1 -1
  138. package/dist/client-search/model/removeUserIdResponse.d.ts +1 -1
  139. package/dist/client-search/model/removeWordsIfNoResults.d.ts +1 -1
  140. package/dist/client-search/model/renderingContent.d.ts +1 -1
  141. package/dist/client-search/model/replaceSourceResponse.d.ts +1 -1
  142. package/dist/client-search/model/rule.d.ts +5 -5
  143. package/dist/client-search/model/saveObjectResponse.d.ts +5 -2
  144. package/dist/client-search/model/saveObjectResponse.d.ts.map +1 -1
  145. package/dist/client-search/model/saveSynonymResponse.d.ts +3 -3
  146. package/dist/client-search/model/searchDictionaryEntriesParams.d.ts +5 -5
  147. package/dist/client-search/model/searchForFacetValuesRequest.d.ts +2 -2
  148. package/dist/client-search/model/searchForFacetsOptions.d.ts +3 -3
  149. package/dist/client-search/model/searchForHitsOptions.d.ts +1 -1
  150. package/dist/client-search/model/searchParamsQuery.d.ts +1 -1
  151. package/dist/client-search/model/searchParamsString.d.ts +1 -1
  152. package/dist/client-search/model/searchRulesParams.d.ts +7 -7
  153. package/dist/client-search/model/searchStrategy.d.ts +3 -0
  154. package/dist/client-search/model/searchStrategy.d.ts.map +1 -1
  155. package/dist/client-search/model/searchSynonymsParams.d.ts +1 -1
  156. package/dist/client-search/model/searchSynonymsResponse.d.ts +2 -2
  157. package/dist/client-search/model/searchTypeDefault.d.ts +1 -1
  158. package/dist/client-search/model/searchTypeFacet.d.ts +1 -1
  159. package/dist/client-search/model/searchUserIdsParams.d.ts +4 -4
  160. package/dist/client-search/model/searchUserIdsResponse.d.ts +5 -5
  161. package/dist/client-search/model/snippetResultOption.d.ts +1 -1
  162. package/dist/client-search/model/sortRemainingBy.d.ts +1 -1
  163. package/dist/client-search/model/source.d.ts +3 -3
  164. package/dist/client-search/model/standardEntries.d.ts +4 -4
  165. package/dist/client-search/model/synonymHit.d.ts +6 -6
  166. package/dist/client-search/model/synonymType.d.ts +1 -1
  167. package/dist/client-search/model/tagFilters.d.ts +1 -1
  168. package/dist/client-search/model/taskStatus.d.ts +3 -0
  169. package/dist/client-search/model/taskStatus.d.ts.map +1 -1
  170. package/dist/client-search/model/typoTolerance.d.ts +1 -1
  171. package/dist/client-search/model/updateApiKeyResponse.d.ts +2 -2
  172. package/dist/client-search/model/updatedAtResponse.d.ts +3 -3
  173. package/dist/client-search/model/updatedAtWithObjectIdResponse.d.ts +4 -4
  174. package/dist/client-search/model/updatedRuleResponse.d.ts +3 -3
  175. package/dist/client-search/model/userHit.d.ts +1 -1
  176. package/dist/client-search/model/userId.d.ts +2 -2
  177. package/dist/client-search/src/searchClient.d.ts +185 -184
  178. package/dist/client-search/src/searchClient.d.ts.map +1 -1
  179. package/dist/lite/lite.cjs.js +6 -8
  180. package/dist/lite/lite.esm.browser.js +6 -6
  181. package/dist/lite/lite.esm.node.js +6 -6
  182. package/dist/lite/lite.umd.js +2 -2
  183. package/dist/lite/model/acl.d.ts +1 -1
  184. package/dist/lite/model/action.d.ts +1 -1
  185. package/dist/lite/model/addApiKeyResponse.d.ts +2 -2
  186. package/dist/lite/model/anchoring.d.ts +1 -1
  187. package/dist/lite/model/apiKey.d.ts +9 -9
  188. package/dist/lite/model/aroundRadius.d.ts +1 -1
  189. package/dist/lite/model/baseGetApiKeyResponse.d.ts +2 -2
  190. package/dist/lite/model/baseIndexSettings.d.ts +14 -14
  191. package/dist/lite/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  192. package/dist/lite/model/baseSearchResponse.d.ts +20 -20
  193. package/dist/lite/model/baseSearchResponseRedirect.d.ts +1 -1
  194. package/dist/lite/model/builtInOperation.d.ts +1 -1
  195. package/dist/lite/model/builtInOperationType.d.ts +1 -1
  196. package/dist/lite/model/clientMethodProps.d.ts +3 -3
  197. package/dist/lite/model/consequence.d.ts +4 -4
  198. package/dist/lite/model/consequenceHide.d.ts +2 -2
  199. package/dist/lite/model/cursor.d.ts +1 -1
  200. package/dist/lite/model/deleteByParams.d.ts +4 -4
  201. package/dist/lite/model/dictionaryEntry.d.ts +6 -6
  202. package/dist/lite/model/dictionaryEntryState.d.ts +1 -1
  203. package/dist/lite/model/dictionaryLanguage.d.ts +2 -2
  204. package/dist/lite/model/distinct.d.ts +1 -1
  205. package/dist/lite/model/exactOnSingleWordQuery.d.ts +1 -1
  206. package/dist/lite/model/facetFilters.d.ts +1 -1
  207. package/dist/lite/model/facetOrdering.d.ts +2 -2
  208. package/dist/lite/model/facets.d.ts +1 -1
  209. package/dist/lite/model/facetsStats.d.ts +4 -4
  210. package/dist/lite/model/fetchedIndex.d.ts +1 -1
  211. package/dist/lite/model/highlightResultOption.d.ts +1 -1
  212. package/dist/lite/model/hit.d.ts +1 -1
  213. package/dist/lite/model/ignorePlurals.d.ts +1 -1
  214. package/dist/lite/model/indexSettings.d.ts +1 -1
  215. package/dist/lite/model/indexSettingsAsSearchParams.d.ts +30 -30
  216. package/dist/lite/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  217. package/dist/lite/model/languages.d.ts +1 -1
  218. package/dist/lite/model/listIndicesResponse.d.ts +1 -1
  219. package/dist/lite/model/mode.d.ts +1 -1
  220. package/dist/lite/model/numericFilters.d.ts +1 -1
  221. package/dist/lite/model/operationType.d.ts +1 -1
  222. package/dist/lite/model/optionalFilters.d.ts +1 -1
  223. package/dist/lite/model/params.d.ts +1 -1
  224. package/dist/lite/model/promoteObjectID.d.ts +3 -3
  225. package/dist/lite/model/promoteObjectIDs.d.ts +3 -3
  226. package/dist/lite/model/queryType.d.ts +1 -1
  227. package/dist/lite/model/reRankingApplyFilter.d.ts +1 -1
  228. package/dist/lite/model/redirectRuleIndexMetadata.d.ts +1 -1
  229. package/dist/lite/model/redirectRuleIndexMetadataData.d.ts +1 -1
  230. package/dist/lite/model/removeStopWords.d.ts +1 -1
  231. package/dist/lite/model/removeWordsIfNoResults.d.ts +1 -1
  232. package/dist/lite/model/renderingContent.d.ts +1 -1
  233. package/dist/lite/model/rule.d.ts +5 -5
  234. package/dist/lite/model/searchForFacetsOptions.d.ts +3 -3
  235. package/dist/lite/model/searchForHitsOptions.d.ts +1 -1
  236. package/dist/lite/model/searchParamsQuery.d.ts +1 -1
  237. package/dist/lite/model/searchParamsString.d.ts +1 -1
  238. package/dist/lite/model/searchStrategy.d.ts +3 -0
  239. package/dist/lite/model/searchStrategy.d.ts.map +1 -1
  240. package/dist/lite/model/searchSynonymsResponse.d.ts +2 -2
  241. package/dist/lite/model/searchTypeDefault.d.ts +1 -1
  242. package/dist/lite/model/searchTypeFacet.d.ts +1 -1
  243. package/dist/lite/model/snippetResultOption.d.ts +1 -1
  244. package/dist/lite/model/sortRemainingBy.d.ts +1 -1
  245. package/dist/lite/model/source.d.ts +3 -3
  246. package/dist/lite/model/standardEntries.d.ts +4 -4
  247. package/dist/lite/model/synonymHit.d.ts +6 -6
  248. package/dist/lite/model/synonymType.d.ts +1 -1
  249. package/dist/lite/model/tagFilters.d.ts +1 -1
  250. package/dist/lite/model/taskStatus.d.ts +3 -0
  251. package/dist/lite/model/taskStatus.d.ts.map +1 -1
  252. package/dist/lite/model/typoTolerance.d.ts +1 -1
  253. package/dist/lite/model/updatedRuleResponse.d.ts +3 -3
  254. package/dist/lite/model/userId.d.ts +2 -2
  255. package/dist/lite/src/liteClient.d.ts +6 -6
  256. package/lite/model/acl.ts +1 -1
  257. package/lite/model/action.ts +1 -1
  258. package/lite/model/addApiKeyResponse.ts +2 -2
  259. package/lite/model/anchoring.ts +1 -1
  260. package/lite/model/apiKey.ts +9 -9
  261. package/lite/model/aroundRadius.ts +1 -1
  262. package/lite/model/baseGetApiKeyResponse.ts +2 -2
  263. package/lite/model/baseIndexSettings.ts +14 -14
  264. package/lite/model/baseSearchParamsWithoutQuery.ts +25 -25
  265. package/lite/model/baseSearchResponse.ts +20 -20
  266. package/lite/model/baseSearchResponseRedirect.ts +1 -1
  267. package/lite/model/builtInOperation.ts +1 -1
  268. package/lite/model/builtInOperationType.ts +1 -1
  269. package/lite/model/clientMethodProps.ts +3 -3
  270. package/lite/model/consequence.ts +4 -4
  271. package/lite/model/consequenceHide.ts +2 -2
  272. package/lite/model/cursor.ts +1 -1
  273. package/lite/model/deleteByParams.ts +4 -4
  274. package/lite/model/dictionaryEntry.ts +6 -6
  275. package/lite/model/dictionaryEntryState.ts +1 -1
  276. package/lite/model/dictionaryLanguage.ts +2 -2
  277. package/lite/model/distinct.ts +1 -1
  278. package/lite/model/exactOnSingleWordQuery.ts +1 -1
  279. package/lite/model/facetFilters.ts +1 -1
  280. package/lite/model/facetOrdering.ts +2 -2
  281. package/lite/model/facets.ts +1 -1
  282. package/lite/model/facetsStats.ts +4 -4
  283. package/lite/model/fetchedIndex.ts +1 -1
  284. package/lite/model/highlightResultOption.ts +1 -1
  285. package/lite/model/hit.ts +1 -1
  286. package/lite/model/ignorePlurals.ts +1 -1
  287. package/lite/model/indexSettings.ts +1 -1
  288. package/lite/model/indexSettingsAsSearchParams.ts +30 -30
  289. package/lite/model/indexSettingsAsSearchParamsSemanticSearch.ts +2 -2
  290. package/lite/model/languages.ts +1 -1
  291. package/lite/model/listIndicesResponse.ts +1 -1
  292. package/lite/model/mode.ts +1 -1
  293. package/lite/model/numericFilters.ts +1 -1
  294. package/lite/model/operationType.ts +1 -1
  295. package/lite/model/optionalFilters.ts +1 -1
  296. package/lite/model/params.ts +1 -1
  297. package/lite/model/promoteObjectID.ts +3 -3
  298. package/lite/model/promoteObjectIDs.ts +3 -3
  299. package/lite/model/queryType.ts +1 -1
  300. package/lite/model/reRankingApplyFilter.ts +1 -1
  301. package/lite/model/redirectRuleIndexMetadata.ts +1 -1
  302. package/lite/model/redirectRuleIndexMetadataData.ts +1 -1
  303. package/lite/model/removeStopWords.ts +1 -1
  304. package/lite/model/removeWordsIfNoResults.ts +1 -1
  305. package/lite/model/renderingContent.ts +1 -1
  306. package/lite/model/rule.ts +5 -5
  307. package/lite/model/searchForFacetsOptions.ts +3 -3
  308. package/lite/model/searchForHitsOptions.ts +1 -1
  309. package/lite/model/searchParamsQuery.ts +1 -1
  310. package/lite/model/searchParamsString.ts +1 -1
  311. package/lite/model/searchStrategy.ts +3 -0
  312. package/lite/model/searchSynonymsResponse.ts +2 -2
  313. package/lite/model/searchTypeDefault.ts +1 -1
  314. package/lite/model/searchTypeFacet.ts +1 -1
  315. package/lite/model/snippetResultOption.ts +1 -1
  316. package/lite/model/sortRemainingBy.ts +1 -1
  317. package/lite/model/source.ts +3 -3
  318. package/lite/model/standardEntries.ts +4 -4
  319. package/lite/model/synonymHit.ts +6 -6
  320. package/lite/model/synonymType.ts +1 -1
  321. package/lite/model/tagFilters.ts +1 -1
  322. package/lite/model/taskStatus.ts +3 -0
  323. package/lite/model/typoTolerance.ts +1 -1
  324. package/lite/model/updatedRuleResponse.ts +3 -3
  325. package/lite/model/userId.ts +2 -2
  326. package/lite/src/liteClient.ts +6 -6
  327. package/package.json +15 -14
@@ -661,7 +661,7 @@ const DEFAULT_READ_TIMEOUT_BROWSER = 2000;
661
661
  const DEFAULT_WRITE_TIMEOUT_BROWSER = 30000;
662
662
 
663
663
  // 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.
664
- const apiClientVersion$4 = '5.0.0-alpha.73';
664
+ const apiClientVersion$4 = '5.0.0-alpha.75';
665
665
  const REGIONS$2 = ['de', 'us'];
666
666
  function getDefaultHosts$3(region) {
667
667
  const url = !region
@@ -721,9 +721,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
721
721
  transporter.algoliaAgent.add({ segment, version });
722
722
  },
723
723
  /**
724
- * Creates a new A/B test with provided configuration. You can set an A/B test on two different indices with different settings, or on the same index with different search parameters by providing a customSearchParameters setting on one of the variants.
724
+ * Creates an A/B test.
725
725
  *
726
- * @summary Create a test.
726
+ * @summary Create an A/B test.
727
727
  * @param addABTestsRequest - The addABTestsRequest object.
728
728
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
729
729
  */
@@ -734,8 +734,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
734
734
  if (!addABTestsRequest.name) {
735
735
  throw new Error('Parameter `addABTestsRequest.name` is required when calling `addABTests`.');
736
736
  }
737
- if (!addABTestsRequest.variant) {
738
- throw new Error('Parameter `addABTestsRequest.variant` is required when calling `addABTests`.');
737
+ if (!addABTestsRequest.variants) {
738
+ throw new Error('Parameter `addABTestsRequest.variants` is required when calling `addABTests`.');
739
739
  }
740
740
  if (!addABTestsRequest.endAt) {
741
741
  throw new Error('Parameter `addABTestsRequest.endAt` is required when calling `addABTests`.');
@@ -757,8 +757,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
757
757
  *
758
758
  * @summary Send requests to the Algolia REST API.
759
759
  * @param del - The del object.
760
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
761
- * @param del.parameters - Query parameters to be applied to the current query.
760
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
761
+ * @param del.parameters - Query parameters to apply to the current query.
762
762
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
763
763
  */
764
764
  del({ path, parameters }, requestOptions) {
@@ -777,11 +777,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
777
777
  return transporter.request(request, requestOptions);
778
778
  },
779
779
  /**
780
- * Delete a test.
780
+ * Delete an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
781
781
  *
782
- * @summary Delete a test.
782
+ * @summary Delete an A/B test.
783
783
  * @param deleteABTest - The deleteABTest object.
784
- * @param deleteABTest.id - The A/B test ID.
784
+ * @param deleteABTest.id - Unique A/B test ID.
785
785
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
786
786
  */
787
787
  deleteABTest({ id }, requestOptions) {
@@ -804,8 +804,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
804
804
  *
805
805
  * @summary Send requests to the Algolia REST API.
806
806
  * @param get - The get object.
807
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
808
- * @param get.parameters - Query parameters to be applied to the current query.
807
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
808
+ * @param get.parameters - Query parameters to apply to the current query.
809
809
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
810
810
  */
811
811
  get({ path, parameters }, requestOptions) {
@@ -824,11 +824,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
824
824
  return transporter.request(request, requestOptions);
825
825
  },
826
826
  /**
827
- * Returns metadata and metrics for an A/B test.
827
+ * Get specific details for an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
828
828
  *
829
- * @summary Get a test.
829
+ * @summary Get A/B test details.
830
830
  * @param getABTest - The getABTest object.
831
- * @param getABTest.id - The A/B test ID.
831
+ * @param getABTest.id - Unique A/B test ID.
832
832
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
833
833
  */
834
834
  getABTest({ id }, requestOptions) {
@@ -847,14 +847,14 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
847
847
  return transporter.request(request, requestOptions);
848
848
  },
849
849
  /**
850
- * Fetch all existing A/B tests for App that are available for the current API Key. When no data has been processed, the metrics will be returned as null.
850
+ * List all A/B tests.
851
851
  *
852
- * @summary List all tests.
852
+ * @summary List all A/B tests.
853
853
  * @param listABTests - The listABTests object.
854
854
  * @param listABTests.offset - Position of the starting record. Used for paging. 0 is the first record.
855
- * @param listABTests.limit - Number of records to return. Limit is the size of the page.
856
- * @param listABTests.indexPrefix - Filters the returned ab tests by any indices starting with the provided prefix that are assigned to either variant of an ab test.
857
- * @param listABTests.indexSuffix - Filters the returned ab tests by any indices ending with the provided suffix that are assigned to either variant of an ab test.
855
+ * @param listABTests.limit - Number of records to return (page size).
856
+ * @param listABTests.indexPrefix - Only return A/B tests for indices starting with this prefix.
857
+ * @param listABTests.indexSuffix - Only return A/B tests for indices ending with this suffix.
858
858
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
859
859
  */
860
860
  listABTests({ offset, limit, indexPrefix, indexSuffix } = {}, requestOptions = undefined) {
@@ -886,9 +886,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
886
886
  *
887
887
  * @summary Send requests to the Algolia REST API.
888
888
  * @param post - The post object.
889
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
890
- * @param post.parameters - Query parameters to be applied to the current query.
891
- * @param post.body - The parameters to send with the custom request.
889
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
890
+ * @param post.parameters - Query parameters to apply to the current query.
891
+ * @param post.body - Parameters to send with the custom request.
892
892
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
893
893
  */
894
894
  post({ path, parameters, body }, requestOptions) {
@@ -912,9 +912,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
912
912
  *
913
913
  * @summary Send requests to the Algolia REST API.
914
914
  * @param put - The put object.
915
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
916
- * @param put.parameters - Query parameters to be applied to the current query.
917
- * @param put.body - The parameters to send with the custom request.
915
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
916
+ * @param put.parameters - Query parameters to apply to the current query.
917
+ * @param put.body - Parameters to send with the custom request.
918
918
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
919
919
  */
920
920
  put({ path, parameters, body }, requestOptions) {
@@ -934,11 +934,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
934
934
  return transporter.request(request, requestOptions);
935
935
  },
936
936
  /**
937
- * Marks the A/B test as stopped. At this point, the test is over and cannot be restarted. As a result, your application is back to normal: index A will perform as usual, receiving 100% of all search requests. Associated metadata and metrics are still stored.
937
+ * If stopped, the test is over and can\'t be restarted. There is now only one index, receiving 100% of all search requests. The data gathered for stopped A/B tests is retained. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
938
938
  *
939
- * @summary Stop a test.
939
+ * @summary Stop an A/B test.
940
940
  * @param stopABTest - The stopABTest object.
941
- * @param stopABTest.id - The A/B test ID.
941
+ * @param stopABTest.id - Unique A/B test ID.
942
942
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
943
943
  */
944
944
  stopABTest({ id }, requestOptions) {
@@ -960,7 +960,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
960
960
  }
961
961
 
962
962
  // 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.
963
- const apiClientVersion$3 = '5.0.0-alpha.73';
963
+ const apiClientVersion$3 = '5.0.0-alpha.75';
964
964
  const REGIONS$1 = ['de', 'us'];
965
965
  function getDefaultHosts$2(region) {
966
966
  const url = !region
@@ -1024,8 +1024,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1024
1024
  *
1025
1025
  * @summary Send requests to the Algolia REST API.
1026
1026
  * @param del - The del object.
1027
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1028
- * @param del.parameters - Query parameters to be applied to the current query.
1027
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
1028
+ * @param del.parameters - Query parameters to apply to the current query.
1029
1029
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1030
1030
  */
1031
1031
  del({ path, parameters }, requestOptions) {
@@ -1048,8 +1048,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1048
1048
  *
1049
1049
  * @summary Send requests to the Algolia REST API.
1050
1050
  * @param get - The get object.
1051
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1052
- * @param get.parameters - Query parameters to be applied to the current query.
1051
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
1052
+ * @param get.parameters - Query parameters to apply to the current query.
1053
1053
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1054
1054
  */
1055
1055
  get({ path, parameters }, requestOptions) {
@@ -1068,14 +1068,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1068
1068
  return transporter.request(request, requestOptions);
1069
1069
  },
1070
1070
  /**
1071
- * Returns the average click position. The endpoint returns a value for the complete given time range, as well as a value per day.
1071
+ * Return the average click position for the complete time range and for individual days. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
1072
1072
  *
1073
1073
  * @summary Get average click position.
1074
1074
  * @param getAverageClickPosition - The getAverageClickPosition object.
1075
- * @param getAverageClickPosition.index - The index name to target.
1076
- * @param getAverageClickPosition.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1077
- * @param getAverageClickPosition.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1078
- * @param getAverageClickPosition.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1075
+ * @param getAverageClickPosition.index - Index name to target.
1076
+ * @param getAverageClickPosition.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1077
+ * @param getAverageClickPosition.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1078
+ * @param getAverageClickPosition.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1079
1079
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1080
1080
  */
1081
1081
  getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -1106,14 +1106,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1106
1106
  return transporter.request(request, requestOptions);
1107
1107
  },
1108
1108
  /**
1109
- * Returns the distribution of clicks per range of positions. If the groups all have a count of 0, it means Algolia didnt receive any click events for the queries with the clickAnalytics search parameter set to true. The count is 0 until Algolia receives at least one click event.
1109
+ * Show the number of clicks events and their associated position in the search results. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
1110
1110
  *
1111
- * @summary Get clicks per positions.
1111
+ * @summary Get click positions.
1112
1112
  * @param getClickPositions - The getClickPositions object.
1113
- * @param getClickPositions.index - The index name to target.
1114
- * @param getClickPositions.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1115
- * @param getClickPositions.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1116
- * @param getClickPositions.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1113
+ * @param getClickPositions.index - Index name to target.
1114
+ * @param getClickPositions.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1115
+ * @param getClickPositions.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1116
+ * @param getClickPositions.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1117
1117
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1118
1118
  */
1119
1119
  getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -1144,14 +1144,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1144
1144
  return transporter.request(request, requestOptions);
1145
1145
  },
1146
1146
  /**
1147
- * Returns a click-through rate (CTR). The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of clicks and searches used to compute the rates.
1147
+ * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
1148
1148
  *
1149
1149
  * @summary Get click-through rate (CTR).
1150
1150
  * @param getClickThroughRate - The getClickThroughRate object.
1151
- * @param getClickThroughRate.index - The index name to target.
1152
- * @param getClickThroughRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1153
- * @param getClickThroughRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1154
- * @param getClickThroughRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1151
+ * @param getClickThroughRate.index - Index name to target.
1152
+ * @param getClickThroughRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1153
+ * @param getClickThroughRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1154
+ * @param getClickThroughRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1155
1155
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1156
1156
  */
1157
1157
  getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1182,14 +1182,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1182
1182
  return transporter.request(request, requestOptions);
1183
1183
  },
1184
1184
  /**
1185
- * Returns a conversion rate (CR). The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of conversion and searches used to compute the rates.
1185
+ * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
1186
1186
  *
1187
1187
  * @summary Get conversion rate (CR).
1188
1188
  * @param getConversationRate - The getConversationRate object.
1189
- * @param getConversationRate.index - The index name to target.
1190
- * @param getConversationRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1191
- * @param getConversationRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1192
- * @param getConversationRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1189
+ * @param getConversationRate.index - Index name to target.
1190
+ * @param getConversationRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1191
+ * @param getConversationRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1192
+ * @param getConversationRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1193
1193
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1194
1194
  */
1195
1195
  getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1220,14 +1220,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1220
1220
  return transporter.request(request, requestOptions);
1221
1221
  },
1222
1222
  /**
1223
- * Returns the rate at which searches didn\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
1223
+ * Returns the rate at which searches don\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
1224
1224
  *
1225
1225
  * @summary Get no click rate.
1226
1226
  * @param getNoClickRate - The getNoClickRate object.
1227
- * @param getNoClickRate.index - The index name to target.
1228
- * @param getNoClickRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1229
- * @param getNoClickRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1230
- * @param getNoClickRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1227
+ * @param getNoClickRate.index - Index name to target.
1228
+ * @param getNoClickRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1229
+ * @param getNoClickRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1230
+ * @param getNoClickRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1231
1231
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1232
1232
  */
1233
1233
  getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1258,14 +1258,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1258
1258
  return transporter.request(request, requestOptions);
1259
1259
  },
1260
1260
  /**
1261
- * Returns the rate at which searches didn\'t return any results. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without results used to compute the rates.
1261
+ * Returns the rate at which searches didn\'t return any results.
1262
1262
  *
1263
1263
  * @summary Get no results rate.
1264
1264
  * @param getNoResultsRate - The getNoResultsRate object.
1265
- * @param getNoResultsRate.index - The index name to target.
1266
- * @param getNoResultsRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1267
- * @param getNoResultsRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1268
- * @param getNoResultsRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1265
+ * @param getNoResultsRate.index - Index name to target.
1266
+ * @param getNoResultsRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1267
+ * @param getNoResultsRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1268
+ * @param getNoResultsRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1269
1269
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1270
1270
  */
1271
1271
  getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1296,14 +1296,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1296
1296
  return transporter.request(request, requestOptions);
1297
1297
  },
1298
1298
  /**
1299
- * Returns the number of searches across the given time range. The endpoint returns a value for the complete given time range, as well as a value per day.
1299
+ * Returns the number of searches within a time range.
1300
1300
  *
1301
- * @summary Get searches count.
1301
+ * @summary Get number of searches.
1302
1302
  * @param getSearchesCount - The getSearchesCount object.
1303
- * @param getSearchesCount.index - The index name to target.
1304
- * @param getSearchesCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1305
- * @param getSearchesCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1306
- * @param getSearchesCount.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1303
+ * @param getSearchesCount.index - Index name to target.
1304
+ * @param getSearchesCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1305
+ * @param getSearchesCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1306
+ * @param getSearchesCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1307
1307
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1308
1308
  */
1309
1309
  getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1334,16 +1334,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1334
1334
  return transporter.request(request, requestOptions);
1335
1335
  },
1336
1336
  /**
1337
- * Returns top searches that didn\'t lead to any clicks. Limited to the 1000 most frequent ones. For each search, also returns the average number of found hits.
1337
+ * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
1338
1338
  *
1339
1339
  * @summary Get top searches with no clicks.
1340
1340
  * @param getSearchesNoClicks - The getSearchesNoClicks object.
1341
- * @param getSearchesNoClicks.index - The index name to target.
1342
- * @param getSearchesNoClicks.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1343
- * @param getSearchesNoClicks.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1344
- * @param getSearchesNoClicks.limit - Number of records to return. Limit is the size of the page.
1341
+ * @param getSearchesNoClicks.index - Index name to target.
1342
+ * @param getSearchesNoClicks.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1343
+ * @param getSearchesNoClicks.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1344
+ * @param getSearchesNoClicks.limit - Number of records to return (page size).
1345
1345
  * @param getSearchesNoClicks.offset - Position of the starting record. Used for paging. 0 is the first record.
1346
- * @param getSearchesNoClicks.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1346
+ * @param getSearchesNoClicks.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1347
1347
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1348
1348
  */
1349
1349
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1380,16 +1380,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1380
1380
  return transporter.request(request, requestOptions);
1381
1381
  },
1382
1382
  /**
1383
- * Returns top searches that didn\'t return any results. Limited to the 1000 most frequent ones.
1383
+ * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
1384
1384
  *
1385
1385
  * @summary Get top searches with no results.
1386
1386
  * @param getSearchesNoResults - The getSearchesNoResults object.
1387
- * @param getSearchesNoResults.index - The index name to target.
1388
- * @param getSearchesNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1389
- * @param getSearchesNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1390
- * @param getSearchesNoResults.limit - Number of records to return. Limit is the size of the page.
1387
+ * @param getSearchesNoResults.index - Index name to target.
1388
+ * @param getSearchesNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1389
+ * @param getSearchesNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1390
+ * @param getSearchesNoResults.limit - Number of records to return (page size).
1391
1391
  * @param getSearchesNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
1392
- * @param getSearchesNoResults.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1392
+ * @param getSearchesNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1393
1393
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1394
1394
  */
1395
1395
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1426,11 +1426,11 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1426
1426
  return transporter.request(request, requestOptions);
1427
1427
  },
1428
1428
  /**
1429
- * Returns the latest update time of the analytics API for a given index. If the index has been recently created and/or no search has been performed yet the updated time will be null.
1429
+ * Return the latest update time of the Analytics API for an index. If the index has been recently created or no search has been performed yet, `updatedAt` will be `null`. > **Note**: The Analytics API is updated every 5 minutes.
1430
1430
  *
1431
1431
  * @summary Get Analytics API status.
1432
1432
  * @param getStatus - The getStatus object.
1433
- * @param getStatus.index - The index name to target.
1433
+ * @param getStatus.index - Index name to target.
1434
1434
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1435
1435
  */
1436
1436
  getStatus({ index }, requestOptions) {
@@ -1452,16 +1452,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1452
1452
  return transporter.request(request, requestOptions);
1453
1453
  },
1454
1454
  /**
1455
- * Returns top countries. Limited to the 1000 most frequent ones.
1455
+ * Returns top countries. Limited to the 1,000 most frequent ones.
1456
1456
  *
1457
1457
  * @summary Get top countries.
1458
1458
  * @param getTopCountries - The getTopCountries object.
1459
- * @param getTopCountries.index - The index name to target.
1460
- * @param getTopCountries.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1461
- * @param getTopCountries.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1462
- * @param getTopCountries.limit - Number of records to return. Limit is the size of the page.
1459
+ * @param getTopCountries.index - Index name to target.
1460
+ * @param getTopCountries.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1461
+ * @param getTopCountries.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1462
+ * @param getTopCountries.limit - Number of records to return (page size).
1463
1463
  * @param getTopCountries.offset - Position of the starting record. Used for paging. 0 is the first record.
1464
- * @param getTopCountries.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1464
+ * @param getTopCountries.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1465
1465
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1466
1466
  */
1467
1467
  getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -1498,17 +1498,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1498
1498
  return transporter.request(request, requestOptions);
1499
1499
  },
1500
1500
  /**
1501
- * Returns top filter attributes. Limited to the 1000 most used filters.
1501
+ * Return the most popular [filterable attributes](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/) in the 1,000 most recently used filters.
1502
1502
  *
1503
- * @summary Get top filter attributes.
1503
+ * @summary Get top filterable attributes.
1504
1504
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
1505
- * @param getTopFilterAttributes.index - The index name to target.
1506
- * @param getTopFilterAttributes.search - The query term to search for. Must match the exact user input.
1507
- * @param getTopFilterAttributes.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1508
- * @param getTopFilterAttributes.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1509
- * @param getTopFilterAttributes.limit - Number of records to return. Limit is the size of the page.
1505
+ * @param getTopFilterAttributes.index - Index name to target.
1506
+ * @param getTopFilterAttributes.search - User query.
1507
+ * @param getTopFilterAttributes.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1508
+ * @param getTopFilterAttributes.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1509
+ * @param getTopFilterAttributes.limit - Number of records to return (page size).
1510
1510
  * @param getTopFilterAttributes.offset - Position of the starting record. Used for paging. 0 is the first record.
1511
- * @param getTopFilterAttributes.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1511
+ * @param getTopFilterAttributes.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1512
1512
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1513
1513
  */
1514
1514
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1548,18 +1548,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1548
1548
  return transporter.request(request, requestOptions);
1549
1549
  },
1550
1550
  /**
1551
- * Returns top filters for the given attribute. Limited to the 1000 most used filters.
1551
+ * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
1552
1552
  *
1553
- * @summary Get top filters for the an attribute.
1553
+ * @summary Get top filter values for an attribute.
1554
1554
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
1555
- * @param getTopFilterForAttribute.attribute - The exact name of the attribute.
1556
- * @param getTopFilterForAttribute.index - The index name to target.
1557
- * @param getTopFilterForAttribute.search - The query term to search for. Must match the exact user input.
1558
- * @param getTopFilterForAttribute.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1559
- * @param getTopFilterForAttribute.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1560
- * @param getTopFilterForAttribute.limit - Number of records to return. Limit is the size of the page.
1555
+ * @param getTopFilterForAttribute.attribute - Attribute name.
1556
+ * @param getTopFilterForAttribute.index - Index name to target.
1557
+ * @param getTopFilterForAttribute.search - User query.
1558
+ * @param getTopFilterForAttribute.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1559
+ * @param getTopFilterForAttribute.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1560
+ * @param getTopFilterForAttribute.limit - Number of records to return (page size).
1561
1561
  * @param getTopFilterForAttribute.offset - Position of the starting record. Used for paging. 0 is the first record.
1562
- * @param getTopFilterForAttribute.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1562
+ * @param getTopFilterForAttribute.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1563
1563
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1564
1564
  */
1565
1565
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1602,17 +1602,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1602
1602
  return transporter.request(request, requestOptions);
1603
1603
  },
1604
1604
  /**
1605
- * Returns top filters with no results. Limited to the 1000 most used filters.
1605
+ * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
1606
1606
  *
1607
1607
  * @summary Get top filters for a no result search.
1608
1608
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
1609
- * @param getTopFiltersNoResults.index - The index name to target.
1610
- * @param getTopFiltersNoResults.search - The query term to search for. Must match the exact user input.
1611
- * @param getTopFiltersNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1612
- * @param getTopFiltersNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1613
- * @param getTopFiltersNoResults.limit - Number of records to return. Limit is the size of the page.
1609
+ * @param getTopFiltersNoResults.index - Index name to target.
1610
+ * @param getTopFiltersNoResults.search - User query.
1611
+ * @param getTopFiltersNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1612
+ * @param getTopFiltersNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1613
+ * @param getTopFiltersNoResults.limit - Number of records to return (page size).
1614
1614
  * @param getTopFiltersNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
1615
- * @param getTopFiltersNoResults.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1615
+ * @param getTopFiltersNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1616
1616
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1617
1617
  */
1618
1618
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1652,18 +1652,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1652
1652
  return transporter.request(request, requestOptions);
1653
1653
  },
1654
1654
  /**
1655
- * Returns top hits. Limited to the 1000 most frequent ones.
1655
+ * Return the most popular clicked results in the last 1,000 searches.
1656
1656
  *
1657
1657
  * @summary Get top hits.
1658
1658
  * @param getTopHits - The getTopHits object.
1659
- * @param getTopHits.index - The index name to target.
1660
- * @param getTopHits.search - The query term to search for. Must match the exact user input.
1661
- * @param getTopHits.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1662
- * @param getTopHits.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1663
- * @param getTopHits.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1664
- * @param getTopHits.limit - Number of records to return. Limit is the size of the page.
1659
+ * @param getTopHits.index - Index name to target.
1660
+ * @param getTopHits.search - User query.
1661
+ * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1662
+ * @param getTopHits.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1663
+ * @param getTopHits.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1664
+ * @param getTopHits.limit - Number of records to return (page size).
1665
1665
  * @param getTopHits.offset - Position of the starting record. Used for paging. 0 is the first record.
1666
- * @param getTopHits.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1666
+ * @param getTopHits.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1667
1667
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1668
1668
  */
1669
1669
  getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1706,19 +1706,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1706
1706
  return transporter.request(request, requestOptions);
1707
1707
  },
1708
1708
  /**
1709
- * Returns top searches. Limited to the 1000 most frequent ones. For each search, also returns the average number of hits returned.
1709
+ * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
1710
1710
  *
1711
1711
  * @summary Get top searches.
1712
1712
  * @param getTopSearches - The getTopSearches object.
1713
- * @param getTopSearches.index - The index name to target.
1714
- * @param getTopSearches.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1715
- * @param getTopSearches.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1716
- * @param getTopSearches.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1713
+ * @param getTopSearches.index - Index name to target.
1714
+ * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1715
+ * @param getTopSearches.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1716
+ * @param getTopSearches.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1717
1717
  * @param getTopSearches.orderBy - Reorder the results.
1718
- * @param getTopSearches.direction - The sorting of the result.
1719
- * @param getTopSearches.limit - Number of records to return. Limit is the size of the page.
1718
+ * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
1719
+ * @param getTopSearches.limit - Number of records to return (page size).
1720
1720
  * @param getTopSearches.offset - Position of the starting record. Used for paging. 0 is the first record.
1721
- * @param getTopSearches.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1721
+ * @param getTopSearches.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1722
1722
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1723
1723
  */
1724
1724
  getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
@@ -1764,14 +1764,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1764
1764
  return transporter.request(request, requestOptions);
1765
1765
  },
1766
1766
  /**
1767
- * Returns the distinct count of users across the given time range. The endpoint returns a value for the complete given time range, as well as a value per day.
1767
+ * Return the count of unique users.
1768
1768
  *
1769
- * @summary Get users count.
1769
+ * @summary Get user count.
1770
1770
  * @param getUsersCount - The getUsersCount object.
1771
- * @param getUsersCount.index - The index name to target.
1772
- * @param getUsersCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1773
- * @param getUsersCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1774
- * @param getUsersCount.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1771
+ * @param getUsersCount.index - Index name to target.
1772
+ * @param getUsersCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1773
+ * @param getUsersCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1774
+ * @param getUsersCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1775
1775
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1776
1776
  */
1777
1777
  getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1806,9 +1806,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1806
1806
  *
1807
1807
  * @summary Send requests to the Algolia REST API.
1808
1808
  * @param post - The post object.
1809
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1810
- * @param post.parameters - Query parameters to be applied to the current query.
1811
- * @param post.body - The parameters to send with the custom request.
1809
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1810
+ * @param post.parameters - Query parameters to apply to the current query.
1811
+ * @param post.body - Parameters to send with the custom request.
1812
1812
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1813
1813
  */
1814
1814
  post({ path, parameters, body }, requestOptions) {
@@ -1832,9 +1832,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1832
1832
  *
1833
1833
  * @summary Send requests to the Algolia REST API.
1834
1834
  * @param put - The put object.
1835
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1836
- * @param put.parameters - Query parameters to be applied to the current query.
1837
- * @param put.body - The parameters to send with the custom request.
1835
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1836
+ * @param put.parameters - Query parameters to apply to the current query.
1837
+ * @param put.body - Parameters to send with the custom request.
1838
1838
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1839
1839
  */
1840
1840
  put({ path, parameters, body }, requestOptions) {
@@ -1857,7 +1857,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1857
1857
  }
1858
1858
 
1859
1859
  // 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.
1860
- const apiClientVersion$2 = '5.0.0-alpha.73';
1860
+ const apiClientVersion$2 = '5.0.0-alpha.75';
1861
1861
  const REGIONS = ['eu', 'us'];
1862
1862
  function getDefaultHosts$1(region) {
1863
1863
  const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1919,8 +1919,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1919
1919
  *
1920
1920
  * @summary Send requests to the Algolia REST API.
1921
1921
  * @param del - The del object.
1922
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1923
- * @param del.parameters - Query parameters to be applied to the current query.
1922
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
1923
+ * @param del.parameters - Query parameters to apply to the current query.
1924
1924
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1925
1925
  */
1926
1926
  del({ path, parameters }, requestOptions) {
@@ -1966,8 +1966,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1966
1966
  *
1967
1967
  * @summary Send requests to the Algolia REST API.
1968
1968
  * @param get - The get object.
1969
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1970
- * @param get.parameters - Query parameters to be applied to the current query.
1969
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
1970
+ * @param get.parameters - Query parameters to apply to the current query.
1971
1971
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1972
1972
  */
1973
1973
  get({ path, parameters }, requestOptions) {
@@ -2031,9 +2031,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2031
2031
  *
2032
2032
  * @summary Send requests to the Algolia REST API.
2033
2033
  * @param post - The post object.
2034
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2035
- * @param post.parameters - Query parameters to be applied to the current query.
2036
- * @param post.body - The parameters to send with the custom request.
2034
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
2035
+ * @param post.parameters - Query parameters to apply to the current query.
2036
+ * @param post.body - Parameters to send with the custom request.
2037
2037
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2038
2038
  */
2039
2039
  post({ path, parameters, body }, requestOptions) {
@@ -2057,9 +2057,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2057
2057
  *
2058
2058
  * @summary Send requests to the Algolia REST API.
2059
2059
  * @param put - The put object.
2060
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2061
- * @param put.parameters - Query parameters to be applied to the current query.
2062
- * @param put.body - The parameters to send with the custom request.
2060
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
2061
+ * @param put.parameters - Query parameters to apply to the current query.
2062
+ * @param put.body - Parameters to send with the custom request.
2063
2063
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2064
2064
  */
2065
2065
  put({ path, parameters, body }, requestOptions) {
@@ -2114,7 +2114,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2114
2114
  }
2115
2115
 
2116
2116
  // 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.
2117
- const apiClientVersion$1 = '5.0.0-alpha.73';
2117
+ const apiClientVersion$1 = '5.0.0-alpha.75';
2118
2118
  function getDefaultHosts(appId) {
2119
2119
  return [
2120
2120
  {
@@ -2361,9 +2361,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2361
2361
  });
2362
2362
  },
2363
2363
  /**
2364
- * Add a new API Key with specific permissions/restrictions.
2364
+ * 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.
2365
2365
  *
2366
- * @summary Create an API key.
2366
+ * @summary Add API key.
2367
2367
  * @param apiKey - The apiKey object.
2368
2368
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2369
2369
  */
@@ -2387,13 +2387,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2387
2387
  return transporter.request(request, requestOptions);
2388
2388
  },
2389
2389
  /**
2390
- * 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.
2390
+ * 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).
2391
2391
  *
2392
- * @summary Add or replace an object.
2392
+ * @summary Add or update a record (using objectID).
2393
2393
  * @param addOrUpdateObject - The addOrUpdateObject object.
2394
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
2395
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
2396
- * @param addOrUpdateObject.body - The Algolia object.
2394
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
2395
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
2396
+ * @param addOrUpdateObject.body - Algolia record.
2397
2397
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2398
2398
  */
2399
2399
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -2421,10 +2421,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2421
2421
  return transporter.request(request, requestOptions);
2422
2422
  },
2423
2423
  /**
2424
- * Add a single source to the list of allowed sources.
2424
+ * Add a source to the list of allowed sources.
2425
2425
  *
2426
- * @summary Add a single source.
2427
- * @param source - The source to add.
2426
+ * @summary Add a source.
2427
+ * @param source - Source to add.
2428
2428
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2429
2429
  */
2430
2430
  appendSource(source, requestOptions) {
@@ -2447,9 +2447,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2447
2447
  return transporter.request(request, requestOptions);
2448
2448
  },
2449
2449
  /**
2450
- * 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.
2450
+ * 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.
2451
2451
  *
2452
- * @summary Assign or Move userID.
2452
+ * @summary Assign or move a user ID.
2453
2453
  * @param assignUserId - The assignUserId object.
2454
2454
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
2455
2455
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -2481,11 +2481,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2481
2481
  return transporter.request(request, requestOptions);
2482
2482
  },
2483
2483
  /**
2484
- * Perform multiple write operations targeting one index, in a single API call.
2484
+ * 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.
2485
2485
  *
2486
- * @summary Batch operations to one index.
2486
+ * @summary Batch write operations on one index.
2487
2487
  * @param batch - The batch object.
2488
- * @param batch.indexName - The index in which to perform the request.
2488
+ * @param batch.indexName - Index on which to perform the request.
2489
2489
  * @param batch.batchWriteParams - The batchWriteParams object.
2490
2490
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2491
2491
  */
@@ -2512,7 +2512,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2512
2512
  return transporter.request(request, requestOptions);
2513
2513
  },
2514
2514
  /**
2515
- * 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.
2515
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
2516
2516
  *
2517
2517
  * @summary Batch assign userIDs.
2518
2518
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -2549,11 +2549,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2549
2549
  return transporter.request(request, requestOptions);
2550
2550
  },
2551
2551
  /**
2552
- * Send a batch of dictionary entries.
2552
+ * Add or remove a batch of dictionary entries.
2553
2553
  *
2554
2554
  * @summary Batch dictionary entries.
2555
2555
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
2556
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
2556
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
2557
2557
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
2558
2558
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2559
2559
  */
@@ -2580,11 +2580,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2580
2580
  return transporter.request(request, requestOptions);
2581
2581
  },
2582
2582
  /**
2583
- * 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.
2583
+ * 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.
2584
2584
  *
2585
- * @summary Retrieve all index content.
2585
+ * @summary Get all records from an index.
2586
2586
  * @param browse - The browse object.
2587
- * @param browse.indexName - The index in which to perform the request.
2587
+ * @param browse.indexName - Index on which to perform the request.
2588
2588
  * @param browse.browseParams - The browseParams object.
2589
2589
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2590
2590
  */
@@ -2605,12 +2605,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2605
2605
  return transporter.request(request, requestOptions);
2606
2606
  },
2607
2607
  /**
2608
- * Remove all synonyms from an index.
2608
+ * Delete all synonyms in the index.
2609
2609
  *
2610
- * @summary Clear all synonyms.
2610
+ * @summary Delete all synonyms.
2611
2611
  * @param clearAllSynonyms - The clearAllSynonyms object.
2612
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
2613
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2612
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
2613
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2614
2614
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2615
2615
  */
2616
2616
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -2632,11 +2632,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2632
2632
  return transporter.request(request, requestOptions);
2633
2633
  },
2634
2634
  /**
2635
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
2635
+ * Delete the records but leave settings and index-specific API keys untouched.
2636
2636
  *
2637
- * @summary Clear all objects from an index.
2637
+ * @summary Delete all records from an index.
2638
2638
  * @param clearObjects - The clearObjects object.
2639
- * @param clearObjects.indexName - The index in which to perform the request.
2639
+ * @param clearObjects.indexName - Index on which to perform the request.
2640
2640
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2641
2641
  */
2642
2642
  clearObjects({ indexName }, requestOptions) {
@@ -2655,12 +2655,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2655
2655
  return transporter.request(request, requestOptions);
2656
2656
  },
2657
2657
  /**
2658
- * Delete all Rules in the index.
2658
+ * Delete all rules in the index.
2659
2659
  *
2660
- * @summary Clear Rules.
2660
+ * @summary Delete all rules.
2661
2661
  * @param clearRules - The clearRules object.
2662
- * @param clearRules.indexName - The index in which to perform the request.
2663
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2662
+ * @param clearRules.indexName - Index on which to perform the request.
2663
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2664
2664
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2665
2665
  */
2666
2666
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -2686,8 +2686,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2686
2686
  *
2687
2687
  * @summary Send requests to the Algolia REST API.
2688
2688
  * @param del - The del object.
2689
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2690
- * @param del.parameters - Query parameters to be applied to the current query.
2689
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
2690
+ * @param del.parameters - Query parameters to apply to the current query.
2691
2691
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2692
2692
  */
2693
2693
  del({ path, parameters }, requestOptions) {
@@ -2706,11 +2706,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2706
2706
  return transporter.request(request, requestOptions);
2707
2707
  },
2708
2708
  /**
2709
- * Delete an existing API Key.
2709
+ * Delete an existing API key. The request must be authenticated with the admin API key.
2710
2710
  *
2711
- * @summary Delete an API key.
2711
+ * @summary Delete API key.
2712
2712
  * @param deleteApiKey - The deleteApiKey object.
2713
- * @param deleteApiKey.key - API Key string.
2713
+ * @param deleteApiKey.key - API key.
2714
2714
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2715
2715
  */
2716
2716
  deleteApiKey({ key }, requestOptions) {
@@ -2729,11 +2729,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2729
2729
  return transporter.request(request, requestOptions);
2730
2730
  },
2731
2731
  /**
2732
- * 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.
2732
+ * 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.
2733
2733
  *
2734
- * @summary Delete all records matching the query.
2734
+ * @summary Delete all records matching a query.
2735
2735
  * @param deleteBy - The deleteBy object.
2736
- * @param deleteBy.indexName - The index in which to perform the request.
2736
+ * @param deleteBy.indexName - Index on which to perform the request.
2737
2737
  * @param deleteBy.deleteByParams - The deleteByParams object.
2738
2738
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2739
2739
  */
@@ -2761,7 +2761,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2761
2761
  *
2762
2762
  * @summary Delete index.
2763
2763
  * @param deleteIndex - The deleteIndex object.
2764
- * @param deleteIndex.indexName - The index in which to perform the request.
2764
+ * @param deleteIndex.indexName - Index on which to perform the request.
2765
2765
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2766
2766
  */
2767
2767
  deleteIndex({ indexName }, requestOptions) {
@@ -2780,12 +2780,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2780
2780
  return transporter.request(request, requestOptions);
2781
2781
  },
2782
2782
  /**
2783
- * Delete an existing object.
2783
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
2784
2784
  *
2785
- * @summary Delete an object.
2785
+ * @summary Delete a record.
2786
2786
  * @param deleteObject - The deleteObject object.
2787
- * @param deleteObject.indexName - The index in which to perform the request.
2788
- * @param deleteObject.objectID - Unique identifier of an object.
2787
+ * @param deleteObject.indexName - Index on which to perform the request.
2788
+ * @param deleteObject.objectID - Unique record (object) identifier.
2789
2789
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2790
2790
  */
2791
2791
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -2809,13 +2809,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2809
2809
  return transporter.request(request, requestOptions);
2810
2810
  },
2811
2811
  /**
2812
- * Delete the Rule with the specified objectID.
2812
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
2813
2813
  *
2814
2814
  * @summary Delete a rule.
2815
2815
  * @param deleteRule - The deleteRule object.
2816
- * @param deleteRule.indexName - The index in which to perform the request.
2817
- * @param deleteRule.objectID - Unique identifier of an object.
2818
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2816
+ * @param deleteRule.indexName - Index on which to perform the request.
2817
+ * @param deleteRule.objectID - Unique identifier of a rule object.
2818
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2819
2819
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2820
2820
  */
2821
2821
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2842,11 +2842,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2842
2842
  return transporter.request(request, requestOptions);
2843
2843
  },
2844
2844
  /**
2845
- * Remove a single source from the list of allowed sources.
2845
+ * Remove a source from the list of allowed sources.
2846
2846
  *
2847
- * @summary Remove a single source.
2847
+ * @summary Remove a source.
2848
2848
  * @param deleteSource - The deleteSource object.
2849
- * @param deleteSource.source - The IP range of the source.
2849
+ * @param deleteSource.source - IP address range of the source.
2850
2850
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2851
2851
  */
2852
2852
  deleteSource({ source }, requestOptions) {
@@ -2865,13 +2865,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2865
2865
  return transporter.request(request, requestOptions);
2866
2866
  },
2867
2867
  /**
2868
- * Delete a single synonyms set, identified by the given objectID.
2868
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
2869
2869
  *
2870
- * @summary Delete synonym.
2870
+ * @summary Delete a synonym.
2871
2871
  * @param deleteSynonym - The deleteSynonym object.
2872
- * @param deleteSynonym.indexName - The index in which to perform the request.
2873
- * @param deleteSynonym.objectID - Unique identifier of an object.
2874
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2872
+ * @param deleteSynonym.indexName - Index on which to perform the request.
2873
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
2874
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2875
2875
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2876
2876
  */
2877
2877
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2902,8 +2902,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2902
2902
  *
2903
2903
  * @summary Send requests to the Algolia REST API.
2904
2904
  * @param get - The get object.
2905
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2906
- * @param get.parameters - Query parameters to be applied to the current query.
2905
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
2906
+ * @param get.parameters - Query parameters to apply to the current query.
2907
2907
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2908
2908
  */
2909
2909
  get({ path, parameters }, requestOptions) {
@@ -2922,11 +2922,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2922
2922
  return transporter.request(request, requestOptions);
2923
2923
  },
2924
2924
  /**
2925
- * Get the permissions of an API key.
2925
+ * 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.
2926
2926
  *
2927
- * @summary Get an API key.
2927
+ * @summary Get API key permissions.
2928
2928
  * @param getApiKey - The getApiKey object.
2929
- * @param getApiKey.key - API Key string.
2929
+ * @param getApiKey.key - API key.
2930
2930
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2931
2931
  */
2932
2932
  getApiKey({ key }, requestOptions) {
@@ -2945,7 +2945,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2945
2945
  return transporter.request(request, requestOptions);
2946
2946
  },
2947
2947
  /**
2948
- * List dictionaries supported per language.
2948
+ * 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.
2949
2949
  *
2950
2950
  * @summary List available languages.
2951
2951
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2963,9 +2963,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2963
2963
  return transporter.request(request, requestOptions);
2964
2964
  },
2965
2965
  /**
2966
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
2966
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
2967
2967
  *
2968
- * @summary Retrieve dictionaries settings.
2968
+ * @summary Get stop word settings.
2969
2969
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2970
2970
  */
2971
2971
  getDictionarySettings(requestOptions) {
@@ -2981,13 +2981,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2981
2981
  return transporter.request(request, requestOptions);
2982
2982
  },
2983
2983
  /**
2984
- * Return the latest log entries.
2984
+ * 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).
2985
2985
  *
2986
2986
  * @summary Return the latest log entries.
2987
2987
  * @param getLogs - The getLogs object.
2988
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
2989
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
2990
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
2988
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
2989
+ * @param getLogs.length - Maximum number of entries to retrieve.
2990
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
2991
2991
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
2992
2992
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2993
2993
  */
@@ -3016,13 +3016,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3016
3016
  return transporter.request(request, requestOptions);
3017
3017
  },
3018
3018
  /**
3019
- * Retrieve one object from the index.
3019
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
3020
3020
  *
3021
- * @summary Retrieve an object.
3021
+ * @summary Get a record.
3022
3022
  * @param getObject - The getObject object.
3023
- * @param getObject.indexName - The index in which to perform the request.
3024
- * @param getObject.objectID - Unique identifier of an object.
3025
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
3023
+ * @param getObject.indexName - Index on which to perform the request.
3024
+ * @param getObject.objectID - Unique record (object) identifier.
3025
+ * @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.
3026
3026
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3027
3027
  */
3028
3028
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -3049,10 +3049,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3049
3049
  return transporter.request(request, requestOptions);
3050
3050
  },
3051
3051
  /**
3052
- * Retrieve one or more objects, potentially from different indices, in a single API call.
3052
+ * 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.
3053
3053
  *
3054
- * @summary Retrieve one or more objects.
3055
- * @param getObjectsParams - The Algolia object.
3054
+ * @summary Get multiple records.
3055
+ * @param getObjectsParams - Request object.
3056
3056
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3057
3057
  */
3058
3058
  getObjects(getObjectsParams, requestOptions) {
@@ -3077,12 +3077,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3077
3077
  return transporter.request(request, requestOptions);
3078
3078
  },
3079
3079
  /**
3080
- * Retrieve the Rule with the specified objectID.
3080
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
3081
3081
  *
3082
3082
  * @summary Get a rule.
3083
3083
  * @param getRule - The getRule object.
3084
- * @param getRule.indexName - The index in which to perform the request.
3085
- * @param getRule.objectID - Unique identifier of an object.
3084
+ * @param getRule.indexName - Index on which to perform the request.
3085
+ * @param getRule.objectID - Unique identifier of a rule object.
3086
3086
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3087
3087
  */
3088
3088
  getRule({ indexName, objectID }, requestOptions) {
@@ -3106,11 +3106,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3106
3106
  return transporter.request(request, requestOptions);
3107
3107
  },
3108
3108
  /**
3109
- * Retrieve settings of an index.
3109
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
3110
3110
  *
3111
- * @summary Retrieve settings of an index.
3111
+ * @summary Get index settings.
3112
3112
  * @param getSettings - The getSettings object.
3113
- * @param getSettings.indexName - The index in which to perform the request.
3113
+ * @param getSettings.indexName - Index on which to perform the request.
3114
3114
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3115
3115
  */
3116
3116
  getSettings({ indexName }, requestOptions) {
@@ -3129,9 +3129,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3129
3129
  return transporter.request(request, requestOptions);
3130
3130
  },
3131
3131
  /**
3132
- * List all allowed sources.
3132
+ * Get all allowed sources (IP addresses).
3133
3133
  *
3134
- * @summary List all allowed sources.
3134
+ * @summary Get all allowed IP addresses.
3135
3135
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3136
3136
  */
3137
3137
  getSources(requestOptions) {
@@ -3147,12 +3147,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3147
3147
  return transporter.request(request, requestOptions);
3148
3148
  },
3149
3149
  /**
3150
- * Fetch a synonym object identified by its objectID.
3150
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
3151
3151
  *
3152
- * @summary Get synonym.
3152
+ * @summary Get a synonym object.
3153
3153
  * @param getSynonym - The getSynonym object.
3154
- * @param getSynonym.indexName - The index in which to perform the request.
3155
- * @param getSynonym.objectID - Unique identifier of an object.
3154
+ * @param getSynonym.indexName - Index on which to perform the request.
3155
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
3156
3156
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3157
3157
  */
3158
3158
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -3176,12 +3176,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3176
3176
  return transporter.request(request, requestOptions);
3177
3177
  },
3178
3178
  /**
3179
- * Check the current status of a given task.
3179
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
3180
3180
  *
3181
- * @summary Check the status of a task.
3181
+ * @summary Check a task\'s status.
3182
3182
  * @param getTask - The getTask object.
3183
- * @param getTask.indexName - The index in which to perform the request.
3184
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
3183
+ * @param getTask.indexName - Index on which to perform the request.
3184
+ * @param getTask.taskID - Unique task identifier.
3185
3185
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3186
3186
  */
3187
3187
  getTask({ indexName, taskID }, requestOptions) {
@@ -3205,7 +3205,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3205
3205
  return transporter.request(request, requestOptions);
3206
3206
  },
3207
3207
  /**
3208
- * 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.
3208
+ * 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.
3209
3209
  *
3210
3210
  * @summary Get top userID.
3211
3211
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -3223,7 +3223,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3223
3223
  return transporter.request(request, requestOptions);
3224
3224
  },
3225
3225
  /**
3226
- * 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.
3226
+ * 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.
3227
3227
  *
3228
3228
  * @summary Get userID.
3229
3229
  * @param getUserId - The getUserId object.
@@ -3246,11 +3246,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3246
3246
  return transporter.request(request, requestOptions);
3247
3247
  },
3248
3248
  /**
3249
- * 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.
3249
+ * 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.
3250
3250
  *
3251
- * @summary Get migration status.
3251
+ * @summary Get migration and user mapping status.
3252
3252
  * @param hasPendingMappings - The hasPendingMappings object.
3253
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
3253
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
3254
3254
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3255
3255
  */
3256
3256
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -3269,9 +3269,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3269
3269
  return transporter.request(request, requestOptions);
3270
3270
  },
3271
3271
  /**
3272
- * List API keys, along with their associated rights.
3272
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
3273
3273
  *
3274
- * @summary List API Keys.
3274
+ * @summary List API keys.
3275
3275
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3276
3276
  */
3277
3277
  listApiKeys(requestOptions) {
@@ -3287,7 +3287,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3287
3287
  return transporter.request(request, requestOptions);
3288
3288
  },
3289
3289
  /**
3290
- * 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.
3290
+ * List the available clusters in a multi-cluster setup.
3291
3291
  *
3292
3292
  * @summary List clusters.
3293
3293
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -3305,20 +3305,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3305
3305
  return transporter.request(request, requestOptions);
3306
3306
  },
3307
3307
  /**
3308
- * List existing indexes from an application.
3308
+ * List indices in an Algolia application.
3309
3309
  *
3310
- * @summary List existing indexes.
3310
+ * @summary List indices.
3311
3311
  * @param listIndices - The listIndices object.
3312
- * @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).
3312
+ * @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.
3313
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
3313
3314
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3314
3315
  */
3315
- listIndices({ page } = {}, requestOptions = undefined) {
3316
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
3316
3317
  const requestPath = '/1/indexes';
3317
3318
  const headers = {};
3318
3319
  const queryParameters = {};
3319
3320
  if (page !== undefined) {
3320
3321
  queryParameters.page = page.toString();
3321
3322
  }
3323
+ if (hitsPerPage !== undefined) {
3324
+ queryParameters.hitsPerPage = hitsPerPage.toString();
3325
+ }
3322
3326
  const request = {
3323
3327
  method: 'GET',
3324
3328
  path: requestPath,
@@ -3328,12 +3332,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3328
3332
  return transporter.request(request, requestOptions);
3329
3333
  },
3330
3334
  /**
3331
- * 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.
3335
+ * 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.
3332
3336
  *
3333
3337
  * @summary List userIDs.
3334
3338
  * @param listUserIds - The listUserIds object.
3335
- * @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).
3336
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
3339
+ * @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.
3340
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
3337
3341
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3338
3342
  */
3339
3343
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -3355,9 +3359,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3355
3359
  return transporter.request(request, requestOptions);
3356
3360
  },
3357
3361
  /**
3358
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
3362
+ * 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.
3359
3363
  *
3360
- * @summary Batch operations to many indices.
3364
+ * @summary Batch write operations on multiple indices.
3361
3365
  * @param batchParams - The batchParams object.
3362
3366
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3363
3367
  */
@@ -3381,11 +3385,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3381
3385
  return transporter.request(request, requestOptions);
3382
3386
  },
3383
3387
  /**
3384
- * Performs a copy or a move operation on a index.
3388
+ * 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/).
3385
3389
  *
3386
- * @summary Copy/move index.
3390
+ * @summary Copy, move, or rename an index.
3387
3391
  * @param operationIndex - The operationIndex object.
3388
- * @param operationIndex.indexName - The index in which to perform the request.
3392
+ * @param operationIndex.indexName - Index on which to perform the request.
3389
3393
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
3390
3394
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3391
3395
  */
@@ -3415,14 +3419,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3415
3419
  return transporter.request(request, requestOptions);
3416
3420
  },
3417
3421
  /**
3418
- * 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.
3422
+ * 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.
3419
3423
  *
3420
- * @summary Partially update an object.
3424
+ * @summary Update record attributes.
3421
3425
  * @param partialUpdateObject - The partialUpdateObject object.
3422
- * @param partialUpdateObject.indexName - The index in which to perform the request.
3423
- * @param partialUpdateObject.objectID - Unique identifier of an object.
3424
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
3425
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
3426
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
3427
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
3428
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
3429
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
3426
3430
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3427
3431
  */
3428
3432
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -3457,9 +3461,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3457
3461
  *
3458
3462
  * @summary Send requests to the Algolia REST API.
3459
3463
  * @param post - The post object.
3460
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
3461
- * @param post.parameters - Query parameters to be applied to the current query.
3462
- * @param post.body - The parameters to send with the custom request.
3464
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
3465
+ * @param post.parameters - Query parameters to apply to the current query.
3466
+ * @param post.body - Parameters to send with the custom request.
3463
3467
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3464
3468
  */
3465
3469
  post({ path, parameters, body }, requestOptions) {
@@ -3483,9 +3487,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3483
3487
  *
3484
3488
  * @summary Send requests to the Algolia REST API.
3485
3489
  * @param put - The put object.
3486
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
3487
- * @param put.parameters - Query parameters to be applied to the current query.
3488
- * @param put.body - The parameters to send with the custom request.
3490
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
3491
+ * @param put.parameters - Query parameters to apply to the current query.
3492
+ * @param put.body - Parameters to send with the custom request.
3489
3493
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3490
3494
  */
3491
3495
  put({ path, parameters, body }, requestOptions) {
@@ -3505,7 +3509,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3505
3509
  return transporter.request(request, requestOptions);
3506
3510
  },
3507
3511
  /**
3508
- * 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.
3512
+ * Remove a userID and its associated data from the multi-clusters.
3509
3513
  *
3510
3514
  * @summary Remove userID.
3511
3515
  * @param removeUserId - The removeUserId object.
@@ -3530,9 +3534,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3530
3534
  /**
3531
3535
  * Replace all allowed sources.
3532
3536
  *
3533
- * @summary Replace all allowed sources.
3537
+ * @summary Replace all sources.
3534
3538
  * @param replaceSources - The replaceSources object.
3535
- * @param replaceSources.source - The sources to allow.
3539
+ * @param replaceSources.source - Allowed sources.
3536
3540
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3537
3541
  */
3538
3542
  replaceSources({ source }, requestOptions) {
@@ -3552,11 +3556,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3552
3556
  return transporter.request(request, requestOptions);
3553
3557
  },
3554
3558
  /**
3555
- * Restore a deleted API key, along with its associated rights.
3559
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
3556
3560
  *
3557
- * @summary Restore an API key.
3561
+ * @summary Restore API key.
3558
3562
  * @param restoreApiKey - The restoreApiKey object.
3559
- * @param restoreApiKey.key - API Key string.
3563
+ * @param restoreApiKey.key - API key.
3560
3564
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3561
3565
  */
3562
3566
  restoreApiKey({ key }, requestOptions) {
@@ -3575,11 +3579,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3575
3579
  return transporter.request(request, requestOptions);
3576
3580
  },
3577
3581
  /**
3578
- * Add an object to the index, automatically assigning it an object ID.
3582
+ * 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).
3579
3583
  *
3580
- * @summary Add an object to the index.
3584
+ * @summary Add or update a record.
3581
3585
  * @param saveObject - The saveObject object.
3582
- * @param saveObject.indexName - The index in which to perform the request.
3586
+ * @param saveObject.indexName - Index on which to perform the request.
3583
3587
  * @param saveObject.body - The Algolia record.
3584
3588
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3585
3589
  */
@@ -3603,14 +3607,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3603
3607
  return transporter.request(request, requestOptions);
3604
3608
  },
3605
3609
  /**
3606
- * Create or update the Rule with the specified objectID.
3610
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
3607
3611
  *
3608
- * @summary Save/Update a rule.
3612
+ * @summary Create or update a rule.
3609
3613
  * @param saveRule - The saveRule object.
3610
- * @param saveRule.indexName - The index in which to perform the request.
3611
- * @param saveRule.objectID - Unique identifier of an object.
3614
+ * @param saveRule.indexName - Index on which to perform the request.
3615
+ * @param saveRule.objectID - Unique identifier of a rule object.
3612
3616
  * @param saveRule.rule - The rule object.
3613
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3617
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3614
3618
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3615
3619
  */
3616
3620
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -3644,14 +3648,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3644
3648
  return transporter.request(request, requestOptions);
3645
3649
  },
3646
3650
  /**
3647
- * Create/update multiple rules objects at once.
3651
+ * Create or update multiple rules.
3648
3652
  *
3649
3653
  * @summary Save a batch of rules.
3650
3654
  * @param saveRules - The saveRules object.
3651
- * @param saveRules.indexName - The index in which to perform the request.
3655
+ * @param saveRules.indexName - Index on which to perform the request.
3652
3656
  * @param saveRules.rules - The rules object.
3653
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3654
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
3657
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3658
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
3655
3659
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3656
3660
  */
3657
3661
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -3680,14 +3684,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3680
3684
  return transporter.request(request, requestOptions);
3681
3685
  },
3682
3686
  /**
3683
- * Create a new synonym object or update the existing synonym object with the given object ID.
3687
+ * 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).
3684
3688
  *
3685
- * @summary Save synonym.
3689
+ * @summary Save a synonym.
3686
3690
  * @param saveSynonym - The saveSynonym object.
3687
- * @param saveSynonym.indexName - The index in which to perform the request.
3688
- * @param saveSynonym.objectID - Unique identifier of an object.
3691
+ * @param saveSynonym.indexName - Index on which to perform the request.
3692
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
3689
3693
  * @param saveSynonym.synonymHit - The synonymHit object.
3690
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3694
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3691
3695
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3692
3696
  */
3693
3697
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -3724,14 +3728,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3724
3728
  return transporter.request(request, requestOptions);
3725
3729
  },
3726
3730
  /**
3727
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
3731
+ * Create or update multiple synonyms.
3728
3732
  *
3729
3733
  * @summary Save a batch of synonyms.
3730
3734
  * @param saveSynonyms - The saveSynonyms object.
3731
- * @param saveSynonyms.indexName - The index in which to perform the request.
3735
+ * @param saveSynonyms.indexName - Index on which to perform the request.
3732
3736
  * @param saveSynonyms.synonymHit - The synonymHit object.
3733
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3734
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
3737
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3738
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
3735
3739
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3736
3740
  */
3737
3741
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -3761,10 +3765,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3761
3765
  return transporter.request(request, requestOptions);
3762
3766
  },
3763
3767
  /**
3764
- * Perform a search operation targeting one or many indices.
3768
+ * Send multiple search queries to one or more indices.
3765
3769
  *
3766
3770
  * @summary Search multiple indices.
3767
- * @param searchMethodParams - The `search` requests and strategy.
3771
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
3768
3772
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3769
3773
  */
3770
3774
  search(searchMethodParams, requestOptions) {
@@ -3811,11 +3815,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3811
3815
  return transporter.request(request, requestOptions);
3812
3816
  },
3813
3817
  /**
3814
- * Search the dictionary entries.
3818
+ * 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.
3815
3819
  *
3816
- * @summary Search a dictionary entries.
3820
+ * @summary Search dictionary entries.
3817
3821
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
3818
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
3822
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
3819
3823
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
3820
3824
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3821
3825
  */
@@ -3844,12 +3848,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3844
3848
  return transporter.request(request, requestOptions);
3845
3849
  },
3846
3850
  /**
3847
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
3851
+ * [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`.
3848
3852
  *
3849
- * @summary Search for values of a given facet.
3853
+ * @summary Search for facet values.
3850
3854
  * @param searchForFacetValues - The searchForFacetValues object.
3851
- * @param searchForFacetValues.indexName - The index in which to perform the request.
3852
- * @param searchForFacetValues.facetName - The facet name.
3855
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
3856
+ * @param searchForFacetValues.facetName - Facet name.
3853
3857
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
3854
3858
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3855
3859
  */
@@ -3877,11 +3881,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3877
3881
  return transporter.request(request, requestOptions);
3878
3882
  },
3879
3883
  /**
3880
- * Search for rules matching various criteria.
3884
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
3881
3885
  *
3882
3886
  * @summary Search for rules.
3883
3887
  * @param searchRules - The searchRules object.
3884
- * @param searchRules.indexName - The index in which to perform the request.
3888
+ * @param searchRules.indexName - Index on which to perform the request.
3885
3889
  * @param searchRules.searchRulesParams - The searchRulesParams object.
3886
3890
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3887
3891
  */
@@ -3904,11 +3908,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3904
3908
  return transporter.request(request, requestOptions);
3905
3909
  },
3906
3910
  /**
3907
- * Perform a search operation targeting one specific index.
3911
+ * Return records that match the query.
3908
3912
  *
3909
- * @summary Search in a single index.
3913
+ * @summary Search an index.
3910
3914
  * @param searchSingleIndex - The searchSingleIndex object.
3911
- * @param searchSingleIndex.indexName - The index in which to perform the request.
3915
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
3912
3916
  * @param searchSingleIndex.searchParams - The searchParams object.
3913
3917
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3914
3918
  */
@@ -3931,15 +3935,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3931
3935
  return transporter.request(request, requestOptions);
3932
3936
  },
3933
3937
  /**
3934
- * Search or browse all synonyms, optionally filtering them by type.
3938
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
3935
3939
  *
3936
- * @summary Search synonyms.
3940
+ * @summary Search for synonyms.
3937
3941
  * @param searchSynonyms - The searchSynonyms object.
3938
- * @param searchSynonyms.indexName - The index in which to perform the request.
3939
- * @param searchSynonyms.type - Only search for specific types of synonyms.
3940
- * @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).
3941
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
3942
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
3942
+ * @param searchSynonyms.indexName - Index on which to perform the request.
3943
+ * @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).
3944
+ * @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.
3945
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
3946
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
3943
3947
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3944
3948
  */
3945
3949
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -3970,9 +3974,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3970
3974
  return transporter.request(request, requestOptions);
3971
3975
  },
3972
3976
  /**
3973
- * 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.
3977
+ * 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).
3974
3978
  *
3975
- * @summary Search userID.
3979
+ * @summary Search for a user ID.
3976
3980
  * @param searchUserIdsParams - The searchUserIdsParams object.
3977
3981
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3978
3982
  */
@@ -3998,9 +4002,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3998
4002
  return transporter.request(request, requestOptions);
3999
4003
  },
4000
4004
  /**
4001
- * Set dictionaries settings.
4005
+ * Set stop word settings for a specific language.
4002
4006
  *
4003
- * @summary Set dictionaries settings.
4007
+ * @summary Set stop word settings.
4004
4008
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
4005
4009
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
4006
4010
  */
@@ -4024,13 +4028,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
4024
4028
  return transporter.request(request, requestOptions);
4025
4029
  },
4026
4030
  /**
4027
- * 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.
4031
+ * 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.
4028
4032
  *
4029
- * @summary Update settings of an index.
4033
+ * @summary Update index settings.
4030
4034
  * @param setSettings - The setSettings object.
4031
- * @param setSettings.indexName - The index in which to perform the request.
4035
+ * @param setSettings.indexName - Index on which to perform the request.
4032
4036
  * @param setSettings.indexSettings - The indexSettings object.
4033
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
4037
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
4034
4038
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
4035
4039
  */
4036
4040
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -4056,11 +4060,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
4056
4060
  return transporter.request(request, requestOptions);
4057
4061
  },
4058
4062
  /**
4059
- * Replace every permission of an existing API key.
4063
+ * 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.
4060
4064
  *
4061
4065
  * @summary Update an API key.
4062
4066
  * @param updateApiKey - The updateApiKey object.
4063
- * @param updateApiKey.key - API Key string.
4067
+ * @param updateApiKey.key - API key.
4064
4068
  * @param updateApiKey.apiKey - The apiKey object.
4065
4069
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
4066
4070
  */