[[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