Delete a synonym rule

DELETE /_synonyms/{set_id}/{rule_id}

Api key auth Basic auth Bearer auth

Delete a synonym rule from a synonym set.

Required authorization

Cluster privileges: manage_search_synonyms

Path Parameters

Query Parameters

refresh boolean · default: true: If true, the request will refresh the analyzers with the deleted synonym rule and wait for the new synonyms to be available before returning. If false, analyzers will not be reloaded with the deleted synonym rule

Response

application/json

Examples

A successful response from DELETE _synonyms/my-synonyms-set/test-1. All analyzers using this synonyms set will be reloaded automatically to reflect the rule being deleted.

Request Console 1 / 8 languages

Console Kibana Dev Tools

DELETE _synonyms/my-synonyms-set/test-1

JavaScript Elasticsearch JavaScript Client

const response = await client.synonyms.deleteSynonymRule({
  set_id: "my-synonyms-set",
  rule_id: "test-1",
});

Python Elasticsearch Python Client

resp = client.synonyms.delete_synonym_rule(
    set_id="my-synonyms-set",
    rule_id="test-1",
)

curl Shell

curl -X DELETE "$ELASTICSEARCH_URL/_synonyms/my-synonyms-set/test-1" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"

Java Elasticsearch Java Client

client.synonyms().deleteSynonymRule(d -> d
    .ruleId("test-1")
    .setId("my-synonyms-set")
);

C# Elasticsearch .NET Client

var response = await client.Synonyms.DeleteSynonymRuleAsync(setId: "my-synonyms-set", ruleId: "test-1");

PHP Elasticsearch PHP Client

$resp = $client->synonyms()->deleteSynonymRule([
    "set_id" => "my-synonyms-set",
    "rule_id" => "test-1",
]);

Ruby Elasticsearch Ruby Client

response = client.synonyms.delete_synonym_rule(
  set_id: "my-synonyms-set",
  rule_id: "test-1"
)

Response

{
  "result": "deleted",
  "reload_analyzers_details": {
    "_shards": {
      "total": 2,
      "successful": 1,
      "failed": 0
    },
    "reload_details": [
      {
        "index": "test-index",
        "reloaded_analyzers": [
          "my_search_analyzer"
        ],
        "reloaded_node_ids": [
          "1wYFZzq8Sxeu_Jvt9mlbkg"
        ]
      }
    ]
  }
}

Required authorization

Path Parameters { set_id , rule_id , }

Query Parameters

Response

Path Parameters