Skip to main content
The latest major version of the algoliasearch package is version 4. This page lists the breaking changes introduced since the previous major release, version 3.

​
Method changes overview

The following table has links for all methods and their replacements

​
Search API client

Version 3 (legacy)Version 4 (current)
client.addApiKey→client.addApiKey
client.addApiKey.wait→client.waitForApiKey
client.clearDictionaryEntries→client.batchDictionaryEntries
client.copyIndex→client.operationIndex
client.copyRules→client.operationIndex
client.copySynonyms→client.operationIndex
client.deleteApiKey→client.deleteApiKey
client.deleteDictionaryEntries→client.batchDictionaryEntries
client.generateSecuredApiKey→client.generateSecuredApiKey
client.getApiKey→client.getApiKey
client.getSecuredApiKeyRemainingValidity→client.getSecuredApiKeyRemainingValidity
client.listApiKeys→client.listApiKeys
client.listIndices→client.listIndices
client.moveIndex→client.operationIndex
client.multipleBatch→client.multipleBatch
client.multipleQueries→client.search
client.replaceDictionaryEntries→client.batchDictionaryEntries
client.restoreApiKey→client.restoreApiKey
client.saveDictionaryEntries→client.batchDictionaryEntries
client.updateApiKey→client.updateApiKey
index.batch→client.batch
index.browseObjects→client.browseObjects
index.browseRules→client.browseRules
index.browseSynonyms→client.browseSynonyms
index.clearObjects→client.clearObjects
index.clearRules→client.clearRules
index.clearSynonyms→client.clearSynonyms
index.copySettings→client.operationIndex
index.delete→client.deleteIndex
index.deleteBy→client.deleteBy
index.deleteObject→client.deleteObject
index.deleteObjects→client.deleteObjects
index.deleteRule→client.deleteRule
index.deleteSynonym→client.deleteSynonym
index.findObject→client.searchSingleIndex
index.getObject→client.getObject
index.getObjects→client.getObjects
index.getRule→client.getRule
index.getSettings→client.getSettings
index.getSynonym→client.getSynonym
index.getTask→client.getTask
index.partialUpdateObject→client.partialUpdateObject
index.partialUpdateObjects→client.partialUpdateObjects
index.replaceAllObjects→client.replaceAllObjects
index.replaceAllRules→client.saveRules
index.replaceAllSynonyms→client.saveSynonyms
index.saveObject→client.saveObject
index.saveObjects→client.saveObjects
index.saveRule→client.saveRule
index.saveRules→client.saveRules
index.saveSynonym→client.saveSynonym
index.saveSynonyms→client.saveSynonyms
index.search→client.searchSingleIndex
index.searchForFacetValues→client.searchForFacetValues
index.searchRules→client.searchRules
index.searchSynonyms→client.searchSynonyms
index.setSettings→client.setSettings
index.{operation}.wait→client.waitForTask

​
Recommend API client

Version 3 (legacy)Version 4 (current)
client.getFrequentlyBoughtTogether→client.getRecommendations
client.getRecommendations→client.getRecommendations
client.getRelatedProducts→client.getRecommendations

​
Removal of initIndex

All methods are methods of a client instance. The initIndex method of the SearchClient class has been removed. Instead, all methods require a indexName parameter.
Java
// version 3
var client = DefaultSearchClient.create("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY");
var index = client.initIndex("ALGOLIA_INDEX_NAME", Record.class);
index.search(new Query("QUERY"));

// version 4
var client = new SearchClient("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY");
client.searchSingleIndex(
    "ALGOLIA_INDEX_NAME",
    new SearchParamsObject().setQuery("QUERY"),
    Hit.class,
)

​
Wait for tasks

The wait method has been removed. Instead, use one of the following helpers:

​
Copy or move indices, settings, synonyms, or rules

Use the operationIndex method, which replaces the following methods:
  • copyIndex
  • moveIndex
  • copyRules
  • copySynonyms
  • copySettings
⌘I