Delete synonym ruleedit

This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

Deletes an individual synonym rule from a synonyms set.


DELETE _synonyms/<synonyms_set>/<synonym_rule>


Requires the manage_search_synonyms cluster privilege.

Path parametersedit

(Required, string) Synonyms set identifier to update.
(Required, string) Synonym rule identifier to delete.

Response codesedit

404 (Missing resources)
The synonyms_set identifier was not found, or the synonym rule specified by synonym_rule was not found in the synonyms set.


The following example deletes an existing synonym rule called test-1 for the synonyms set my-synonyms-set:

DELETE _synonyms/my-synonyms-set/test-1
  "result": "deleted",
  "reload_analyzers_details": {
    "_shards": {
      "total": 2,
      "successful": 1,
      "failed": 0
    "reload_details": [
        "index": "test-index",
        "reloaded_analyzers": [
        "reloaded_node_ids": [

All analyzers using this synonyms set will be reloaded automatically to reflect the rule being deleted.