mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 02:09:32 -04:00
54 lines
1.4 KiB
Text
54 lines
1.4 KiB
Text
[[delete-rule-api]]
|
|
== Delete rule API
|
|
++++
|
|
<titleabbrev>Delete rule</titleabbrev>
|
|
++++
|
|
|
|
Permanently removes a rule.
|
|
|
|
WARNING: After you delete a rule, you cannot recover it.
|
|
|
|
[NOTE]
|
|
====
|
|
For the most up-to-date API details, refer to the
|
|
{kib-repo}/tree/{branch}/x-pack/plugins/alerting/docs/openapi[open API specification].
|
|
====
|
|
|
|
[[delete-rule-api-request]]
|
|
=== {api-request-title}
|
|
|
|
`DELETE <kibana host>:<port>/api/alerting/rule/<id>`
|
|
|
|
`DELETE <kibana host>:<port>/s/<space_id>/api/alerting/rule/<id>`
|
|
|
|
=== {api-prereq-title}
|
|
|
|
You must have `all` privileges for the appropriate {kib} features, depending on
|
|
the `consumer` and `rule_type_id` of the rule you're deleting. For example, the
|
|
*Management* > *Stack Rules* feature, *Analytics* > *Discover* or *{ml-app}*
|
|
features, *{observability}*, or *Security* features. For more details, refer to
|
|
<<kibana-feature-privileges>>.
|
|
|
|
[[delete-rule-api-path-params]]
|
|
=== {api-path-parms-title}
|
|
|
|
`id`::
|
|
(Required, string) The identifier of the rule that you want to remove.
|
|
|
|
`space_id`::
|
|
(Optional, string) An identifier for the space. If it is not specified, the
|
|
default space is used.
|
|
|
|
[[delete-rule-api-response-codes]]
|
|
=== {api-response-codes-title}
|
|
|
|
`204`::
|
|
Indicates a successful call.
|
|
|
|
=== {api-examples-title}
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
DELETE api/alerting/rule/41893910-6bca-11eb-9e0d-85d233e3ee35
|
|
--------------------------------------------------
|
|
// KIBANA
|