spotted 0.25.0 → 0.27.0

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

@@ -67,10 +67,12 @@ module Spotted
         # Add the current user as a follower of one or more artists or other Spotify
         # users.
         #
-        # @overload follow(ids:, request_options: {})
+        # @overload follow(ids:, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the artist or user [Spotify IDs](/documentation/web-api/concepts
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -87,10 +89,12 @@ module Spotted
         # Remove the current user as a follower of one or more artists or other Spotify
         # users.
         #
-        # @overload unfollow(ids: nil, request_options: {})
+        # @overload unfollow(ids: nil, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the artist or user [Spotify IDs](/documentation/web-api/concepts
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]

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

@@ -287,7 +287,7 @@ module Spotted
         # API only works for users who have Spotify Premium. The order of execution is not
         # guaranteed when you use this API with other Player API endpoints.
         #
-        # @overload start_playback(device_id: nil, context_uri: nil, offset: nil, position_ms: nil, uris: nil, request_options: {})
+        # @overload start_playback(device_id: nil, context_uri: nil, offset: nil, position_ms: nil, published: nil, uris: nil, request_options: {})
         #
         # @param device_id [String] Query param: The id of the device this command is targeting. If not supplied, th
         #
@@ -297,6 +297,8 @@ module Spotted
         #
         # @param position_ms [Integer] Body param: Indicates from what position to start playback. Must be a positive n
         #
+        # @param published [Boolean] Body param: The playlist's public/private status (if it should be added to the u
+        #
         # @param uris [Array<String>] Body param: Optional. A JSON array of the Spotify track URIs to play.
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -353,12 +355,14 @@ module Spotted
         # works for users who have Spotify Premium. The order of execution is not
         # guaranteed when you use this API with other Player API endpoints.
         #
-        # @overload transfer(device_ids:, play: nil, request_options: {})
+        # @overload transfer(device_ids:, play: nil, published: nil, request_options: {})
         #
         # @param device_ids [Array<String>] A JSON array containing the ID of the device on which playback should be started
         #
         # @param play [Boolean] **true**: ensure playback happens on new device.<br/>**false** or not provided:
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]

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

@@ -64,10 +64,12 @@ module Spotted
         #
         # Delete one or more shows from current Spotify user's library.
         #
-        # @overload remove(ids: nil, request_options: {})
+        # @overload remove(ids: nil, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/we
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -83,10 +85,12 @@ module Spotted
         #
         # Save one or more shows to current Spotify user's library.
         #
-        # @overload save(ids: nil, request_options: {})
+        # @overload save(ids: nil, published: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/we
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]

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

@@ -66,10 +66,12 @@ module Spotted
         #
         # Remove one or more tracks from the current user's 'Your Music' library.
         #
-        # @overload remove(ids: nil, request_options: {})
+        # @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
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -85,10 +87,12 @@ module Spotted
         #
         # Save one or more tracks to the current user's 'Your Music' library.
         #
-        # @overload save(ids:, timestamped_ids: nil, request_options: {})
+        # @overload save(ids:, published: nil, timestamped_ids: nil, request_options: {})
         #
         # @param ids [Array<String>] A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-i
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param timestamped_ids [Array<Spotted::Models::Me::TrackSaveParams::TimestampedID>] A JSON array of objects containing track IDs with their corresponding timestamps
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]

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

@@ -36,11 +36,11 @@ module Spotted
         #
         # Add the current user as a follower of a playlist.
         #
-        # @overload follow(playlist_id, public: nil, request_options: {})
+        # @overload follow(playlist_id, published: nil, request_options: {})
         #
         # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
         #
-        # @param public [Boolean] Defaults to `true`. If `true` the playlist will be included in user's public pla
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -17,12 +17,14 @@ module Spotted
         # have different parameters. These operations can't be applied together in a
         # single request.
         #
-        # @overload update(playlist_id, insert_before: nil, range_length: nil, range_start: nil, snapshot_id: nil, uris: nil, request_options: {})
+        # @overload update(playlist_id, insert_before: nil, published: nil, range_length: nil, range_start: nil, snapshot_id: nil, uris: nil, request_options: {})
         #
         # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
         #
         # @param insert_before [Integer] The position where the items should be inserted.<br/>To reorder the items to the
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param range_length [Integer] The amount of items to be reordered. Defaults to 1 if not set.<br/>The range of
         #
         # @param range_start [Integer] The position of the first item to be reordered.
@@ -88,12 +90,14 @@ module Spotted
         #
         # Add one or more items to a user's playlist.
         #
-        # @overload add(playlist_id, position: nil, uris: nil, request_options: {})
+        # @overload add(playlist_id, position: nil, published: nil, uris: nil, request_options: {})
         #
         # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
         #
         # @param position [Integer] The position to insert the items, a zero-based index. For example, to insert the
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param uris [Array<String>] A JSON array of the [Spotify URIs](/documentation/web-api/concepts/spotify-uris-
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -117,12 +121,14 @@ module Spotted
         #
         # Remove one or more items from a user's playlist.
         #
-        # @overload remove(playlist_id, tracks:, snapshot_id: nil, request_options: {})
+        # @overload remove(playlist_id, tracks:, published: nil, snapshot_id: nil, request_options: {})
         #
         # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
         #
         # @param tracks [Array<Spotted::Models::Playlists::TrackRemoveParams::Track>] An array of objects containing [Spotify URIs](/documentation/web-api/concepts/sp
         #
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
+        #
         # @param snapshot_id [String] The playlist's snapshot ID against which you want to make the changes.
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/spotted/resources/playlists.rb

@@ -49,7 +49,7 @@ module Spotted
       # Change a playlist's name and public/private state. (The user must, of course,
       # own the playlist.)
       #
-      # @overload update(playlist_id, collaborative: nil, description: nil, name: nil, public: nil, request_options: {})
+      # @overload update(playlist_id, collaborative: nil, description: nil, name: nil, published: nil, request_options: {})
       #
       # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
       #
@@ -59,7 +59,7 @@ module Spotted
       #
       # @param name [String] The new name for the playlist, for example `"My New Playlist Title"`
       #
-      # @param public [Boolean] The playlist's public/private status (if it should be added to the user's profil
+      # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
       #
       # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
       #

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

@@ -11,7 +11,7 @@ module Spotted
         # [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
         # user is generally limited to a maximum of 11000 playlists.
         #
-        # @overload create(user_id, name:, collaborative: nil, description: nil, public: nil, request_options: {})
+        # @overload create(user_id, name:, collaborative: nil, description: nil, published: nil, request_options: {})
         #
         # @param user_id [String] The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).
         #
@@ -22,7 +22,7 @@ module Spotted
         #
         # @param description [String] value for playlist description as displayed in Spotify Clients and in the Web AP
         #
-        # @param public [Boolean] Defaults to `true`. The playlist's public/private status (if it should be added
+        # @param published [Boolean] The playlist's public/private status (if it should be added to the user's profil
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/spotted/version.rb

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

data/rbi/spotted/models/me/album_remove_params.rbi

@@ -23,9 +23,21 @@ module Spotted
         sig { params(ids: T::Array[String]).void }
         attr_writer :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,13 +48,23 @@ module Spotted
           # can be specified in one request. _**Note**: if the `ids` parameter is present in
           # the query string, any IDs listed here in the body will be ignored._
           ids: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/album_save_params.rbi

@@ -23,9 +23,21 @@ module Spotted
         sig { params(ids: T::Array[String]).void }
         attr_writer :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,13 +48,23 @@ module Spotted
           # can be specified in one request. _**Note**: if the `ids` parameter is present in
           # the query string, any IDs listed here in the body will be ignored._
           ids: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/episode_remove_params.rbi

@@ -23,9 +23,21 @@ module Spotted
         sig { params(ids: T::Array[String]).void }
         attr_writer :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,13 +48,23 @@ module Spotted
           # is present in the query string, any IDs listed here in the body will be
           # ignored._
           ids: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/episode_save_params.rbi

@@ -20,9 +20,21 @@ module Spotted
         sig { returns(T::Array[String]) }
         attr_accessor :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -33,13 +45,23 @@ module Spotted
           # is present in the query string, any IDs listed here in the body will be
           # ignored._
           ids:,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/following_follow_params.rbi

@@ -23,9 +23,21 @@ module Spotted
         sig { returns(T::Array[String]) }
         attr_accessor :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,13 +48,23 @@ module Spotted
           # IDs can be sent in one request. _**Note**: if the `ids` parameter is present in
           # the query string, any IDs listed here in the body will be ignored._
           ids:,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/following_unfollow_params.rbi

@@ -26,9 +26,21 @@ module Spotted
         sig { params(ids: T::Array[String]).void }
         attr_writer :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -39,13 +51,23 @@ module Spotted
           # IDs can be sent in one request. _**Note**: if the `ids` parameter is present in
           # the query string, any IDs listed here in the body will be ignored._
           ids: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/spotted/models/me/player_start_playback_params.rbi

@@ -51,6 +51,17 @@ module Spotted
         sig { params(position_ms: Integer).void }
         attr_writer :position_ms
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         # Optional. A JSON array of the Spotify track URIs to play. For example:
         # `{"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "spotify:track:1301WleyT98MSxVHPZCA6M"]}`
         sig { returns(T.nilable(T::Array[String])) }
@@ -65,6 +76,7 @@ module Spotted
             context_uri: String,
             offset: T::Hash[Symbol, T.anything],
             position_ms: Integer,
+            published: T::Boolean,
             uris: T::Array[String],
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -86,6 +98,12 @@ module Spotted
           # Passing in a position that is greater than the length of the track will cause
           # the player to start playing the next song.
           position_ms: nil,
+          # 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)
+          published: nil,
           # Optional. A JSON array of the Spotify track URIs to play. For example:
           # `{"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "spotify:track:1301WleyT98MSxVHPZCA6M"]}`
           uris: nil,
@@ -100,6 +118,7 @@ module Spotted
               context_uri: String,
               offset: T::Hash[Symbol, T.anything],
               position_ms: Integer,
+              published: T::Boolean,
               uris: T::Array[String],
               request_options: Spotted::RequestOptions
             }

data/rbi/spotted/models/me/player_transfer_params.rbi

@@ -28,10 +28,22 @@ module Spotted
         sig { params(play: T::Boolean).void }
         attr_writer :play
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             device_ids: T::Array[String],
             play: T::Boolean,
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -45,6 +57,12 @@ module Spotted
           # **true**: ensure playback happens on new device.<br/>**false** or not provided:
           # keep the current playback state.
           play: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
@@ -54,6 +72,7 @@ module Spotted
             {
               device_ids: T::Array[String],
               play: T::Boolean,
+              published: T::Boolean,
               request_options: Spotted::RequestOptions
             }
           )

data/rbi/spotted/models/me/show_remove_params.rbi

@@ -23,9 +23,21 @@ module Spotted
         sig { params(ids: T::Array[String]).void }
         attr_writer :ids
 
+        # 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)
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :published
+
+        sig { params(published: T::Boolean).void }
+        attr_writer :published
+
         sig do
           params(
             ids: T::Array[String],
+            published: T::Boolean,
             request_options: Spotted::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,13 +48,23 @@ module Spotted
           # parameter is present in the query string, any IDs listed here in the body will
           # be ignored._
           ids: nil,
+          # 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)
+          published: nil,
           request_options: {}
         )
         end
 
         sig do
           override.returns(
-            { ids: T::Array[String], request_options: Spotted::RequestOptions }
+            {
+              ids: T::Array[String],
+              published: T::Boolean,
+              request_options: Spotted::RequestOptions
+            }
           )
         end
         def to_hash