feat: Mark removed fields as obsolte (#1037)

see: https://developer.spotify.com/documentation/web-api/references/changes/february-2026

Author: JohnnyCrazy

SpotifyAPI.Web/Clients/AlbumsClient.cs

@@ -24,6 +24,7 @@ public Task<FullAlbum> Get(string albumId, AlbumRequest request, CancellationTok
       return API.Get<FullAlbum>(URLs.Album(albumId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /albums) has been removed.")]
     public Task<AlbumsResponse> GetSeveral(AlbumsRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));

SpotifyAPI.Web/Clients/ArtistsClient.cs

@@ -54,13 +54,15 @@ public Task<ArtistsRelatedArtistsResponse> GetRelatedArtists(string artistId, Ar
       return API.Get<ArtistsRelatedArtistsResponse>(URLs.ArtistRelatedArtists(artistId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /artists) has been removed.")]
     public Task<ArtistsResponse> GetSeveral(ArtistsRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));
 
       return API.Get<ArtistsResponse>(URLs.Artists(), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /artists/{id}/top-tracks) has been removed.")]
     public Task<ArtistsTopTracksResponse> GetTopTracks(string artistId, ArtistsTopTracksRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(artistId, nameof(artistId));

SpotifyAPI.Web/Clients/AudiobooksClient.cs

@@ -24,6 +24,7 @@ public Task<FullAudiobook> Get(string audiobookId, AudiobookRequest request, Can
       return API.Get<FullAudiobook>(URLs.Audiobook(audiobookId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /audiobooks) has been removed.")]
     public Task<AudiobooksResponse> GetSeveral(AudiobooksRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));

SpotifyAPI.Web/Clients/BrowseClient.cs

@@ -9,25 +9,29 @@ public class BrowseClient : APIClient, IBrowseClient
   {
     public BrowseClient(IAPIConnector apiConnector) : base(apiConnector) { }
 
+    [System.Obsolete("This endpoint (GET /browse/categories) has been removed.")]
     public Task<CategoriesResponse> GetCategories(CancellationToken cancel = default)
     {
       return API.Get<CategoriesResponse>(URLs.Categories(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /browse/categories) has been removed.")]
     public Task<CategoriesResponse> GetCategories(CategoriesRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));
 
       return API.Get<CategoriesResponse>(URLs.Categories(), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /browse/categories/{id}) has been removed.")]
     public Task<Category> GetCategory(string categoryId, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(categoryId, nameof(categoryId));
 
       return API.Get<Category>(URLs.Category(categoryId), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /browse/categories/{id}) has been removed.")]
     public Task<Category> GetCategory(string categoryId, CategoryRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(categoryId, nameof(categoryId));
@@ -63,11 +67,13 @@ public Task<RecommendationGenresResponse> GetRecommendationGenres(CancellationTo
       return API.Get<RecommendationGenresResponse>(URLs.RecommendationGenres(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /browse/new-releases) has been removed.")]
     public Task<NewReleasesResponse> GetNewReleases(CancellationToken cancel = default)
     {
       return API.Get<NewReleasesResponse>(URLs.NewReleases(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /browse/new-releases) has been removed.")]
     public Task<NewReleasesResponse> GetNewReleases(NewReleasesRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));

SpotifyAPI.Web/Clients/ChaptersClient.cs

@@ -24,6 +24,7 @@ public Task<FullAudiobookChapter> Get(string chapterId, ChapterRequest request,
       return API.Get<FullAudiobookChapter>(URLs.Chapter(chapterId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /chapters) has been removed.")]
     public Task<ChaptersResponse> GetSeveral(ChaptersRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));

SpotifyAPI.Web/Clients/EpisodesClient.cs

@@ -24,6 +24,7 @@ public Task<FullEpisode> Get(string episodeId, EpisodeRequest request, Cancellat
       return API.Get<FullEpisode>(URLs.Episode(episodeId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /episodes) has been removed.")]
     public Task<EpisodesResponse> GetSeveral(EpisodesRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));

SpotifyAPI.Web/Clients/FollowClient.cs

@@ -10,13 +10,15 @@ public class FollowClient : APIClient, IFollowClient
   {
     public FollowClient(IAPIConnector apiConnector) : base(apiConnector) { }
 
+    [System.Obsolete("This endpoint (GET /me/following/contains) has been removed. Use GET /me/library/contains instead.")]
     public Task<List<bool>> CheckCurrentUser(FollowCheckCurrentUserRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));
 
       return API.Get<List<bool>>(URLs.CurrentUserFollowerContains(), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (GET /playlists/{id}/followers/contains) has been removed. Use GET /me/library/contains instead.")]
     public Task<List<bool>> CheckPlaylist(string playlistId, FollowCheckPlaylistRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));
@@ -25,6 +27,7 @@ public Task<List<bool>> CheckPlaylist(string playlistId, FollowCheckPlaylistRequ
       return API.Get<List<bool>>(URLs.PlaylistFollowersContains(playlistId), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (PUT /me/following) has been removed. Use PUT /me/library instead.")]
     public async Task<bool> Follow(FollowRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));
@@ -35,6 +38,7 @@ public async Task<bool> Follow(FollowRequest request, CancellationToken cancel =
       return HTTPUtil.StatusCodeIsSuccess(statusCode);
     }
 
+    [System.Obsolete("This endpoint (PUT /playlists/{id}/followers) has been removed. Use PUT /me/library instead.")]
     public async Task<bool> FollowPlaylist(string playlistId, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));
@@ -45,6 +49,7 @@ public async Task<bool> FollowPlaylist(string playlistId, CancellationToken canc
       return HTTPUtil.StatusCodeIsSuccess(statusCode);
     }
 
+    [System.Obsolete("This endpoint (PUT /playlists/{id}/followers) has been removed. Use PUT /me/library instead.")]
     public async Task<bool> FollowPlaylist(string playlistId, FollowPlaylistRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));
@@ -70,6 +75,7 @@ public Task<FollowedArtistsResponse> OfCurrentUser(FollowOfCurrentUserRequest re
       return API.Get<FollowedArtistsResponse>(URLs.CurrentUserFollower(), request.BuildQueryParams(), cancel);
     }
 
+    [System.Obsolete("This endpoint (DELETE /me/following) has been removed. Use DELETE /me/library instead.")]
     public async Task<bool> Unfollow(UnfollowRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNull(request, nameof(request));
@@ -80,6 +86,7 @@ public async Task<bool> Unfollow(UnfollowRequest request, CancellationToken canc
       return HTTPUtil.StatusCodeIsSuccess(statusCode);
     }
 
+    [System.Obsolete("This endpoint (DELETE /playlists/{id}/followers) has been removed. Use DELETE /me/library instead.")]
     public async Task<bool> UnfollowPlaylist(string playlistId, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));

SpotifyAPI.Web/Clients/Interfaces/IAlbumsClient.cs

@@ -17,6 +17,7 @@ public interface IAlbumsClient
     /// https://developer.spotify.com/documentation/web-api/reference-beta/#endpoint-get-multiple-albums
     /// </remarks>
     /// <returns></returns>
+    [System.Obsolete("This endpoint (GET /albums) has been removed.")]
     Task<AlbumsResponse> GetSeveral(AlbumsRequest request, CancellationToken cancel = default);
 
     /// <summary>

SpotifyAPI.Web/Clients/Interfaces/IArtistsClient.cs

@@ -17,6 +17,7 @@ public interface IArtistsClient
     /// <param name="request">The request-model which contains required and optional parameters</param>
     /// <param name="cancel">The cancellation-token to allow to cancel the request.</param>
     /// <returns></returns>
+    [System.Obsolete("This endpoint (GET /artists) has been removed.")]
     Task<ArtistsResponse> GetSeveral(ArtistsRequest request, CancellationToken cancel = default);
 
     /// <summary>
@@ -80,6 +81,7 @@ public interface IArtistsClient
     /// https://developer.spotify.com/documentation/web-api/reference-beta/#endpoint-get-an-artists-top-tracks
     /// </remarks>
     /// <returns></returns>
+    [System.Obsolete("This endpoint (GET /artists/{id}/top-tracks) has been removed.")]
     Task<ArtistsTopTracksResponse> GetTopTracks(string artistId, ArtistsTopTracksRequest request, CancellationToken cancel = default);
 
 

SpotifyAPI.Web/Clients/Interfaces/IAudiobooksClient.cs

@@ -42,6 +42,7 @@ public interface IAudiobooksClient
     /// https://developer.spotify.com/documentation/web-api/reference/get-multiple-audiobooks
     /// </remarks>
     /// <returns></returns>
+    [System.Obsolete("This endpoint (GET /audiobooks) has been removed.")]
     Task<AudiobooksResponse> GetSeveral(AudiobooksRequest request, CancellationToken cancel = default);
 
     /// <summary>