Web API Changelog - February 2026 | Spotify for Developers
https://developer.spotify.com/documentation/web-api/references/changes/february-2026 • 313 KB fetched Open original page
Web API Changelog - February 2026 | Spotify for Developers Skip to content
* Documentation Documentation Products
* Web API
* Web Playback SDK
* Ads API
* iOS
* Android
* Embeds
* Commercial Hardware
* Open Access
* Spotify Soloist
Guidelines
* Design
* Accessibility
* Legal
* Community
0
* Documentation Documentation Products
* Web API
* Web Playback SDK
* Ads API
* iOS
* Android
* Embeds
* Commercial Hardware
* Open Access
* Spotify Soloist
Guidelines
* Design
* Accessibility
* Legal
* Community
Web API
* Overview
* Getting started
* Building with AI
* Concepts Concepts Concepts
* Access Token
* API calls
* Apps
* Authorization
* Redirect URIs
* Playlists
* Quota modes
* Rate limits
* Scopes
* Spotify URIs and IDs
* Track Relinking
* Tutorials Tutorials Tutorials
* Authorization code
* Authorization code PKCE
* Client credentials
* Implicit grant [Deprecated]
* Refreshing tokens
* Migration: Implicit grant to Authorization code
* Migration: Insecure redirect URI
* Migration: February 2026 Dev Mode Changes
* How-Tos How-Tos How-Tos
* Display your Spotify profile data in a web app
* Changelog Changelog Changelog
* July 2026
* May 2026
* March 2026
* February 2026
Reference
* Albums Albums Albums
* Get Album
* Get Several Albums
* Get Album Tracks
* Get User's Saved Albums
* Save Albums for Current User
* Remove Users' Saved Albums
* Check User's Saved Albums
* Get New Releases
* Artists Artists Artists
* Get Artist
* Get Several Artists
* Get Artist's Albums
* Get Artist's Top Tracks
* Get Artist's Related Artists
* Audiobooks Audiobooks Audiobooks
* Get an Audiobook
* Get Several Audiobooks
* Get Audiobook Chapters
* Get User's Saved Audiobooks
* Save Audiobooks for Current User
* Remove User's Saved Audiobooks
* Check User's Saved Audiobooks
* Categories Categories Categories
* Get Several Browse Categories
* Get Single Browse Category
* Chapters Chapters Chapters
* Get a Chapter
* Get Several Chapters
* Episodes Episodes Episodes
* Get Episode
* Get Several Episodes
* Get User's Saved Episodes
* Save Episodes for Current User
* Remove User's Saved Episodes
* Check User's Saved Episodes
* Genres Genres Genres
* Get Available Genre Seeds
* Library Library Library
* Save Items to Library
* Remove Items from Library
* Check User's Saved Items
* Markets Markets Markets
* Get Available Markets
* Player Player Player
* Get Playback State
* Transfer Playback
* Get Available Devices
* Get Currently Playing Track
* Start/Resume Playback
* Pause Playback
* Skip To Next
* Skip To Previous
* Seek To Position
* Set Repeat Mode
* Set Playback Volume
* Toggle Playback Shuffle
* Get Recently Played Tracks
* Get the User's Queue
* Add Item to Playback Queue
* Playlists Playlists Playlists
* Get Playlist
* Change Playlist Details
* Get Playlist Items [DEPRECATED]
* Update Playlist Items [DEPRECATED]
* Add Items to Playlist [DEPRECATED]
* Remove Playlist Items [DEPRECATED]
* Get Playlist Items
* Update Playlist Items
* Add Items to Playlist
* Remove Playlist Items
* Get Current User's Playlists
* Create Playlist
* Get User's Playlists
* Create Playlist for user
* Get Featured Playlists
* Get Category's Playlists
* Get Playlist Cover Image
* Add Custom Playlist Cover Image
* Search Search Search
* Search for Item
* Shows Shows Shows
* Get Show
* Get Several Shows
* Get Show Episodes
* Get User's Saved Shows
* Save Shows for Current User
* Remove User's Saved Shows
* Check User's Saved Shows
* Tracks Tracks Tracks
* Get Track
* Get Several Tracks
* Get User's Saved Tracks
* Save Tracks for Current User
* Remove User's Saved Tracks
* Check User's Saved Tracks
* Get Several Tracks' Audio Features
* Get Track's Audio Features
* Get Track's Audio Analysis
* Get Recommendations
* Users Users Users
* Get Current User's Profile
* Get User's Top Items
* Get User's Profile
* Follow Playlist
* Unfollow Playlist
* Get Followed Artists
* Follow Artists or Users
* Unfollow Artists or Users
* Check If User Follows Artists or Users
* Check if Current User Follows Playlist
Web API
* Overview
* Getting started
* Building with AI
* Concepts Concepts Concepts
* Access Token
* API calls
* Apps
* Authorization
* Redirect URIs
* Playlists
* Quota modes
* Rate limits
* Scopes
* Spotify URIs and IDs
* Track Relinking
* Tutorials Tutorials Tutorials
* Authorization code
* Authorization code PKCE
* Client credentials
* Implicit grant [Deprecated]
* Refreshing tokens
* Migration: Implicit grant to Authorization code
* Migration: Insecure redirect URI
* Migration: February 2026 Dev Mode Changes
* How-Tos How-Tos How-Tos
* Display your Spotify profile data in a web app
* Changelog Changelog Changelog
* July 2026
* May 2026
* March 2026
* February 2026
Reference
* Albums Albums Albums
* Get Album
* Get Several Albums
* Get Album Tracks
* Get User's Saved Albums
* Save Albums for Current User
* Remove Users' Saved Albums
* Check User's Saved Albums
* Get New Releases
* Artists Artists Artists
* Get Artist
* Get Several Artists
* Get Artist's Albums
* Get Artist's Top Tracks
* Get Artist's Related Artists
* Audiobooks Audiobooks Audiobooks
* Get an Audiobook
* Get Several Audiobooks
* Get Audiobook Chapters
* Get User's Saved Audiobooks
* Save Audiobooks for Current User
* Remove User's Saved Audiobooks
* Check User's Saved Audiobooks
* Categories Categories Categories
* Get Several Browse Categories
* Get Single Browse Category
* Chapters Chapters Chapters
* Get a Chapter
* Get Several Chapters
* Episodes Episodes Episodes
* Get Episode
* Get Several Episodes
* Get User's Saved Episodes
* Save Episodes for Current User
* Remove User's Saved Episodes
* Check User's Saved Episodes
* Genres Genres Genres
* Get Available Genre Seeds
* Library Library Library
* Save Items to Library
* Remove Items from Library
* Check User's Saved Items
* Markets Markets Markets
* Get Available Markets
* Player Player Player
* Get Playback State
* Transfer Playback
* Get Available Devices
* Get Currently Playing Track
* Start/Resume Playback
* Pause Playback
* Skip To Next
* Skip To Previous
* Seek To Position
* Set Repeat Mode
* Set Playback Volume
* Toggle Playback Shuffle
* Get Recently Played Tracks
* Get the User's Queue
* Add Item to Playback Queue
* Playlists Playlists Playlists
* Get Playlist
* Change Playlist Details
* Get Playlist Items [DEPRECATED]
* Update Playlist Items [DEPRECATED]
* Add Items to Playlist [DEPRECATED]
* Remove Playlist Items [DEPRECATED]
* Get Playlist Items
* Update Playlist Items
* Add Items to Playlist
* Remove Playlist Items
* Get Current User's Playlists
* Create Playlist
* Get User's Playlists
* Create Playlist for user
* Get Featured Playlists
* Get Category's Playlists
* Get Playlist Cover Image
* Add Custom Playlist Cover Image
* Search Search Search
* Search for Item
* Shows Shows Shows
* Get Show
* Get Several Shows
* Get Show Episodes
* Get User's Saved Shows
* Save Shows for Current User
* Remove User's Saved Shows
* Check User's Saved Shows
* Tracks Tracks Tracks
* Get Track
* Get Several Tracks
* Get User's Saved Tracks
* Save Tracks for Current User
* Remove User's Saved Tracks
* Check User's Saved Tracks
* Get Several Tracks' Audio Features
* Get Track's Audio Features
* Get Track's Audio Analysis
* Get Recommendations
* Users Users Users
* Get Current User's Profile
* Get User's Top Items
* Get User's Profile
* Follow Playlist
* Unfollow Playlist
* Get Followed Artists
* Follow Artists or Users
* Unfollow Artists or Users
* Check If User Follows Artists or Users
* Check if Current User Follows Playlist
Web API Changelog - February 2026
Overview
These changes are related to this blog post. The changes are categorised by endpoints (removed, changed, or added), and then by fields on the different content types (track, playlist, chapter, etc.) Lastly you find a list with all endpoints still available, but field and behavioral changes mentioned earlier still apply.
For step-by-step instructions on how to update your application, see the February 2026 Migration Guide .
Changes to endpoints
The following changes have been made to the endpoints.
* [REMOVED] Create Playlist for user ( POST /users/{user_id}/playlists ) - Create a playlist for a Spotify user.
* Use POST /me/playlists instead
* [REMOVED] Get Artist's Top Tracks ( GET /artists/{id}/top-tracks ) – Get Spotify catalog information about an artist's top tracks by country.
* [REMOVED] Get Available Markets ( GET /markets ) – Get the list of markets where Spotify is available.
* [REMOVED] Get New Releases ( GET /browse/new-releases ) – Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player's "Browse" tab).
* [REMOVED] Get Several Albums ( GET /albums ) – Get Spotify catalog information for multiple albums identified by their Spotify IDs.
* [REMOVED] Get Several Artists ( GET /artists ) – Get Spotify catalog information for several artists based on their Spotify IDs.
* [REMOVED] Get Several Audiobooks ( GET /audiobooks ) – Get Spotify catalog information for several audiobooks identified by their Spotify IDs.
* [REMOVED] Get Several Browse Categories ( GET /browse/categories ) – Get a list of categories used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab).
* [REMOVED] Get Several Chapters ( GET /chapters ) – Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs.
* [REMOVED] Get Several Episodes ( GET /episodes ) – Get Spotify catalog information for several episodes based on their Spotify IDs.
* [REMOVED] Get Several Shows ( GET /shows ) – Get Spotify catalog information for several shows based on their Spotify IDs.
* [REMOVED] Get Several Tracks ( GET /tracks ) – Get Spotify catalog information for multiple tracks based on their Spotify IDs.
* [REMOVED] Get Single Browse Category ( GET /browse/categories/{id} ) – Get a single category used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab).
* [REMOVED] Get User's Playlists ( GET /users/{id}/playlists ) – Get a list of the playlists owned or followed by a Spotify user.
* [REMOVED] Get User's Profile ( GET /users/{id} ) – Get public profile information about a Spotify user.
* [ADDED] Remove from Library ( DELETE /me/library ) – Remove a list of Spotify URIs from the user's library.
* [REMOVED] Remove Albums for Current User ( DELETE /me/albums ) – Removes albums from the user's library.
* Use DELETE /me/library instead
* [REMOVED] Remove Audiobooks for Current User ( DELETE /me/audiobooks ) – Removes audiobooks from the user's library.
* Use DELETE /me/library instead
* [REMOVED] Remove Episodes for Current User ( DELETE /me/episodes ) – Removes episodes from the user's library.
* Use DELETE /me/library instead
* [REMOVED] Remove Shows for Current User ( DELETE /me/shows ) – Removes shows from the user's library.
* Use DELETE /me/library instead
* [REMOVED] Remove Tracks for Current User ( DELETE /me/tracks ) – Removes tracks from the user's library.
* Use DELETE /me/library instead
* [ADDED] Save to Library ( PUT /me/library ) – Save a list of Spotify URIs to the user's library.
* [REMOVED] Save Albums for Current User ( PUT /me/albums ) – Saves one or more albums to the user's library.
* Use PUT /me/library instead
* [REMOVED] Save Audiobooks for Current User ( PUT /me/audiobooks ) – Saves audiobooks to the user's library.
* Use PUT /me/library instead
* [REMOVED] Save Episodes for Current User ( PUT /me/episodes ) – Saves episodes to the user's library.
* Use PUT /me/library instead
* [REMOVED] Save Shows for Current User ( PUT /me/shows ) – Saves shows to the user's library.
* Use PUT /me/library instead
* [REMOVED] Save Tracks for Current User ( PUT /me/tracks ) – Saves tracks to the user's library.
* Use PUT /me/library instead
* [ADDED] Check User's Saved Items ( GET /me/library/contains ) – Check if one or more items are already saved in the current user's library.
* [REMOVED] Check If User Follows Artists or Users ( GET /me/following/contains ) – Check to see if the current user is following one or more artists or other Spotify users.
* Use GET /me/library/contains instead
* [REMOVED] Check if Current User Follows Playlist ( GET /playlists/{id}/followers/contains ) – Checks whether the current user follows a given playlist.
* Use GET /me/library/contains instead
* [REMOVED] Check User's Saved Albums ( GET /me/albums/contains ) – Checks whether one or more album IDs are saved in the current user's library.
* Use GET /me/library/contains instead
* [REMOVED] Check User's Saved Audiobooks ( GET /me/audiobooks/contains ) – Checks whether one or more audiobook IDs are saved in the current user's library.
* Use GET /me/library/contains instead
* [REMOVED] Check User's Saved Episodes ( GET /me/episodes/contains ) – Checks whether one or more episode IDs are saved in the current user's library.
* Use GET /me/library/contains instead
* [REMOVED] Check User's Saved Shows ( GET /me/shows/contains ) – Checks whether one or more show IDs are saved in the current user's library.
* Use GET /me/library/contains instead
* [REMOVED] Check User's Saved Tracks ( GET /me/tracks/contains ) – Checks whether one or more track IDs are saved in the current user's library.
* Use GET /me/library/contains instead
* [REMOVED] Follow Artists or Users ( PUT /me/following ) – Follows one or more artists or users.
* Use PUT /me/library instead
* [REMOVED] Follow Playlist ( PUT /playlists/{id}/followers ) – Follows a playlist on behalf of the current user.
* Use PUT /me/library instead
* [REMOVED] Unfollow Artists or Users ( DELETE /me/following ) – Unfollows one or more artists or users.
* Use DELETE /me/library instead
* [REMOVED] Unfollow Playlist ( DELETE /playlists/{id}/followers ) – Unfollows a playlist on behalf of the current user.
* Use DELETE /me/library instead
* [ADDED] Add Items to Playlist ( POST /playlists/{id}/items ) – Add one or more items to a user's playlist.
* [ADDED] Get Playlist Items ( GET /playlists/{id}/items ) – Get full details of the items of a playlist.
* [ADDED] Remove Playlist Items ( DELETE /playlists/{id}/items ) – Remove one or more items from a user's playlist.
* [ADDED] Update Playlist Items ( PUT /playlists/{id}/items ) – Either reorder or replace items in a playlist.
* [REMOVED] Add Items to Playlist ( POST /playlists/{id}/tracks ) – Adds tracks or episodes to a playlist.
* Use POST /playlists/{id}/items instead
* [REMOVED] Get Playlist Items ( GET /playlists/{id}/tracks ) – Retrieves the tracks or episodes in a playlist.
* Use GET /playlists/{id}/items instead
* [REMOVED] Remove Playlist Items ( DELETE /playlists/{id}/tracks ) – Removes tracks or episodes from a playlist.
* Use DELETE /playlists/{id}/items instead
* [REMOVED] Update Playlist Items ( PUT /playlists/{playlist_id}/tracks ) – Either reorder or replace items in a playlist.
* Use PUT /playlists/{id}/items instead
* [CHANGED] Search for Item ( GET /search ) – The limit parameter maximum value has been reduced from 50 to 10, and the default value has been changed from 20 to 5.
Changes to fields
The following content types and their objects are present in most responses - these changes apply for their occurances in all responses.
Album
* [REMOVED] album_group - Describes the relationship between the artist and the album
* [REMOVED] available_markets – The markets in which the album is available: ISO 3166-1 alpha-2 country codes.
* [REMOVED] external_ids — Known external IDs for the album. Reverted — See March 2026 changelog.
* [REMOVED] label – The label associated with the album.
* [REMOVED] popularity — The popularity of the album. The value will be between 0 and 100, with 100 being the most popular.
Artist
* [REMOVED] followers — Information about the followers of the artist.
* [REMOVED] popularity — The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.
Audiobook
* [REMOVED] available_markets – A list of the countries in which the audiobook can be played, identified by their ISO 3166-1 alpha-2 code.
* [REMOVED] publisher – The publisher of the audiobook.
Chapter
* [REMOVED] available_markets – A list of the countries in which the audiobook can be played, identified by their ISO 3166-1 alpha-2 code.
Playlist
Will only return an items object for the user's playlist, other playlists will only provide metadata (not the contents of the playlist) in the response.
* [RENAMED] tracks -> items
* [RENAMED] tracks.tracks -> items.items
* [RENAMED] tracks.tracks.track -> items.items.item
Show
* [REMOVED] available_markets – A list of the countries in which the show can be played, identified by their ISO 3166-1 alpha-2 code.
* [REMOVED] publisher – The publisher of the show.
Track
* [REMOVED] available_markets – A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.
* [REMOVED] external_ids — Known external IDs for the track. Reverted — See March 2026 changelog.
* [REMOVED] linked_from – Original track when relinked.
* [REMOVED] popularity — The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
User
* [REMOVED] country – The country of the user, as set in the user's account profile. An ISO 3166-1 alpha-2 country code.
* [REMOVED] email – The user's email address, as entered by the user when creating their account.
* [REMOVED] explicit_content – The user's explicit content settings.
* [REMOVED] followers — Information about the followers of the user.
* [REMOVED] product – The user's Spot
Links found on this page
- Skip to content [direct]
- Web API [direct]
- Web Playback SDK [direct]
- Ads API [direct]
- iOS [direct]
- Android [direct]
- Embeds [direct]
- Commercial Hardware [direct]
- Open Access [direct]
- Spotify Soloist [direct]
- Design [direct]
- Accessibility [direct]
- Legal [direct]
- Community [direct]
- Getting started [direct]
- Building with AI [direct]
- Access Token [direct]
- API calls [direct]
- Apps [direct]
- Authorization [direct]
- Redirect URIs [direct]
- Playlists [direct]
- Quota modes [direct]
- Rate limits [direct]
- Scopes [direct]
- Spotify URIs and IDs [direct]
- Track Relinking [direct]
- Authorization code [direct]
- Authorization code PKCE [direct]
- Client credentials [direct]
- Implicit grant [Deprecated] [direct]
- Refreshing tokens [direct]
- Migration: Implicit grant to Authorization code [direct]
- Migration: Insecure redirect URI [direct]
- Migration: February 2026 Dev Mode Changes [direct]
- Display your Spotify profile data in a web app [direct]
- July 2026 [direct]
- May 2026 [direct]
- March 2026 [direct]
- Get Album [direct]
- Get Several Albums [direct]
- Get Album Tracks [direct]
- Get User's Saved Albums [direct]
- Save Albums for Current User [direct]
- Remove Users' Saved Albums [direct]
- Check User's Saved Albums [direct]
- Get New Releases [direct]
- Get Artist [direct]
- Get Several Artists [direct]
- Get Artist's Albums [direct]
- Get Artist's Top Tracks [direct]
- Get Artist's Related Artists [direct]
- Get an Audiobook [direct]
- Get Several Audiobooks [direct]
- Get Audiobook Chapters [direct]
- Get User's Saved Audiobooks [direct]
- Save Audiobooks for Current User [direct]
- Remove User's Saved Audiobooks [direct]
- Check User's Saved Audiobooks [direct]
- Get Several Browse Categories [direct]
- Get Single Browse Category [direct]
- Get a Chapter [direct]
- Get Several Chapters [direct]
- Get Episode [direct]
- Get Several Episodes [direct]
- Get User's Saved Episodes [direct]
- Save Episodes for Current User [direct]
- Remove User's Saved Episodes [direct]
- Check User's Saved Episodes [direct]
- Get Available Genre Seeds [direct]
- Save Items to Library [direct]
- Remove Items from Library [direct]
- Check User's Saved Items [direct]
- Get Available Markets [direct]
- Get Playback State [direct]
- Transfer Playback [direct]
- Get Available Devices [direct]
- Get Currently Playing Track [direct]
- Start/Resume Playback [direct]
- Pause Playback [direct]
|
|