IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Create rule API Disable rule API »
Elastic Docs ›Kibana Guide [8.7] ›REST API ›Alerting APIs

Delete rule API

edit

Delete rule API

edit

Permanently removes a rule.

After you delete a rule, you cannot recover it.

For the most up-to-date API details, refer to the open API specification.

Request

edit

DELETE <kibana host>:<port>/api/alerting/rule/<id>

DELETE <kibana host>:<port>/s/<space_id>/api/alerting/rule/<id>

Prerequisites

edit

You must have all privileges for the appropriate Kibana 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 Machine Learning features, Observability, or Security features. For more details, refer to Feature privileges.

Path parameters

edit
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.

Response codes

edit
204
Indicates a successful call.

Examples

edit
DELETE api/alerting/rule/41893910-6bca-11eb-9e0d-85d233e3ee35
« Create rule API Disable rule API »