Delete Synonym Map (Azure Cognitive Search REST API)


The Delete Synonym Map operation removes a synonym map from your Azure Cognitive Search service.

DELETE https://[service name][synonymmap name]?api-version=[api-version]  
api-key: [admin key]  


Please ensure that no field in a search index is referencing the synonym map that you are deleting. The delete operation will still proceed but searches against the fields will fail with 400 (Bad Request) with the error message that the synonym map has been deleted.

The api-version is required. The current version is 2019-05-06. See API versions in Azure Cognitive Search for details.

Request Headers

The following table describes the required and optional request headers.

Request Header Description
api-key: Required. The api-key is used to authenticate the request to your Search service. It is a string value, unique to your service URL. The Delete Synonym Map request must include an api-key header set to your admin key (as opposed to a query key).

You will also need the service name to construct the request URL. You can get the service name and api-key from your service dashboard in the Azure portal. See Create an Azure Cognitive Search service in the portal for page navigation help.


Status Code: 204 No Content is returned for a successful response.

See also

Azure Cognitive Search REST APIs
HTTP status codes (Azure Cognitive Search)
Synonym map operations (Azure Cognitive Search REST API)
Naming rules (Azure Cognitive Search)