Reorder items
Move one or more items in a playlist by a relative offset. Owners and can_edit collaborators can call this.
POST/api/v4/me/playlists/{slug}/tracks/reorder/
Path parameters
| Parameter | Description |
|---|---|
slug | The playlist slug. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
items | array of objects | Yes | Items to move. Each object: { "id": <uuid>, "type": "track" | "soundfx" | "stem" }. Up to 500 items per call. |
offset | integer | Yes | Positions to move. Positive moves down, negative moves up. |
Example request — move two tracks down by 3 positions
curl https://api.slipstreammusic.com/api/v4/me/playlists/late-night/tracks/reorder/ \
-X POST \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b", "type": "track" },
{ "id": "1f3c4d5e-6a7b-8c9d-0e1f-2a3b4c5d6e7f", "type": "track" }
],
"offset": 3
}'Example response
{
"success": true,
"total_items": 12
}| Field | Description |
|---|---|
total_items | Total items in the playlist after the reorder. |
Errors
| HTTP | When |
|---|---|
| 400 | Empty items list, more than 500 items, or an item that isn't in the playlist. The body has error describing what went wrong. |
| 403 | Caller is not the owner or a can_edit collaborator. |
| 404 | Playlist not found. |