kibana/docs/api/alerting/legacy/delete.asciidoc
2021-03-31 14:36:48 -07:00

43 lines
1,010 B
Text

[[alerts-api-delete]]
=== Legacy delete alert API
++++
<titleabbrev>Legacy delete alert</titleabbrev>
++++
deprecated::[7.13.0,Use <<delete-rule-api>> instead.]
Permanently remove an alert.
WARNING: Once you delete an alert, you cannot recover it.
[[alerts-api-delete-request]]
==== Request
`DELETE <kibana host>:<port>/api/alerts/alert/<id>`
`DELETE <kibana host>:<port>/s/<space_id>/api/alerts/alert/<id>`
[[alerts-api-delete-path-params]]
==== Path parameters
`id`::
(Required, string) The ID of the alert that you want to remove.
`space_id`::
(Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
[[alerts-api-delete-response-codes]]
==== Response code
`200`::
Indicates a successful call.
==== Example
Delete an alert with ID:
[source,sh]
--------------------------------------------------
$ curl -X DELETE api/alerts/alert/41893910-6bca-11eb-9e0d-85d233e3ee35
--------------------------------------------------
// KIBANA