elasticsearch/docs/reference/slm/apis/slm-delete.asciidoc

[role="xpack"]
[[slm-api-delete-policy]]
=== Delete snapshot lifecycle policy API
++++
<titleabbrev>Delete policy</titleabbrev>
++++

.New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-slm[{slm-cap} APIs].
--

Deletes an existing snapshot lifecycle policy.

[[slm-api-delete-lifecycle-request]]
==== {api-request-title}

`DELETE /_slm/policy/<snapshot-lifecycle-policy-id>`

[[slm-api-delete-lifecycle-prereqs]]
==== {api-prereq-title}

If the {es} {security-features} are enabled, you must have the `manage_slm`
cluster privilege to use this API. For more information, see
<<security-privileges>>.

[[slm-api-delete-lifecycle-desc]]
==== {api-description-title}

Deletes the specified lifecycle policy definition. 
This prevents any future snapshots from being taken
but does not cancel in-progress snapshots
or remove previously-taken snapshots.


[[slm-api-delete-lifecycle-path-params]]
==== {api-path-parms-title}

`<policy-id>`::
(Required, string)
ID of the snapshot lifecycle policy to delete.

[[slm-api-delete-lifecycle-example]]
==== {api-examples-title}

////
[source,console]
--------------------------------------------------
PUT /_slm/policy/daily-snapshots
{
  "schedule": "0 30 1 * * ?", <1>
  "name": "<daily-snap-{now/d}>", <2>
  "repository": "my_repository", <3>
  "config": { <4>
    "indices": ["data-*", "important"], <5>
    "ignore_unavailable": false,
    "include_global_state": false
  },
  "retention": { <6>
    "expire_after": "30d", <7>
    "min_count": 5, <8>
    "max_count": 50 <9>
  }
}
--------------------------------------------------
// TEST[setup:setup-repository]
////

[source,console]
--------------------------------------------------
DELETE /_slm/policy/daily-snapshots
--------------------------------------------------
// TEST[continued]