From 917b40f64911091f2ee9e245f99e2cb8b4205f5e Mon Sep 17 00:00:00 2001
From: Andrew Sayre <6730289+andrewsayre@users.noreply.github.com>
Date: Fri, 28 Mar 2025 11:40:04 -0500
Subject: [PATCH] document remove_from_queue (#38219)

---
 source/_integrations/heos.markdown | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/heos.markdown b/source/_integrations/heos.markdown
index d3f23449c3b..11bd64c45c4 100644
--- a/source/_integrations/heos.markdown
+++ b/source/_integrations/heos.markdown
@@ -87,7 +87,7 @@ In addition to the standard [Media Player actions](/integrations/media_player#ac
 
 Group volume actions: `heos.group_volume_set`, `heos.group_volume_down`, and `heos.group_volume_up` for entities joined to a group.
 
-Queue actions: `heos.get_queue` to manage a player's queue items.
+Queue actions: `heos.get_queue` and `heos.remove_from_queue` to manage a player's queue items.
 
 ### Action `heos.group_volume_set`
 
@@ -129,6 +129,24 @@ media_player.office:
       album_id: "134788273"
 ```
 
+### Action `heos.remove_from_queue`
+
+Removes one or more items from the target player(s) queue. The play queue can be enumerated by using the `heos.get_queue` service. Example action data payload:
+
+```yaml
+action: heos.remove_from_queue
+target:
+  entity_id: media_player.family_room_receiver
+data:
+  queue_ids:
+    - 1
+    - 3
+```
+
+| Data attribute | Optional | Description                                                     |
+| ---------------------- | -------- | ------------------------------------------------------- |
+| `queue_ids`            | no       | The IDs (indexes) of the items in the queue to remove.   |
+
 ## Examples
 
 ### Playing media