---
type: api
title: Synonyms
description: The synonyms management API provides a convenient way to define and manage synonyms in an internal system index. Related synonyms can be grouped in a "synonyms set". Create as many synonym sets as you need.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/group/endpoint-synonyms
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/group/endpoint-synonyms
products:
  - Elasticsearch
---

# Synonyms

`synonyms`

The synonyms management API provides a convenient way to define and manage synonyms in an internal system index. Related synonyms can be grouped in a "synonyms set". Create as many synonym sets as you need.

- [Get a synonym set](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-get-synonym): `GET` `/_synonyms/{id}`
- [Create or update a synonym set](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-put-synonym): `PUT` `/_synonyms/{id}`
- [Delete a synonym set](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-delete-synonym): `DELETE` `/_synonyms/{id}`
- [Get a synonym rule](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-get-synonym-rule): `GET` `/_synonyms/{set_id}/{rule_id}`
- [Create or update a synonym rule](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-put-synonym-rule): `PUT` `/_synonyms/{set_id}/{rule_id}`
- [Delete a synonym rule](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-delete-synonym-rule): `DELETE` `/_synonyms/{set_id}/{rule_id}`
- [Get all synonym sets](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-synonyms-get-synonyms-sets): `GET` `/_synonyms`