Save dictionary entries

Send a batch of entries to a dictionary.

This page documents an earlier version of the API client. For the latest version, see Add or delete dictionary entries.

Required ACL: editSettings

Examples

Save stopword entries

C#

Stopword stopword = new Stopword()
{
  ObjectID = objectId,
  Language = "en",
  Word = "upper",
  State = "enabled"
};

// Synchronous
var saveDictionaryResponse = DictionaryClient.SaveDictionaryEntries(algoliaDictionary, new List<DictionaryEntry>() { stopword });

// Asynchronous
var saveDictionaryResponse = DictionaryClient.SaveDictionaryEntriesAsync(algoliaDictionary, new List<DictionaryEntry>() { stopword });
saveDictionaryResponse.Wait();

Save plural entries

C#

Plural plural = new Plural()
{
  ObjectID = objectId,
  Language = "fr",
  Words = new List<String>() { "cheval", "chevaux" }
};

// Synchronous
DictionaryClient.SaveDictionaryEntries(algoliaDictionary, new List<DictionaryEntry>() { plural });

// Asynchronous
var saveDictionaryResponse = await DictionaryClient.SaveDictionaryEntries(algoliaDictionary, new List<DictionaryEntry>() { plural });
saveDictionaryResponse.Wait();

Save compound entries

C#

Compound compound = new Compound()
{
  ObjectID = objectId,
  Language = "nl",
  Word = "kopfschmerztablette",
  Decomposition = new List<String>() { "kopf", "schmerz", "tablette" }
};

// Synchronous
DictionaryClient.SaveDictionaryEntries(algoliaDictionary, new List<DictionaryEntry>() { compound });

// Asynchronous
var saveDictionaryResponse = await DictionaryClient.SaveDictionaryEntriesAsync(algoliaDictionary, new List<DictionaryEntry>() { compound });
saveDictionaryResponse.Wait();

Parameters

dictionary · enum<string> · required

Dictionary type. One of: stopword, plural, compound.

dictionaryEntries · object[] · required

The dictionary entries to add.

Show child attributes

objectID · string · required

Unique ID of the dictionary entry.

language · string · required

Language ISO code supported by this dictionary, for example en for English.

decomposition · string[]

List of decompositions of a word for the compounds dictionary. If empty, word is considered a compound atom. Otherwise, the compounds that word is decomposed into.

state · enum<string> · default: "enabled"

Whether this dictionary entry is active:

• enabled: this dictionary entry is active
• disabled: this dictionary entry is inactive

word · string

For the stop-word dictionary: the stop word you want to add. For the compounds dictionary:

• Adds the word as compound atom (with empty decomposition)
• Adds the word with a custom decomposition

If the word is already included in Algolia’s standard dictionary, you can override it by setting its state to disabled.

words · string[]

List of declensions for the plurals dictionary.

requestOptions · object

Additional parameters to add to this request.

Response

taskID · integer

The task ID used with the waitTask method.

updatedAt · string

Date at which the indexing job has been created.

Response as JSON

This section shows the JSON response returned by the API. Each API client wraps this response in language-specific objects, so the structure may vary. To view the response, use the getLogs method. Don’t rely on the order of properties—JSON objects don’t preserve key order.

JSON

{
  "updatedAt":"2013-01-18T15:33:13.556Z",
  "taskID": 678
}