Skip to content
Spotted Docs Spotted Docs
DocumentationAPI Reference
API Reference
Playlists

Change Playlist Details

PUT/playlists/{playlist_id}

Change a playlist's name and public/private state. (The user must, of course, own the playlist.)

Path ParametersExpand Collapse
playlist_id: string

The Spotify ID of the playlist.

Body ParametersExpand Collapse
collaborative: optional boolean

If true, the playlist will become collaborative and other users will be able to modify the playlist in their Spotify client.
Note: You can only set collaborative to true on non-public playlists.

description: optional string

Value for playlist description as displayed in Spotify Clients and in the Web API.

name: optional string

The new name for the playlist, for example "My New Playlist Title"

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Change Playlist Details 

curl https://api.spotify.com/v1/playlists/$PLAYLIST_ID \
    -X PUT \
    -H "Authorization: Bearer $SPOTIFY_ACCESS_TOKEN"
Returns Examples