Update a playlist
Edit a playlist's metadata: name, description, or cover image. Owners and collaborators with can_edit permission can update.
PATCH/api/v4/me/playlists/{slug}/
PUT is also accepted, but PATCH is the right verb for partial updates and is what we recommend.
Path parameters
| Parameter | Description |
|---|---|
slug | The playlist slug. |
Request body
| Field | Type | Description |
|---|---|---|
name | string | New title. |
description | string | New description. |
image | file | New cover image. Send as multipart/form-data when present. |
All fields are optional. Send only what's changing.
Example request — JSON
curl https://api.slipstreammusic.com/api/v4/me/playlists/late-night/ \
-X PATCH \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "description": "Late-night jazz, all under 120 BPM" }'Example request — with image upload
curl https://api.slipstreammusic.com/api/v4/me/playlists/late-night/ \
-X PATCH \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-F "name=Late Night Sessions" \
-F "image=@/path/to/cover.jpg"Example response
Returns the full Playlist object after the change applies. See The Playlist object.
Errors
| HTTP | When |
|---|---|
| 400 | Validation error in the body. |
| 403 | Caller is not the owner or a can_edit collaborator. |
| 404 | Playlist not found. |