Astra: edit the play queue
astra_queue_editManage the Astra play queue by moving a specific track to a new position, removing an unwanted item, or clearing the entire upcoming queue.
Instructions
Reorder or trim the Astra play queue. "move" needs queueItemId and a 0-based position, "remove" needs queueItemId, and "clear" empties the upcoming queue without stopping the current track. Get queue item ids from astra_queue. The currently playing item cannot be moved or removed — attempting it returns queue_item_not_found. To add tracks instead, use astra_enqueue.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "astra_queue_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | What to do: move an item, remove an item, or clear everything upcoming. | |
| position | No | Required for "move": the 0-based index to move the item to. | |
| queueItemId | No | Required for "move" and "remove": the id field from astra_queue. |