API Reference
Playlists
Update a playlist

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

ParameterDescription
slugThe playlist slug.

Request body

FieldTypeDescription
namestringNew title.
descriptionstringNew description.
imagefileNew 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

HTTPWhen
400Validation error in the body.
403Caller is not the owner or a can_edit collaborator.
404Playlist not found.