{ "opencollection": "1.0.0", "info": { "name": "Spotify Web Albums Playlists API", "version": "1.0.0" }, "items": [ { "info": { "name": "Playlists", "type": "folder" }, "items": [ { "info": { "name": "Get Playlist\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/playlists/:playlist_id", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "market", "value": "", "type": "query" }, { "name": "fields", "value": "", "type": "query" }, { "name": "additional_types", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a playlist owned by a Spotify user.\n" }, { "info": { "name": "Change Playlist Details\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Change a playlist's name and public/private state. (The user must, of\ncourse, own the playlist.)\n" }, { "info": { "name": "Get Playlist Items [DEPRECATED]\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/playlists/:playlist_id/tracks", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "market", "value": "", "type": "query" }, { "name": "fields", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" }, { "name": "additional_types", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated:** Use [Get Playlist Items](/documentation/web-api/reference/get-playlists-items) instead.\n\nGet full details of the items of a playlist owned by a Spotify user.\n" }, { "info": { "name": "Add Items to Playlist [DEPRECATED]\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/playlists/:playlist_id/tracks", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "position", "value": "", "type": "query" }, { "name": "uris", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated:** Use [Add Items to Playlist](/documentation/web-api/reference/add-items-to-playlist) instead.\n\nAdd one or more items to a user's playlist.\n" }, { "info": { "name": "Update Playlist Items [DEPRECATED]\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id/tracks", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "uris", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated:** Use [Update Playlist Items](/documentation/web-api/reference/reorder-or-replace-playlists-items) instead.\n\nEither reorder or replace items in a playlist depending on the request's parameters.\nTo reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body.\nTo replace items, include `uris` as either a query parameter or in the request's body.\nReplacing items in a playlist will overwrite its existing items. This operation can be used" }, { "info": { "name": "Remove Playlist Items [DEPRECATED]\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/playlists/:playlist_id/tracks", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated:** Use [Remove Playlist Items](/documentation/web-api/reference/remove-items-playlist) instead.\n\nRemove one or more items from a user's playlist.\n" }, { "info": { "name": "Get Playlist Items\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/playlists/:playlist_id/items", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "market", "value": "", "type": "query" }, { "name": "fields", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" }, { "name": "additional_types", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get full details of the items of a playlist owned by a Spotify user.\n\n**Note**: This endpoint is only accessible for playlists owned by the current user or playlists the user is a collaborator of. A `403 Forbidden` status code will be returned if the user is neither the owner nor a collaborator of the playlist.\n" }, { "info": { "name": "Add Items to Playlist\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/playlists/:playlist_id/items", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "position", "value": "", "type": "query" }, { "name": "uris", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Add one or more items to a user's playlist.\n" }, { "info": { "name": "Update Playlist Items\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id/items", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "uris", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Either reorder or replace items in a playlist depending on the request's parameters.\nTo reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body.\nTo replace items, include `uris` as either a query parameter or in the request's body.\nReplacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist.\n
\n**Note**: Replace and reorder are mutually exclusive operations which" }, { "info": { "name": "Remove Playlist Items\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/playlists/:playlist_id/items", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more items from a user's playlist.\n" }, { "info": { "name": "Get Current User's Playlists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/playlists", "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the playlists owned or followed by the current Spotify\nuser.\n" }, { "info": { "name": "Create Playlist\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/me/playlists", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Create a playlist for the current Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n" }, { "info": { "name": "Get User's Playlists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/users/:user_id/playlists", "params": [ { "name": "user_id", "value": "", "type": "path" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the playlists owned or followed by a Spotify user.\n" }, { "info": { "name": "Create Playlist for user\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/users/:user_id/playlists", "params": [ { "name": "user_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated**: Use [Create Playlist](/documentation/web-api/reference/create-playlist) instead.\n\nCreate a playlist for a Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n" }, { "info": { "name": "Follow Playlist\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id/followers", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Add the current user as a follower of a playlist.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Unfollow Playlist\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/playlists/:playlist_id/followers", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove the current user as a follower of a playlist.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Get Featured Playlists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/browse/featured-playlists", "params": [ { "name": "locale", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).\n" }, { "info": { "name": "Get Category's Playlists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/browse/categories/:category_id/playlists", "params": [ { "name": "category_id", "value": "", "type": "path" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of Spotify playlists tagged with a particular category.\n" }, { "info": { "name": "Get Playlist Cover Image\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/playlists/:playlist_id/images", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get the current image associated with a specific playlist.\n" }, { "info": { "name": "Add Custom Playlist Cover Image\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id/images", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Replace the image used to represent a specific playlist.\n" }, { "info": { "name": "Check if Current User Follows Playlist\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/playlists/:playlist_id/followers/contains", "params": [ { "name": "playlist_id", "value": "", "type": "path" }, { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check to see if the current user is following a specified playlist.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" } ] } ], "bundled": true }