elasticsearch/docs/reference/search-application/apis/delete-search-application.asciidoc

49 lines
1.1 KiB
Text

[role="xpack"]
[[delete-search-application]]
=== Delete Search Application
preview::[]
++++
<titleabbrev>Delete Search Application</titleabbrev>
++++
Removes a Search Application and its associated alias.
Indices attached to the Search Application are not removed.
[[delete-search-application-request]]
==== {api-request-title}
`DELETE _application/search_application/<name>`
[[delete-search-application-prereq]]
==== {api-prereq-title}
Requires the `manage_search_application` cluster privilege.
Also requires <<privileges-list-indices,manage privileges>> on all indices that are included in the Search Application.
[[delete-search-application-path-params]]
==== {api-path-parms-title}
`<name>`::
(Required, string)
[[delete-search-application-response-codes]]
==== {api-response-codes-title}
`400`::
The `name` was not provided.
`404` (Missing resources)::
No Search Application matching `name` could be found.
[[delete-search-application-example]]
==== {api-examples-title}
The following example deletes the Search Application named `my-app`:
[source,console]
----
DELETE _application/search_application/my-app/
----
// TEST[skip:TBD]