v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
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}

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