Spotify Web API
  1. category-playlists
Spotify Web API
  • category-albums
    • Get Multiple Albums
      GET
    • Get an Album
      GET
    • Get an Album's Tracks
      GET
  • category-artists
    • Get Multiple Artists
      GET
    • Get an Artist
      GET
    • Get an Artist's Albums
      GET
    • Get an Artist's Related Artists
      GET
    • Get an Artist's Top Tracks
      GET
  • category-tracks
    • Get Audio Analysis for a Track
      GET
    • Get Audio Features for Several Tracks
      GET
    • Get Audio Features for a Track
      GET
    • Get Several Tracks
      GET
    • Get a Track
      GET
  • category-browse
    • Get All Categories
      GET
    • Get a Category
      GET
    • Get a Category's Playlists
      GET
    • Get All Featured Playlists
      GET
    • Get All New Releases
      GET
    • Get Recommendations
      GET
    • Get Recommendation Genres
      GET
  • category-episodes
    • Get Multiple Episodes
    • Get an Episode
  • category-markets
    • Get Available Markets
  • category-users-profile
    • Get Current User's Profile
    • Get a User's Profile
  • category-library
    • Remove Albums for Current User
    • Get User's Saved Albums
    • Save Albums for Current User
    • Check User's Saved Albums
    • Remove User's Saved Episodes
    • Get User's Saved Episodes
    • Save Episodes for User
    • Check User's Saved Episodes
    • Remove User's Saved Shows
    • Get User's Saved Shows
    • Save Shows for Current User
    • Check User's Saved Shows
    • Remove User's Saved Tracks
    • Get User's Saved Tracks
    • Save Tracks for User
    • Check User's Saved Tracks
  • category-follow
    • Unfollow Artists or Users
    • Get User's Followed Artists
    • Follow Artists or Users
    • Get Following State for Artists/Users
    • Unfollow Playlist
    • Follow a Playlist
    • Check if Users Follow a Playlist
  • category-player
    • Get Information About The User's Current Playback
    • Transfer a User's Playback
    • Get the User's Currently Playing Track
    • Get a User's Available Devices
    • Skip User’s Playback To Next Track
    • Pause a User's Playback
    • Start/Resume a User's Playback
    • Skip User’s Playback To Previous Track
    • Add an item to queue
    • Get Current User's Recently Played Tracks
    • Set Repeat Mode On User’s Playback
    • Seek To Position In Currently Playing Track
    • Toggle Shuffle For User’s Playback
    • Set Volume For User's Playback
  • category-playlists
    • Get a List of Current User's Playlists
      GET
    • Get a Playlist
      GET
    • Change a Playlist's Details
      PUT
    • Get a Playlist Cover Image
      GET
    • Upload a Custom Playlist Cover Image
      PUT
    • Remove Items from a Playlist
      DELETE
    • Get a Playlist's Items
      GET
    • Add Items to a Playlist
      POST
    • Reorder or Replace a Playlist's Items
      PUT
    • Get a List of a User's Playlists
      GET
    • Create a Playlist
      POST
  • category-personalization
    • Get a User's Top Artists and Tracks
  • category-search
    • Search for an Item
  • category-shows
    • Get Multiple Shows
    • Get a Show
    • Get a Show's Episodes
  1. category-playlists

Change a Playlist's Details

PUT
/playlists/{playlist_id}
category-playlists
Change a playlist's name and public/private state. (The user must, of
course, own the playlist.)
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.spotify.com/playlists/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "collaborative": true,
    "description": "string",
    "name": "string",
    "public": true
}'
响应示例响应示例
200 - 示例 1
{}

请求参数

Path 参数
playlist_id
必需
The Spotify ID for the playlist.
Header 参数
Authorization
必需
A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the user.
Changing a public playlist for a user requires authorization of the playlist-modify-public scope; changing a private playlist requires the playlist-modify-private scope. See Using Scopes.
Content-Type
必需
The content type of the request body: application/json
Body 参数application/json
collaborative
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
string 
可选
Value for playlist description as displayed in Spotify Clients and in the Web API.
name
string 
可选
The new name for the playlist, for example "My New Playlist Title"
public
boolean 
可选
If true the playlist will be public, if false it will be private.
示例

返回响应

🟢200On success the HTTP status code in the response header is `200` OK. On error, the header status code is an [error code](https://developer.spotify.com/documentation/web-api/#response-status-codes) and the response body contains an [error object](https://d
application/json
Body
object {0}
🔴500500
上一页
Get a Playlist
下一页
Get a Playlist Cover Image
Built with