Playlists
Library

Change Playlist Details

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

put/playlists/{playlist_id}

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/playlists/{playlist_id}
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token scopes: playlist-modify-public, playlist-modify-private

Path parameters

playlist_idstring required

The Spotify ID of the playlist.

Example:3cEYpjA9oz9GiPac4AsH4n

Request body

namestring

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

publicboolean

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

collaborativeboolean

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

descriptionstring

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

Example request

{
  "name": "Updated Playlist Name",
  "description": "Updated playlist description",
  "public": false
}

Response

Playlist updated

Changes

No recorded changes to this operation across all 7 revisions of this API.