spotted 0.34.4 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f904b10b2ba3e4c4d22860536c557c2a8fb4bf7c64c3b311b223158fd2bb7584
-  data.tar.gz: fc39c1221964d0e2a08cc5ac32d98e03301969c873f49301f2898815dd071e21
+  metadata.gz: d47443c57665ca926ffddc645653051d2b756ae342073c3d56df256d4b2b3276
+  data.tar.gz: ded4b12f434d7185619e30bb06530e5815ae768c5487164002ac5ba6ad7daabd
 SHA512:
-  metadata.gz: bc717af600324a985f0a2967bb0ec6d3213108e3443d4cb42968014b8372d2afe952abf8e6f665c7a084180c4819d4dd156845e63383e34b1126c89771fee7c1
-  data.tar.gz: 8778b3df7f7435c0da8522f2c2b6e01b84e2cd58e803f0fb1f06a07c3d08e85ad5b6f35d9ba9f1f4fb4694f2a7392bbc93b8aed71f498b4c264f720edc5379f9
+  metadata.gz: 55a0711a4260f28f89cd9884179f4b599081b2e5e127c8eff2d9d0ab9f7267beea20bf6340044b7cf74c46e36be609dd143ad91bd3ddc61034ba9a6f4c40eaa3
+  data.tar.gz: 3aa2a15df4d83a1628e311d044ec812f0cc588c7fb24917f73aee0361bfce10b475c4c0dbb16f9e02866021ce8910f2ac5cc9381ae20692716a0edbca6ddb628

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.35.0 (2026-02-08)
+
+Full Changelog: [v0.34.4...v0.35.0](https://github.com/cjavdev/spotted/compare/v0.34.4...v0.35.0)
+
+### Features
+
+* **api:** api update ([6211f61](https://github.com/cjavdev/spotted/commit/6211f615162079ee7635ca93c9bbe8e510319448))
+
 ## 0.34.4 (2026-02-07)
 
 Full Changelog: [v0.34.3...v0.34.4](https://github.com/cjavdev/spotted/compare/v0.34.3...v0.34.4)

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.34.4"
+gem "spotted", "~> 0.35.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/spotted/models/album_bulk_retrieve_response.rb

@@ -28,6 +28,8 @@ module Spotted
         required :album_type, enum: -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType }
 
         # @!attribute available_markets
+        #   @deprecated
+        #
         #   The markets in which the album is available:
         #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
         #   _**NOTE**: an album is considered available in a market when at least 1 of its
@@ -107,6 +109,8 @@ module Spotted
         optional :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
 
         # @!attribute external_ids
+        #   @deprecated
+        #
         #   Known external IDs for the album.
         #
         #   @return [Spotted::Models::ExternalIDObject, nil]
@@ -121,12 +125,16 @@ module Spotted
         optional :genres, Spotted::Internal::Type::ArrayOf[String]
 
         # @!attribute label
+        #   @deprecated
+        #
         #   The label associated with the album.
         #
         #   @return [String, nil]
         optional :label, String
 
         # @!attribute popularity
+        #   @deprecated
+        #
         #   The popularity of the album. The value will be between 0 and 100, with 100 being
         #   the most popular.
         #

data/lib/spotted/models/album_retrieve_response.rb

@@ -18,6 +18,8 @@ module Spotted
       required :album_type, enum: -> { Spotted::Models::AlbumRetrieveResponse::AlbumType }
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   The markets in which the album is available:
       #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
       #   _**NOTE**: an album is considered available in a market when at least 1 of its
@@ -97,6 +99,8 @@ module Spotted
       optional :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
 
       # @!attribute external_ids
+      #   @deprecated
+      #
       #   Known external IDs for the album.
       #
       #   @return [Spotted::Models::ExternalIDObject, nil]
@@ -111,12 +115,16 @@ module Spotted
       optional :genres, Spotted::Internal::Type::ArrayOf[String]
 
       # @!attribute label
+      #   @deprecated
+      #
       #   The label associated with the album.
       #
       #   @return [String, nil]
       optional :label, String
 
       # @!attribute popularity
+      #   @deprecated
+      #
       #   The popularity of the album. The value will be between 0 and 100, with 100 being
       #   the most popular.
       #

data/lib/spotted/models/artist_list_albums_params.rb

@@ -17,7 +17,7 @@ module Spotted
       optional :include_groups, String
 
       # @!attribute limit
-      #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      #   The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
@@ -49,7 +49,7 @@ module Spotted
       #
       #   @param include_groups [String] A comma-separated list of keywords that will be used to filter the response. If
       #
-      #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      #   @param limit [Integer] The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
       #
       #   @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
       #

data/lib/spotted/models/artist_list_albums_response.rb

@@ -31,6 +31,8 @@ module Spotted
       required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   The markets in which the album is available:
       #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
       #   _**NOTE**: an album is considered available in a market when at least 1 of its

data/lib/spotted/models/artist_object.rb

@@ -17,12 +17,16 @@ module Spotted
       optional :external_urls, -> { Spotted::ExternalURLObject }
 
       # @!attribute followers
+      #   @deprecated
+      #
       #   Information about the followers of the artist.
       #
       #   @return [Spotted::Models::FollowersObject, nil]
       optional :followers, -> { Spotted::FollowersObject }
 
       # @!attribute genres
+      #   @deprecated
+      #
       #   A list of the genres the artist is associated with. If not yet classified, the
       #   array is empty.
       #
@@ -48,6 +52,8 @@ module Spotted
       optional :name, String
 
       # @!attribute popularity
+      #   @deprecated
+      #
       #   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.

data/lib/spotted/models/audiobook_base.rb

@@ -17,6 +17,8 @@ module Spotted
       required :authors, -> { Spotted::Internal::Type::ArrayOf[Spotted::AuthorObject] }
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the audiobook can be played, identified by
       #   their [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
       #   code.
@@ -94,6 +96,8 @@ module Spotted
       required :narrators, -> { Spotted::Internal::Type::ArrayOf[Spotted::NarratorObject] }
 
       # @!attribute publisher
+      #   @deprecated
+      #
       #   The publisher of the audiobook.
       #
       #   @return [String]

data/lib/spotted/models/browse_get_new_releases_response.rb

@@ -108,6 +108,8 @@ module Spotted
           required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
           # @!attribute available_markets
+          #   @deprecated
+          #
           #   The markets in which the album is available:
           #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
           #   _**NOTE**: an album is considered available in a market when at least 1 of its

data/lib/spotted/models/chapter_bulk_retrieve_response.rb

@@ -133,6 +133,8 @@ module Spotted
         required :uri, String
 
         # @!attribute available_markets
+        #   @deprecated
+        #
         #   A list of the countries in which the chapter can be played, identified by their
         #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
         #

data/lib/spotted/models/chapter_retrieve_response.rb

@@ -123,6 +123,8 @@ module Spotted
       required :uri, String
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the chapter can be played, identified by their
       #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
       #

data/lib/spotted/models/me/album_list_response.rb

@@ -57,6 +57,8 @@ module Spotted
           required :album_type, enum: -> { Spotted::Models::Me::AlbumListResponse::Album::AlbumType }
 
           # @!attribute available_markets
+          #   @deprecated
+          #
           #   The markets in which the album is available:
           #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
           #   _**NOTE**: an album is considered available in a market when at least 1 of its
@@ -136,6 +138,8 @@ module Spotted
           optional :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
 
           # @!attribute external_ids
+          #   @deprecated
+          #
           #   Known external IDs for the album.
           #
           #   @return [Spotted::Models::ExternalIDObject, nil]
@@ -150,12 +154,16 @@ module Spotted
           optional :genres, Spotted::Internal::Type::ArrayOf[String]
 
           # @!attribute label
+          #   @deprecated
+          #
           #   The label associated with the album.
           #
           #   @return [String, nil]
           optional :label, String
 
           # @!attribute popularity
+          #   @deprecated
+          #
           #   The popularity of the album. The value will be between 0 and 100, with 100 being
           #   the most popular.
           #

data/lib/spotted/models/me_retrieve_response.rb

@@ -12,6 +12,8 @@ module Spotted
       optional :id, String
 
       # @!attribute country
+      #   @deprecated
+      #
       #   The country of the user, as set in the user's account profile. An
       #   [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
       #   _This field is only available when the current user has granted access to the
@@ -28,6 +30,8 @@ module Spotted
       optional :display_name, String
 
       # @!attribute email
+      #   @deprecated
+      #
       #   The user's email address, as entered by the user when creating their account.
       #   _**Important!** This email address is unverified; there is no proof that it
       #   actually belongs to the user._ _This field is only available when the current
@@ -39,6 +43,8 @@ module Spotted
       optional :email, String
 
       # @!attribute explicit_content
+      #   @deprecated
+      #
       #   The user's explicit content settings. _This field is only available when the
       #   current user has granted access to the
       #   [user-read-private](/documentation/web-api/concepts/scopes/#list-of-scopes)
@@ -54,6 +60,8 @@ module Spotted
       optional :external_urls, -> { Spotted::ExternalURLObject }
 
       # @!attribute followers
+      #   @deprecated
+      #
       #   Information about the followers of the user.
       #
       #   @return [Spotted::Models::FollowersObject, nil]
@@ -72,6 +80,8 @@ module Spotted
       optional :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
 
       # @!attribute product
+      #   @deprecated
+      #
       #   The user's Spotify subscription level: "premium", "free", etc. (The subscription
       #   level "open" can be considered the same as "free".) _This field is only
       #   available when the current user has granted access to the
@@ -136,6 +146,8 @@ module Spotted
       #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the user
 
+      # @deprecated
+      #
       # @see Spotted::Models::MeRetrieveResponse#explicit_content
       class ExplicitContent < Spotted::Internal::Type::BaseModel
         # @!attribute filter_enabled

data/lib/spotted/models/playlist_retrieve_response.rb

@@ -82,7 +82,8 @@ module Spotted
       optional :snapshot_id, String
 
       # @!attribute tracks
-      #   The tracks of the playlist.
+      #   The tracks of the playlist. _**Note**: This field is only available for
+      #   playlists owned by the current user._
       #
       #   @return [Spotted::Models::PlaylistRetrieveResponse::Tracks, nil]
       optional :tracks, -> { Spotted::Models::PlaylistRetrieveResponse::Tracks }
@@ -127,7 +128,8 @@ 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.
+      #   @param tracks [Spotted::Models::PlaylistRetrieveResponse::Tracks] The tracks of the playlist. \_**Note**: This field is only available for
+      #   playlist
       #
       #   @param type [String] The object type: "playlist"
       #
@@ -207,7 +209,8 @@ module Spotted
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::PlaylistRetrieveResponse::Tracks} for more details.
         #
-        #   The tracks of the playlist.
+        #   The tracks of the playlist. _**Note**: This field is only available for
+        #   playlists owned by the current user._
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #

data/lib/spotted/models/search_query_response.rb

@@ -144,6 +144,8 @@ module Spotted
           required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
           # @!attribute available_markets
+          #   @deprecated
+          #
           #   The markets in which the album is available:
           #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
           #   _**NOTE**: an album is considered available in a market when at least 1 of its

data/lib/spotted/models/show_base.rb

@@ -10,6 +10,8 @@ module Spotted
       required :id, String
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the show can be played, identified by their
       #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
       #
@@ -87,6 +89,8 @@ module Spotted
       required :name, String
 
       # @!attribute publisher
+      #   @deprecated
+      #
       #   The publisher of the show.
       #
       #   @return [String]

data/lib/spotted/models/simplified_chapter_object.rb

@@ -116,6 +116,8 @@ module Spotted
       required :uri, String
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the chapter can be played, identified by their
       #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
       #

data/lib/spotted/models/simplified_track_object.rb

@@ -18,6 +18,8 @@ module Spotted
       optional :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the track can be played, identified by their
       #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
       #
@@ -70,6 +72,8 @@ module Spotted
       optional :is_playable, Spotted::Internal::Type::Boolean
 
       # @!attribute linked_from
+      #   @deprecated
+      #
       #   Part of the response when
       #   [Track Relinking](/documentation/web-api/concepts/track-relinking/) is applied
       #   and is only part of the response if the track linking, in fact, exists. The

data/lib/spotted/models/track_object.rb

@@ -25,6 +25,8 @@ module Spotted
       optional :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
       # @!attribute available_markets
+      #   @deprecated
+      #
       #   A list of the countries in which the track can be played, identified by their
       #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
       #
@@ -51,6 +53,8 @@ module Spotted
       optional :explicit, Spotted::Internal::Type::Boolean
 
       # @!attribute external_ids
+      #   @deprecated
+      #
       #   Known external IDs for the track.
       #
       #   @return [Spotted::Models::ExternalIDObject, nil]
@@ -83,6 +87,8 @@ module Spotted
       optional :is_playable, Spotted::Internal::Type::Boolean
 
       # @!attribute linked_from
+      #   @deprecated
+      #
       #   Part of the response when
       #   [Track Relinking](/documentation/web-api/concepts/track-relinking) is applied,
       #   and the requested track has been replaced with different track. The track in the
@@ -98,6 +104,8 @@ module Spotted
       optional :name, String
 
       # @!attribute popularity
+      #   @deprecated
+      #
       #   The popularity of the track. The value will be between 0 and 100, with 100 being
       #   the most popular.<br/>The popularity of a track is a value between 0 and 100,
       #   with 100 being the most popular. The popularity is calculated by algorithm and
@@ -225,6 +233,8 @@ module Spotted
         required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
 
         # @!attribute available_markets
+        #   @deprecated
+        #
         #   The markets in which the album is available:
         #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
         #   _**NOTE**: an album is considered available in a market when at least 1 of its

data/lib/spotted/models/user_retrieve_profile_response.rb

@@ -24,6 +24,8 @@ module Spotted
       optional :external_urls, -> { Spotted::ExternalURLObject }
 
       # @!attribute followers
+      #   @deprecated
+      #
       #   Information about the followers of this user.
       #
       #   @return [Spotted::Models::FollowersObject, nil]

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

@@ -83,7 +83,8 @@ module Spotted
         optional :snapshot_id, String
 
         # @!attribute tracks
-        #   The tracks of the playlist.
+        #   The tracks of the playlist. _**Note**: This field is only available for
+        #   playlists owned by the current user._
         #
         #   @return [Spotted::Models::Users::PlaylistCreateResponse::Tracks, nil]
         optional :tracks, -> { Spotted::Models::Users::PlaylistCreateResponse::Tracks }
@@ -128,7 +129,8 @@ 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.
+        #   @param tracks [Spotted::Models::Users::PlaylistCreateResponse::Tracks] The tracks of the playlist. \_**Note**: This field is only available for
+        #   playlist
         #
         #   @param type [String] The object type: "playlist"
         #
@@ -208,7 +210,8 @@ module Spotted
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::Users::PlaylistCreateResponse::Tracks} for more details.
           #
-          #   The tracks of the playlist.
+          #   The tracks of the playlist. _**Note**: This field is only available for
+          #   playlists owned by the current user._
           #
           #   @param href [String] A link to the Web API endpoint returning the full result of the request
           #

data/lib/spotted/resources/albums.rb

@@ -30,6 +30,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::AlbumBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/artists.rb

@@ -27,6 +27,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::ArtistBulkRetrieveParams} for more details.
       #
@@ -52,6 +54,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::ArtistListAlbumsParams} for more details.
       #
@@ -63,7 +67,7 @@ module Spotted
       #
       # @param include_groups [String] A comma-separated list of keywords that will be used to filter the response. If
       #
-      # @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      # @param limit [Integer] The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
       #
       # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
       #
@@ -112,6 +116,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::ArtistTopTracksParams} for more details.
       #

data/lib/spotted/resources/audiobooks.rb

@@ -31,6 +31,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::AudiobookBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/browse/categories.rb

@@ -4,6 +4,8 @@ module Spotted
   module Resources
     class Browse
       class Categories
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Browse::CategoryRetrieveParams} for more details.
         #
@@ -32,6 +34,8 @@ module Spotted
           )
         end
 
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Browse::CategoryListParams} for more details.
         #

data/lib/spotted/resources/browse.rb

@@ -38,6 +38,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::BrowseGetNewReleasesParams} for more details.
       #

data/lib/spotted/resources/chapters.rb

@@ -32,6 +32,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::ChapterBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/episodes.rb

@@ -31,6 +31,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::EpisodeBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/markets.rb

@@ -3,6 +3,8 @@
 module Spotted
   module Resources
     class Markets
+      # @deprecated
+      #
       # Get the list of markets where Spotify is available.
       #
       # @overload list(request_options: {})

data/lib/spotted/resources/playlists/tracks.rb

@@ -54,6 +54,9 @@ module Spotted
         #
         # Get full details of the items of a playlist owned by a Spotify user.
         #
+        # **Note**: This endpoint is only accessible for playlists owned by the current
+        # user.
+        #
         # @overload list(playlist_id, additional_types: nil, fields: nil, limit: nil, market: nil, offset: nil, request_options: {})
         #
         # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli

data/lib/spotted/resources/shows.rb

@@ -31,6 +31,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::ShowBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/tracks.rb

@@ -31,6 +31,8 @@ module Spotted
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::TrackBulkRetrieveParams} for more details.
       #

data/lib/spotted/resources/users/playlists.rb

@@ -4,9 +4,14 @@ module Spotted
   module Resources
     class Users
       class Playlists
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Users::PlaylistCreateParams} for more details.
         #
+        # **Deprecated**: Use
+        # [Create Playlist](/documentation/web-api/reference/create-playlist) instead.
+        #
         # Create a playlist for a Spotify user. (The playlist will be empty until you
         # [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
         # user is generally limited to a maximum of 11000 playlists.
@@ -40,6 +45,8 @@ module Spotted
           )
         end
 
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Spotted::Models::Users::PlaylistListParams} for more details.
         #

data/lib/spotted/resources/users.rb

@@ -6,6 +6,8 @@ module Spotted
       # @return [Spotted::Resources::Users::Playlists]
       attr_reader :playlists
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Spotted::Models::UserRetrieveProfileParams} for more details.
       #

data/lib/spotted/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spotted
-  VERSION = "0.34.4"
+  VERSION = "0.35.0"
 end

data/rbi/spotted/models/artist_list_albums_params.rbi

@@ -21,7 +21,7 @@ module Spotted
       sig { params(include_groups: String).void }
       attr_writer :include_groups
 
-      # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      # The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
@@ -66,7 +66,7 @@ module Spotted
         # `album`<br/>- `single`<br/>- `appears_on`<br/>- `compilation`<br/>For example:
         # `include_groups=album,single`.
         include_groups: nil,
-        # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        # The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
         limit: nil,
         # An
         # [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

data/rbi/spotted/models/playlist_retrieve_response.rbi

@@ -102,7 +102,8 @@ module Spotted
       sig { params(snapshot_id: String).void }
       attr_writer :snapshot_id
 
-      # The tracks of the playlist.
+      # The tracks of the playlist. _**Note**: This field is only available for
+      # playlists owned by the current user._
       sig do
         returns(T.nilable(Spotted::Models::PlaylistRetrieveResponse::Tracks))
       end
@@ -182,7 +183,8 @@ module Spotted
         # The version identifier for the current playlist. Can be supplied in other
         # requests to target a specific playlist version
         snapshot_id: nil,
-        # The tracks of the playlist.
+        # The tracks of the playlist. _**Note**: This field is only available for
+        # playlists owned by the current user._
         tracks: nil,
         # The object type: "playlist"
         type: nil,
@@ -295,7 +297,8 @@ module Spotted
         sig { params(published: T::Boolean).void }
         attr_writer :published
 
-        # The tracks of the playlist.
+        # The tracks of the playlist. _**Note**: This field is only available for
+        # playlists owned by the current user._
         sig do
           params(
             href: String,

data/rbi/spotted/models/users/playlist_create_response.rbi

@@ -105,7 +105,8 @@ module Spotted
         sig { params(snapshot_id: String).void }
         attr_writer :snapshot_id
 
-        # The tracks of the playlist.
+        # The tracks of the playlist. _**Note**: This field is only available for
+        # playlists owned by the current user._
         sig do
           returns(
             T.nilable(Spotted::Models::Users::PlaylistCreateResponse::Tracks)
@@ -190,7 +191,8 @@ module Spotted
           # The version identifier for the current playlist. Can be supplied in other
           # requests to target a specific playlist version
           snapshot_id: nil,
-          # The tracks of the playlist.
+          # The tracks of the playlist. _**Note**: This field is only available for
+          # playlists owned by the current user._
           tracks: nil,
           # The object type: "playlist"
           type: nil,
@@ -303,7 +305,8 @@ module Spotted
           sig { params(published: T::Boolean).void }
           attr_writer :published
 
-          # The tracks of the playlist.
+          # The tracks of the playlist. _**Note**: This field is only available for
+          # playlists owned by the current user._
           sig do
             params(
               href: String,

data/rbi/spotted/resources/artists.rbi

@@ -59,7 +59,7 @@ module Spotted
         # `album`<br/>- `single`<br/>- `appears_on`<br/>- `compilation`<br/>For example:
         # `include_groups=album,single`.
         include_groups: nil,
-        # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        # The maximum number of items to return. Default: 5. Minimum: 1. Maximum: 10.
         limit: nil,
         # An
         # [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

data/rbi/spotted/resources/playlists/tracks.rbi

@@ -58,6 +58,9 @@ module Spotted
         end
 
         # Get full details of the items of a playlist owned by a Spotify user.
+        #
+        # **Note**: This endpoint is only accessible for playlists owned by the current
+        # user.
         sig do
           params(
             playlist_id: String,

data/rbi/spotted/resources/users/playlists.rbi

@@ -4,6 +4,9 @@ module Spotted
   module Resources
     class Users
       class Playlists
+        # **Deprecated**: Use
+        # [Create Playlist](/documentation/web-api/reference/create-playlist) instead.
+        #
         # Create a playlist for a Spotify user. (The playlist will be empty until you
         # [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
         # user is generally limited to a maximum of 11000 playlists.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spotted
 version: !ruby/object:Gem::Version
-  version: 0.34.4
+  version: 0.35.0
 platform: ruby
 authors:
 - Spotted
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-07 00:00:00.000000000 Z
+date: 2026-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi