spotted 0.36.0 → 0.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb992999c1594058b701d6e27e3fdfa272d330c4fd88f9e9c1495fedc9c5c79b
-  data.tar.gz: f921d95a39fd7304f6e233f1f838f67abacb0e09e6170d6292535242e08d2a85
+  metadata.gz: 2f71580517da6c6a182d9f537954aa3ac8299cf8400acb7265766116108a4823
+  data.tar.gz: 121e45fd1476cb34045b48336124f955f142e39eb409b90263c2b6a4c0d465f6
 SHA512:
-  metadata.gz: 4b930960139afe00585d7da17cafd052ee957595577c7ba1e55ef6da03b83fd5a4ee8644d44ef067fa42386785333aa0100108107a077084e98f1ca32a3c8573
-  data.tar.gz: 3ff91863119ccbd08cee00d3619362837f5d77c36281bf0d9c0414751ae2e4166e392f2524d1bc09afe7ed86cb361a54a4166bb331ea116d11e81513bf684083
+  metadata.gz: 19ff59f03ba690555122d2afc2ce727518e95f7a0779573c6806c77f8ad96ba1da67d979422143cb488c3199970eb75bd3aa9625d9bfd295603e84e658821162
+  data.tar.gz: 0c835f0ba1120e82a8e272af61c9adcc10f4f2a4d727b85241d2afb3665fc34484636d5f88c2dcebfe19d9391f349a6c1f5a688e18a6657874cbc46de13fc61c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.37.0 (2026-02-12)
+
+Full Changelog: [v0.36.0...v0.37.0](https://github.com/cjavdev/spotted/compare/v0.36.0...v0.37.0)
+
+### Features
+
+* **api:** api update ([6b7d263](https://github.com/cjavdev/spotted/commit/6b7d263f9dcb370ebf6f7c984e4d2f92e6d15e8f))
+
 ## 0.36.0 (2026-02-10)
 
 Full Changelog: [v0.35.0...v0.36.0](https://github.com/cjavdev/spotted/compare/v0.35.0...v0.36.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "spotted", "~> 0.36.0"
+gem "spotted", "~> 0.37.0"
 ```
 
 <!-- x-release-please-end -->
@@ -234,25 +234,23 @@ spotted.albums.retrieve("4aawyAB9vmqN3uQ7FjRGTy", **params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :artist
-puts(Spotted::Me::FollowingCheckParams::Type::ARTIST)
+# :market
+puts(Spotted::AlbumRestrictionObject::Reason::MARKET)
 
-# Revealed type: `T.all(Spotted::Me::FollowingCheckParams::Type, Symbol)`
-T.reveal_type(Spotted::Me::FollowingCheckParams::Type::ARTIST)
+# Revealed type: `T.all(Spotted::AlbumRestrictionObject::Reason, Symbol)`
+T.reveal_type(Spotted::AlbumRestrictionObject::Reason::MARKET)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
 
 ```ruby
-# Using the enum constants preserves the tagged type information:
-spotted.me.following.check(
-  type: Spotted::Me::FollowingCheckParams::Type::ARTIST,
+Spotted::AlbumRestrictionObject.new(
+  reason: Spotted::AlbumRestrictionObject::Reason::MARKET,
   # …
 )
 
-# Literal values are also permissible:
-spotted.me.following.check(
-  type: :artist,
+Spotted::AlbumRestrictionObject.new(
+  reason: :market,
   # …
 )
 ```

data/lib/spotted/models/playlist_retrieve_response.rb

@@ -52,6 +52,13 @@ module Spotted
       #   @return [Array<Spotted::Models::ImageObject>, nil]
       optional :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
 
+      # @!attribute items
+      #   The items of the playlist. _**Note**: This field is only available for playlists
+      #   owned by the current user or playlists the user is a collaborator of._
+      #
+      #   @return [Spotted::Models::PlaylistRetrieveResponse::Items, nil]
+      optional :items, -> { Spotted::Models::PlaylistRetrieveResponse::Items }
+
       # @!attribute name
       #   The name of the playlist.
       #
@@ -82,8 +89,9 @@ module Spotted
       optional :snapshot_id, String
 
       # @!attribute tracks
-      #   The tracks of the playlist. _**Note**: This field is only available for
-      #   playlists owned by the current user._
+      #   @deprecated
+      #
+      #   **Deprecated:** Use `items` instead. The tracks of the playlist.
       #
       #   @return [Spotted::Models::PlaylistRetrieveResponse::Tracks, nil]
       optional :tracks, -> { Spotted::Models::PlaylistRetrieveResponse::Tracks }
@@ -101,7 +109,7 @@ module Spotted
       #   @return [String, nil]
       optional :uri, String
 
-      # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, followers: nil, href: nil, images: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
+      # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, followers: nil, href: nil, images: nil, items: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::PlaylistRetrieveResponse} for more details.
       #
@@ -120,6 +128,9 @@ module Spotted
       #
       #   @param images [Array<Spotted::Models::ImageObject>] Images for the playlist. The array may be empty or contain up to three images. T
       #
+      #   @param items [Spotted::Models::PlaylistRetrieveResponse::Items] The items of the playlist. \_**Note**: This field is only available for
+      #   playlists
+      #
       #   @param name [String] The name of the playlist.
       #
       #   @param owner [Spotted::Models::PlaylistRetrieveResponse::Owner] The user who owns the playlist
@@ -128,13 +139,89 @@ module Spotted
       #
       #   @param snapshot_id [String] The version identifier for the current playlist. Can be supplied in other reques
       #
-      #   @param tracks [Spotted::Models::PlaylistRetrieveResponse::Tracks] The tracks of the playlist. \_**Note**: This field is only available for
-      #   playlist
+      #   @param tracks [Spotted::Models::PlaylistRetrieveResponse::Tracks] **Deprecated:** Use `items` instead. The tracks of the playlist.
       #
       #   @param type [String] The object type: "playlist"
       #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the play
 
+      # @see Spotted::Models::PlaylistRetrieveResponse#items
+      class Items < Spotted::Internal::Type::BaseModel
+        # @!attribute href
+        #   A link to the Web API endpoint returning the full result of the request
+        #
+        #   @return [String]
+        required :href, String
+
+        # @!attribute limit
+        #   The maximum number of items in the response (as set in the query or by default).
+        #
+        #   @return [Integer]
+        required :limit, Integer
+
+        # @!attribute next_
+        #   URL to the next page of items. ( `null` if none)
+        #
+        #   @return [String, nil]
+        required :next_, String, api_name: :next, nil?: true
+
+        # @!attribute offset
+        #   The offset of the items returned (as set in the query or by default)
+        #
+        #   @return [Integer]
+        required :offset, Integer
+
+        # @!attribute previous
+        #   URL to the previous page of items. ( `null` if none)
+        #
+        #   @return [String, nil]
+        required :previous, String, nil?: true
+
+        # @!attribute total
+        #   The total number of items available to return.
+        #
+        #   @return [Integer]
+        required :total, Integer
+
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::PlaylistTrackObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::PlaylistTrackObject] }
+
+        # @!attribute published
+        #   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](/documentation/web-api/concepts/playlists)
+        #
+        #   @return [Boolean, nil]
+        optional :published, Spotted::Internal::Type::Boolean
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil, published: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::PlaylistRetrieveResponse::Items} for more details.
+        #
+        #   The items of the playlist. _**Note**: This field is only available for playlists
+        #   owned by the current user or playlists the user is a collaborator of._
+        #
+        #   @param href [String] A link to the Web API endpoint returning the full result of the request
+        #
+        #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
+        #
+        #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
+        #
+        #   @param offset [Integer] The offset of the items returned (as set in the query or by default)
+        #
+        #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
+        #
+        #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::PlaylistTrackObject>]
+        #
+        #   @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+      end
+
       # @see Spotted::Models::PlaylistRetrieveResponse#owner
       class Owner < Spotted::Models::PlaylistUserObject
         # @!attribute display_name
@@ -152,6 +239,8 @@ module Spotted
         #   @param display_name [String, nil] The name displayed on the user's profile. `null` if not available.
       end
 
+      # @deprecated
+      #
       # @see Spotted::Models::PlaylistRetrieveResponse#tracks
       class Tracks < Spotted::Internal::Type::BaseModel
         # @!attribute href
@@ -209,8 +298,7 @@ module Spotted
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::PlaylistRetrieveResponse::Tracks} for more details.
         #
-        #   The tracks of the playlist. _**Note**: This field is only available for
-        #   playlists owned by the current user._
+        #   **Deprecated:** Use `items` instead. The tracks of the playlist.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #

data/lib/spotted/models/playlist_track_object.rb

@@ -24,6 +24,12 @@ module Spotted
       #   @return [Boolean, nil]
       optional :is_local, Spotted::Internal::Type::Boolean
 
+      # @!attribute item
+      #   Information about the track or episode.
+      #
+      #   @return [Spotted::Models::TrackObject, Spotted::Models::EpisodeObject, nil]
+      optional :item, union: -> { Spotted::PlaylistTrackObject::Item }
+
       # @!attribute published
       #   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
@@ -35,12 +41,14 @@ module Spotted
       optional :published, Spotted::Internal::Type::Boolean
 
       # @!attribute track
-      #   Information about the track or episode.
+      #   @deprecated
+      #
+      #   **Deprecated:** Use `item` instead. Information about the track or episode.
       #
       #   @return [Spotted::Models::TrackObject, Spotted::Models::EpisodeObject, nil]
       optional :track, union: -> { Spotted::PlaylistTrackObject::Track }
 
-      # @!method initialize(added_at: nil, added_by: nil, is_local: nil, published: nil, track: nil)
+      # @!method initialize(added_at: nil, added_by: nil, is_local: nil, item: nil, published: nil, track: nil)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::PlaylistTrackObject} for more details.
       #
@@ -52,12 +60,32 @@ module Spotted
       #
       #   @param is_local [Boolean] Whether this track or episode is a [local file](/documentation/web-api/concepts/
       #
+      #   @param item [Spotted::Models::TrackObject, Spotted::Models::EpisodeObject] Information about the track or episode.
+      #
       #   @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
       #
-      #   @param track [Spotted::Models::TrackObject, Spotted::Models::EpisodeObject] Information about the track or episode.
+      #   @param track [Spotted::Models::TrackObject, Spotted::Models::EpisodeObject] **Deprecated:** Use `item` instead. Information about the track or episode.
 
       # Information about the track or episode.
       #
+      # @see Spotted::Models::PlaylistTrackObject#item
+      module Item
+        extend Spotted::Internal::Type::Union
+
+        discriminator :type
+
+        variant :track, -> { Spotted::TrackObject }
+
+        variant :episode, -> { Spotted::EpisodeObject }
+
+        # @!method self.variants
+        #   @return [Array(Spotted::Models::TrackObject, Spotted::Models::EpisodeObject)]
+      end
+
+      # @deprecated
+      #
+      # **Deprecated:** Use `item` instead. Information about the track or episode.
+      #
       # @see Spotted::Models::PlaylistTrackObject#track
       module Track
         extend Spotted::Internal::Type::Union

data/lib/spotted/models/simplified_playlist_object.rb

@@ -45,6 +45,15 @@ module Spotted
       #   @return [Array<Spotted::Models::ImageObject>, nil]
       optional :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
 
+      # @!attribute items
+      #   A collection containing a link ( `href` ) to the Web API endpoint where full
+      #   details of the playlist's items can be retrieved, along with the `total` number
+      #   of items in the playlist. Note, a track object may be `null`. This can happen if
+      #   a track is no longer available.
+      #
+      #   @return [Spotted::Models::PlaylistTracksRefObject, nil]
+      optional :items, -> { Spotted::PlaylistTracksRefObject }
+
       # @!attribute name
       #   The name of the playlist.
       #
@@ -75,10 +84,12 @@ module Spotted
       optional :snapshot_id, String
 
       # @!attribute tracks
-      #   A collection containing a link ( `href` ) to the Web API endpoint where full
-      #   details of the playlist's tracks can be retrieved, along with the `total` number
-      #   of tracks in the playlist. Note, a track object may be `null`. This can happen
-      #   if a track is no longer available.
+      #   @deprecated
+      #
+      #   **Deprecated:** Use `items` instead. A collection containing a link ( `href` )
+      #   to the Web API endpoint where full details of the playlist's tracks can be
+      #   retrieved, along with the `total` number of tracks in the playlist. Note, a
+      #   track object may be `null`. This can happen if a track is no longer available.
       #
       #   @return [Spotted::Models::PlaylistTracksRefObject, nil]
       optional :tracks, -> { Spotted::PlaylistTracksRefObject }
@@ -96,7 +107,7 @@ module Spotted
       #   @return [String, nil]
       optional :uri, String
 
-      # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, href: nil, images: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
+      # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, href: nil, images: nil, items: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::SimplifiedPlaylistObject} for more details.
       #
@@ -113,6 +124,8 @@ module Spotted
       #
       #   @param images [Array<Spotted::Models::ImageObject>] Images for the playlist. The array may be empty or contain up to three images. T
       #
+      #   @param items [Spotted::Models::PlaylistTracksRefObject] A collection containing a link ( `href` ) to the Web API endpoint where full det
+      #
       #   @param name [String] The name of the playlist.
       #
       #   @param owner [Spotted::Models::SimplifiedPlaylistObject::Owner] The user who owns the playlist
@@ -121,7 +134,7 @@ module Spotted
       #
       #   @param snapshot_id [String] The version identifier for the current playlist. Can be supplied in other reques
       #
-      #   @param tracks [Spotted::Models::PlaylistTracksRefObject] A collection containing a link ( `href` ) to the Web API endpoint where full det
+      #   @param tracks [Spotted::Models::PlaylistTracksRefObject] **Deprecated:** Use `items` instead. A collection containing a link ( `href` ) t
       #
       #   @param type [String] The object type: "playlist"
       #

data/lib/spotted/models/users/playlist_create_response.rb

@@ -53,6 +53,13 @@ module Spotted
         #   @return [Array<Spotted::Models::ImageObject>, nil]
         optional :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
 
+        # @!attribute items
+        #   The items of the playlist. _**Note**: This field is only available for playlists
+        #   owned by the current user or playlists the user is a collaborator of._
+        #
+        #   @return [Spotted::Models::Users::PlaylistCreateResponse::Items, nil]
+        optional :items, -> { Spotted::Models::Users::PlaylistCreateResponse::Items }
+
         # @!attribute name
         #   The name of the playlist.
         #
@@ -83,8 +90,9 @@ module Spotted
         optional :snapshot_id, String
 
         # @!attribute tracks
-        #   The tracks of the playlist. _**Note**: This field is only available for
-        #   playlists owned by the current user._
+        #   @deprecated
+        #
+        #   **Deprecated:** Use `items` instead. The tracks of the playlist.
         #
         #   @return [Spotted::Models::Users::PlaylistCreateResponse::Tracks, nil]
         optional :tracks, -> { Spotted::Models::Users::PlaylistCreateResponse::Tracks }
@@ -102,7 +110,7 @@ module Spotted
         #   @return [String, nil]
         optional :uri, String
 
-        # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, followers: nil, href: nil, images: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
+        # @!method initialize(id: nil, collaborative: nil, description: nil, external_urls: nil, followers: nil, href: nil, images: nil, items: nil, name: nil, owner: nil, published: nil, snapshot_id: nil, tracks: nil, type: nil, uri: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::Users::PlaylistCreateResponse} for more details.
         #
@@ -121,6 +129,9 @@ module Spotted
         #
         #   @param images [Array<Spotted::Models::ImageObject>] Images for the playlist. The array may be empty or contain up to three images. T
         #
+        #   @param items [Spotted::Models::Users::PlaylistCreateResponse::Items] The items of the playlist. \_**Note**: This field is only available for
+        #   playlists
+        #
         #   @param name [String] The name of the playlist.
         #
         #   @param owner [Spotted::Models::Users::PlaylistCreateResponse::Owner] The user who owns the playlist
@@ -129,13 +140,89 @@ module Spotted
         #
         #   @param snapshot_id [String] The version identifier for the current playlist. Can be supplied in other reques
         #
-        #   @param tracks [Spotted::Models::Users::PlaylistCreateResponse::Tracks] The tracks of the playlist. \_**Note**: This field is only available for
-        #   playlist
+        #   @param tracks [Spotted::Models::Users::PlaylistCreateResponse::Tracks] **Deprecated:** Use `items` instead. The tracks of the playlist.
         #
         #   @param type [String] The object type: "playlist"
         #
         #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the play
 
+        # @see Spotted::Models::Users::PlaylistCreateResponse#items
+        class Items < Spotted::Internal::Type::BaseModel
+          # @!attribute href
+          #   A link to the Web API endpoint returning the full result of the request
+          #
+          #   @return [String]
+          required :href, String
+
+          # @!attribute limit
+          #   The maximum number of items in the response (as set in the query or by default).
+          #
+          #   @return [Integer]
+          required :limit, Integer
+
+          # @!attribute next_
+          #   URL to the next page of items. ( `null` if none)
+          #
+          #   @return [String, nil]
+          required :next_, String, api_name: :next, nil?: true
+
+          # @!attribute offset
+          #   The offset of the items returned (as set in the query or by default)
+          #
+          #   @return [Integer]
+          required :offset, Integer
+
+          # @!attribute previous
+          #   URL to the previous page of items. ( `null` if none)
+          #
+          #   @return [String, nil]
+          required :previous, String, nil?: true
+
+          # @!attribute total
+          #   The total number of items available to return.
+          #
+          #   @return [Integer]
+          required :total, Integer
+
+          # @!attribute items
+          #
+          #   @return [Array<Spotted::Models::PlaylistTrackObject>, nil]
+          optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::PlaylistTrackObject] }
+
+          # @!attribute published
+          #   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](/documentation/web-api/concepts/playlists)
+          #
+          #   @return [Boolean, nil]
+          optional :published, Spotted::Internal::Type::Boolean
+
+          # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil, published: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Spotted::Models::Users::PlaylistCreateResponse::Items} for more details.
+          #
+          #   The items of the playlist. _**Note**: This field is only available for playlists
+          #   owned by the current user or playlists the user is a collaborator of._
+          #
+          #   @param href [String] A link to the Web API endpoint returning the full result of the request
+          #
+          #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
+          #
+          #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
+          #
+          #   @param offset [Integer] The offset of the items returned (as set in the query or by default)
+          #
+          #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
+          #
+          #   @param total [Integer] The total number of items available to return.
+          #
+          #   @param items [Array<Spotted::Models::PlaylistTrackObject>]
+          #
+          #   @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        end
+
         # @see Spotted::Models::Users::PlaylistCreateResponse#owner
         class Owner < Spotted::Models::PlaylistUserObject
           # @!attribute display_name
@@ -153,6 +240,8 @@ module Spotted
           #   @param display_name [String, nil] The name displayed on the user's profile. `null` if not available.
         end
 
+        # @deprecated
+        #
         # @see Spotted::Models::Users::PlaylistCreateResponse#tracks
         class Tracks < Spotted::Internal::Type::BaseModel
           # @!attribute href
@@ -210,8 +299,7 @@ module Spotted
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::Users::PlaylistCreateResponse::Tracks} for more details.
           #
-          #   The tracks of the playlist. _**Note**: This field is only available for
-          #   playlists owned by the current user._
+          #   **Deprecated:** Use `items` instead. The tracks of the playlist.
           #
           #   @param href [String] A link to the Web API endpoint returning the full result of the request
           #

data/lib/spotted/resources/me/albums.rb

@@ -35,12 +35,18 @@ module Spotted
           )
         end
 
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::AlbumCheckParams} for more details.
         #
         # Check if one or more albums is already saved in the current Spotify user's 'Your
         # Music' library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Check User's Saved Items](/documentation/web-api/reference/check-library-contains)
+        # instead.
+        #
         # @overload check(ids:, request_options: {})
         #
         # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
@@ -68,6 +74,10 @@ module Spotted
         #
         # Remove one or more albums from the current user's 'Your Music' library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Remove Items from Library](/documentation/web-api/reference/remove-library-items)
+        # instead.
+        #
         # @overload remove(ids: nil, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-i
@@ -91,6 +101,10 @@ module Spotted
         #
         # Save one or more albums to the current user's 'Your Music' library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Save Items to Library](/documentation/web-api/reference/save-library-items)
+        # instead.
+        #
         # @overload save(ids: nil, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-i

data/lib/spotted/resources/me/audiobooks.rb

@@ -33,12 +33,18 @@ module Spotted
           )
         end
 
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::AudiobookCheckParams} for more details.
         #
         # Check if one or more audiobooks are already saved in the current Spotify user's
         # library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Check User's Saved Items](/documentation/web-api/reference/check-library-contains)
+        # instead.
+        #
         # @overload check(ids:, request_options: {})
         #
         # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
@@ -66,6 +72,10 @@ module Spotted
         #
         # Remove one or more audiobooks from the Spotify user's library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Remove Items from Library](/documentation/web-api/reference/remove-library-items)
+        # instead.
+        #
         # @overload remove(ids:, request_options: {})
         #
         # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
@@ -93,6 +103,10 @@ module Spotted
         #
         # Save one or more audiobooks to the current Spotify user's library.
         #
+        # **Note:** This endpoint is deprecated. Use
+        # [Save Items to Library](/documentation/web-api/reference/save-library-items)
+        # instead.
+        #
         # @overload save(ids:, request_options: {})
         #
         # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot

data/lib/spotted/resources/me/episodes.rb

@@ -7,10 +7,7 @@ module Spotted
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::EpisodeListParams} for more details.
         #
-        # Get a list of the episodes saved in the current Spotify user's library.<br/>
-        # This API endpoint is in **beta** and could change without warning. Please share
-        # any feedback that you have, or issues that you discover, in our
-        # [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).
+        # Get a list of the episodes saved in the current Spotify user's library.
         #
         # @overload list(limit: nil, market: nil, offset: nil, request_options: {})
         #
@@ -37,14 +34,17 @@ module Spotted
           )
         end
 
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::EpisodeCheckParams} for more details.
         #
         # Check if one or more episodes is already saved in the current Spotify user's
-        # 'Your Episodes' library.<br/> This API endpoint is in **beta** and could change
-        # without warning. Please share any feedback that you have, or issues that you
-        # discover, in our
-        # [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer)..
+        # 'Your Episodes' library.
+        #
+        # **Note:** This endpoint is deprecated. Use
+        # [Check User's Saved Items](/documentation/web-api/reference/check-library-contains)
+        # instead.
         #
         # @overload check(ids:, request_options: {})
         #
@@ -71,10 +71,11 @@ module Spotted
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::EpisodeRemoveParams} for more details.
         #
-        # Remove one or more episodes from the current user's library.<br/> This API
-        # endpoint is in **beta** and could change without warning. Please share any
-        # feedback that you have, or issues that you discover, in our
-        # [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).
+        # Remove one or more episodes from the current user's library.
+        #
+        # **Note:** This endpoint is deprecated. Use
+        # [Remove Items from Library](/documentation/web-api/reference/remove-library-items)
+        # instead.
         #
         # @overload remove(ids: nil, published: nil, request_options: {})
         #
@@ -103,10 +104,11 @@ module Spotted
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Me::EpisodeSaveParams} for more details.
         #
-        # Save one or more episodes to the current user's library.<br/> This API endpoint
-        # is in **beta** and could change without warning. Please share any feedback that
-        # you have, or issues that you discover, in our
-        # [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).
+        # Save one or more episodes to the current user's library.
+        #
+        # **Note:** This endpoint is deprecated. Use
+        # [Save Items to Library](/documentation/web-api/reference/save-library-items)
+        # instead.
         #
         # @overload save(ids:, published: nil, request_options: {})
         #