reorder_playlist_items
Move a range of items to a new position in a Spotify playlist. Use dry_run to preview changes or specify range_start, range_length, and insert_before.
Instructions
Move a range of items within a playlist. Spotify semantics: when insert_before > range_start, the effective destination shifts down by range_length because the moved range is lifted out first (e.g. moving [2] to insert_before=4 lands it AT index 3).
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": {
"playlist_id": "<playlist_id>",
"range_start": "<range_start>",
"insert_before": "<insert_before>"
},
"name": "reorder_playlist_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Preview only: validate inputs and describe exactly what would change without performing it | |
| playlist_id | Yes | Playlist ID | |
| range_start | Yes | Index of the first item to move. 0-based index into the playlist's current item order (0 = the first item). | |
| range_length | No | Number of items to move. Default: 1 | |
| insert_before | Yes | Index to insert the range before. 0-based index into the playlist's current item order (0 = the first item). |