diff --git a/docs/reference/ilm/apis/remove-policy-from-index.asciidoc b/docs/reference/ilm/apis/remove-policy-from-index.asciidoc
index 9bce82cf4a2..15d0438416f 100644
--- a/docs/reference/ilm/apis/remove-policy-from-index.asciidoc
+++ b/docs/reference/ilm/apis/remove-policy-from-index.asciidoc
@@ -6,12 +6,13 @@
Remove policy
++++
-Removes the assigned lifecycle policy from an index.
+Removes assigned lifecycle policies from an index or a data stream's backing
+indices.
[[ilm-remove-policy-request]]
==== {api-request-title}
-`POST /_ilm/remove`
+`POST /_ilm/remove`
[[ilm-remove-policy-prereqs]]
==== {api-prereq-title}
@@ -23,15 +24,21 @@ see <>.
[[ilm-remove-policy-desc]]
==== {api-description-title}
-Removes the assigned lifecycle policy and stops managing the specified index.
-If an index pattern is specified, removes the assigned policies from all matching
-indices.
+For indices, the remove lifecycle policy API removes the assigned lifecycle
+policy and stops managing the specified index.
+
+For data streams, the API removes any assigned lifecycle policies from
+the stream's backing indices and stops managing the indices.
[[ilm-remove-policy-path-params]]
==== {api-path-parms-title}
-``::
- (Required, string) Identifier for the index.
+``::
+(Required, string)
+Comma-separated list of data streams, indices, and index aliases to target.
+Wildcard expressions (`*`) are supported.
++
+To target all data streams and indices in a cluster, use `_all` or `*`.
[[ilm-remove-policy-query-params]]
==== {api-query-parms-title}