Delete a synonym rule

DELETE /_synonyms/{set_id}/{rule_id}

Delete a synonym rule from a synonym set.

Required authorization

Authentication

Authorization: <value>

Elasticsearch APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example:

		curl -X GET "${ES_URL}/_cat/indices?v=true" \
  -H "Authorization: ApiKey ${API_KEY}"

For more information about where to find API keys for the Elasticsearch endpoint (${ES_URL}) for a project, go to Get started with Elasticsearch Serverless.

Path parameters

Response

application/json

result enum required: The update operation result.; Values: created updated deleted not_found noop
reload_analyzers_details object: Updating synonyms in a synonym set can reload the associated analyzers in case refresh is set to true. This information is the analyzers reloading result.

Examples

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

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.

{
  "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"
        ]
      }
    ]
  }
}