update documentation

Author: adamint

docs/docs/spotify-web-api-kotlin/alltypes/index.html

@@ -109,6 +109,7 @@ <h5><a href="../com.adamratzman.spotify.models/-authentication-error/index.html"
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-authorization-type/index.html">com.adamratzman.spotify.AuthorizationType</a></h5>
+<p>The type of Spotify authorization used to build an Api instance</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -158,7 +159,7 @@ <h5><a href="../com.adamratzman.spotify.endpoints.client/-client-player-a-p-i.ht
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.endpoints.client/-client-player-api/index.html">com.adamratzman.spotify.endpoints.client.ClientPlayerApi</a></h5>
 <p>These endpoints allow for viewing and controlling user playback. Please view <a href="https://developer.spotify.com/web-api/working-with-connect/">the official documentation</a>
-for more information on how this works. This is in beta and is available for <strong>premium users only</strong>. Endpoints are <strong>not</strong> guaranteed to work</p>
+for more information on how this works. This is in beta and is available for <strong>premium users only</strong>. Endpoints are <strong>not</strong> guaranteed to work and are subject to change!</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -292,10 +293,27 @@ <h5><a href="../com.adamratzman.spotify.utils/kotlin.collections.-hash-map/index
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.http/-http-connection/index.html">com.adamratzman.spotify.http.HttpConnection</a></h5>
+<p>Provides a fast, easy, and slim way to execute and retrieve HTTP GET, POST, PUT, and DELETE requests</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.http/-http-connection-status/index.html">com.adamratzman.spotify.http.HttpConnectionStatus</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.http/-http-header/index.html">com.adamratzman.spotify.http.HttpHeader</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.http/-http-request-method/index.html">com.adamratzman.spotify.http.HttpRequestMethod</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.http/-http-response/index.html">com.adamratzman.spotify.http.HttpResponse</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-identifiable/index.html">com.adamratzman.spotify.models.Identifiable</a></h5>
 <p>Represents an identifiable Spotify object such as an Album or Recommendation Seed</p>
 </tr>
@@ -307,14 +325,23 @@ <h5><a href="../com.adamratzman.spotify.models/-identifiable-nullable/index.html
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-i-spotify-api-builder/index.html">com.adamratzman.spotify.ISpotifyApiBuilder</a></h5>
+<p>Spotify Api builder interface</p>
 </tr>
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-i-spotify-app-api-builder.html">com.adamratzman.spotify.ISpotifyAppApiBuilder</a></h5>
+<p>App Api builder interface</p>
 </tr>
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-i-spotify-client-api-builder/index.html">com.adamratzman.spotify.ISpotifyClientApiBuilder</a></h5>
+<p>Client interface exposing <a href="../com.adamratzman.spotify/-i-spotify-client-api-builder/get-authorization-url.html#com.adamratzman.spotify.ISpotifyClientApiBuilder$getAuthorizationUrl(kotlin.Array((com.adamratzman.spotify.SpotifyScope)))">getAuthorizationUrl</a></p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.utils/-language/index.html">com.adamratzman.spotify.utils.Language</a></h5>
+<p><a href="http://en.wikipedia.org/wiki/ISO_639-1">ISO 639-1</a>
+language code.</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -329,6 +356,11 @@ <h5><a href="../com.adamratzman.spotify.models/-linked-track/index.html">com.ada
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.utils/-locale/index.html">com.adamratzman.spotify.utils.Locale</a></h5>
+<p>Locale code.</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-local-track-uri/index.html">com.adamratzman.spotify.models.LocalTrackUri</a></h5>
 <p>Represents a Spotify <strong>local track</strong> URI</p>
 </tr>
@@ -428,6 +460,10 @@ <h5><a href="../com.adamratzman.spotify.models/-recommendation-seed/index.html">
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-release-date/index.html">com.adamratzman.spotify.models.ReleaseDate</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-relinking-available-response/index.html">com.adamratzman.spotify.models.RelinkingAvailableResponse</a></h5>
 <p>Represents a response for which a relinked track could be available</p>
 </tr>
@@ -494,7 +530,7 @@ <h5><a href="../com.adamratzman.spotify/-spotify-api/index.html">com.adamratzman
 </tr>
 <tr>
 (common, js, jvm) 
-<h5><a href="../com.adamratzman.spotify/-spotify-a-p-i.html">com.adamratzman.spotify.SpotifyApi</a></h5>
+<h5><a href="../com.adamratzman.spotify/-spotify-a-p-i.html">com.adamratzman.spotify.SpotifyAPI</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -504,6 +540,7 @@ <h5><a href="../com.adamratzman.spotify/-spotify-api-builder/index.html">com.ada
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-spotify-api-options/index.html">com.adamratzman.spotify.SpotifyApiOptions</a></h5>
+<p>API Utilities</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -523,6 +560,7 @@ <h5><a href="../com.adamratzman.spotify/-spotify-app-a-p-i.html">com.adamratzman
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-spotify-app-api-builder/index.html">com.adamratzman.spotify.SpotifyAppApiBuilder</a></h5>
+<p><a href="../com.adamratzman.spotify/-spotify-app-api/index.html#com.adamratzman.spotify.SpotifyAppApi">SpotifyAppApi</a> builder for api creation using client authorization</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -541,11 +579,12 @@ <h5><a href="../com.adamratzman.spotify/-spotify-client-api/index.html">com.adam
 </tr>
 <tr>
 (common, js, jvm) 
-<h5><a href="../com.adamratzman.spotify/-spotify-client-a-p-i.html">com.adamratzman.spotify.SpotifyClientApi</a></h5>
+<h5><a href="../com.adamratzman.spotify/-spotify-client-a-p-i.html">com.adamratzman.spotify.SpotifyClientAPI</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-spotify-client-api-builder/index.html">com.adamratzman.spotify.SpotifyClientApiBuilder</a></h5>
+<p><a href="../com.adamratzman.spotify/-spotify-client-api/index.html#com.adamratzman.spotify.SpotifyClientApi">SpotifyClientApi</a> builder for api creation using client authorization</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -571,6 +610,14 @@ <h5><a href="../com.adamratzman.spotify/-spotify-exception/index.html">com.adamr
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.annotations/-spotify-experimental-function-api/index.html">com.adamratzman.spotify.annotations.SpotifyExperimentalFunctionApi</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.annotations/-spotify-experimental-http-api/index.html">com.adamratzman.spotify.annotations.SpotifyExperimentalHttpApi</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-spotify-image/index.html">com.adamratzman.spotify.models.SpotifyImage</a></h5>
 <p>A Spotify image</p>
 </tr>
@@ -634,6 +681,7 @@ <h5><a href="../com.adamratzman.spotify.models/-spotify-uri-exception/index.html
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-spotify-user-authorization/index.html">com.adamratzman.spotify.SpotifyUserAuthorization</a></h5>
+<p>User-defined authorization parameters</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -697,6 +745,7 @@ <h5><a href="../com.adamratzman.spotify.endpoints.public/-track-api/index.html">
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.endpoints.public/-track-attribute/index.html">com.adamratzman.spotify.endpoints.public.TrackAttribute</a></h5>
+<p>The track attribute wrapper contains a set value for a specific <a href="../com.adamratzman.spotify.endpoints.public/-tuneable-track-attribute/index.html#com.adamratzman.spotify.endpoints.public.TuneableTrackAttribute">TuneableTrackAttribute</a></p>
 </tr>
 <tr>
 (common, js, jvm) 

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/-init-.html

@@ -11,5 +11,6 @@ <h1>&lt;init&gt;</h1>
 <a name="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$&lt;init&gt;(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))"></a>
 (common, js, jvm) <code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-spotify-api/index.html"><span class="identifier">SpotifyApi</span></a><span class="symbol">&lt;</span><span class="identifier">*</span><span class="symbol">,</span>&nbsp;<span class="identifier">*</span><span class="symbol">&gt;</span><span class="symbol">)</span></code>
 <p>These endpoints allow you manage the artists, users and playlists that a Spotify user follows.</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/">Api Reference</a></strong></p>
 </BODY>
 </HTML>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/follow-artist.html

@@ -12,6 +12,7 @@ <h1>followArtist</h1>
 (common, js, jvm) <code><span class="keyword">fun </span><span class="identifier">followArtist</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$followArtist(kotlin.String)/artistId">artistId</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html"><span class="identifier">String</span></a><span class="symbol">)</span><span class="symbol">: </span><a href="../../com.adamratzman.spotify/-spotify-rest-action/index.html"><span class="identifier">SpotifyRestAction</span></a><span class="symbol">&lt;</span><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html"><span class="identifier">Unit</span></a><span class="symbol">&gt;</span></code>
 <p>Add the current user as a follower of an artist</p>
 <p><strong>Requires</strong> the <a href="../../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-f-o-l-l-o-w_-m-o-d-i-f-y.html#com.adamratzman.spotify.SpotifyScope.USER_FOLLOW_MODIFY">SpotifyScope.USER_FOLLOW_MODIFY</a> scope</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/follow-artists-users/">Api Reference</a></strong></p>
 <h3>Exceptions</h3>
 <p><a name="BadRequestException"></a>
 <code>BadRequestException</code> - if an invalid id is provided</p>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/follow-artists.html

@@ -12,6 +12,7 @@ <h1>followArtists</h1>
 (common, js, jvm) <code><span class="keyword">fun </span><span class="identifier">followArtists</span><span class="symbol">(</span><span class="keyword">vararg</span> <span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$followArtists(kotlin.Array((kotlin.String)))/artists">artists</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html"><span class="identifier">String</span></a><span class="symbol">)</span><span class="symbol">: </span><a href="../../com.adamratzman.spotify/-spotify-rest-action/index.html"><span class="identifier">SpotifyRestAction</span></a><span class="symbol">&lt;</span><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html"><span class="identifier">Unit</span></a><span class="symbol">&gt;</span></code>
 <p>Add the current user as a follower of other artists</p>
 <p><strong>Requires</strong> the <a href="../../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-f-o-l-l-o-w_-m-o-d-i-f-y.html#com.adamratzman.spotify.SpotifyScope.USER_FOLLOW_MODIFY">SpotifyScope.USER_FOLLOW_MODIFY</a> scope</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/follow-artists-users/">Api Reference</a></strong></p>
 <h3>Exceptions</h3>
 <p><a name="BadRequestException"></a>
 <code>BadRequestException</code> - if an invalid id is provided</p>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/follow-playlist.html

@@ -16,6 +16,7 @@ <h1>followPlaylist</h1>
 <p>Note that the scopes you provide determine only whether the current user can themselves follow the playlist
 publicly or privately (i.e. show others what they are following), not whether the playlist itself is
 public or private.</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/follow-playlist/">Api Reference</a></strong></p>
 <h3>Parameters</h3>
 <p><a name="playlist"></a>
 <code>playlist</code> - the spotify id or uri of the playlist. Any playlist can be followed, regardless of its

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/follow-user.html

@@ -12,6 +12,7 @@ <h1>followUser</h1>
 (common, js, jvm) <code><span class="keyword">fun </span><span class="identifier">followUser</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$followUser(kotlin.String)/user">user</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html"><span class="identifier">String</span></a><span class="symbol">)</span><span class="symbol">: </span><a href="../../com.adamratzman.spotify/-spotify-rest-action/index.html"><span class="identifier">SpotifyRestAction</span></a><span class="symbol">&lt;</span><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html"><span class="identifier">Unit</span></a><span class="symbol">&gt;</span></code>
 <p>Add the current user as a follower of another user</p>
 <p><strong>Requires</strong> the <a href="../../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-f-o-l-l-o-w_-m-o-d-i-f-y.html#com.adamratzman.spotify.SpotifyScope.USER_FOLLOW_MODIFY">SpotifyScope.USER_FOLLOW_MODIFY</a> scope</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/follow-artists-users/">Api Reference</a></strong></p>
 <h3>Exceptions</h3>
 <p><a name="BadRequestException"></a>
 <code>BadRequestException</code> - if an invalid id is provided</p>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/follow-users.html

@@ -12,6 +12,7 @@ <h1>followUsers</h1>
 (common, js, jvm) <code><span class="keyword">fun </span><span class="identifier">followUsers</span><span class="symbol">(</span><span class="keyword">vararg</span> <span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$followUsers(kotlin.Array((kotlin.String)))/users">users</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html"><span class="identifier">String</span></a><span class="symbol">)</span><span class="symbol">: </span><a href="../../com.adamratzman.spotify/-spotify-rest-action/index.html"><span class="identifier">SpotifyRestAction</span></a><span class="symbol">&lt;</span><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html"><span class="identifier">Unit</span></a><span class="symbol">&gt;</span></code>
 <p>Add the current user as a follower of other users</p>
 <p><strong>Requires</strong> the <a href="../../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-f-o-l-l-o-w_-m-o-d-i-f-y.html#com.adamratzman.spotify.SpotifyScope.USER_FOLLOW_MODIFY">SpotifyScope.USER_FOLLOW_MODIFY</a> scope</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/follow-artists-users/">Api Reference</a></strong></p>
 <h3>Exceptions</h3>
 <p><a name="BadRequestException"></a>
 <code>BadRequestException</code> - if an invalid id is provided</p>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/get-followed-artists.html

@@ -12,6 +12,7 @@ <h1>getFollowedArtists</h1>
 (common, js, jvm) <code><span class="keyword">fun </span><span class="identifier">getFollowedArtists</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$getFollowedArtists(kotlin.Int, kotlin.String)/limit">limit</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html"><span class="identifier">Int</span></a><span class="symbol">?</span>&nbsp;<span class="symbol">=</span>&nbsp;null<span class="symbol">, </span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$getFollowedArtists(kotlin.Int, kotlin.String)/after">after</span><span class="symbol">:</span>&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html"><span class="identifier">String</span></a><span class="symbol">?</span>&nbsp;<span class="symbol">=</span>&nbsp;null<span class="symbol">)</span><span class="symbol">: </span><a href="../../com.adamratzman.spotify/-spotify-rest-action-paging/index.html"><span class="identifier">SpotifyRestActionPaging</span></a><span class="symbol">&lt;</span><a href="../../com.adamratzman.spotify.models/-artist/index.html"><span class="identifier">Artist</span></a><span class="symbol">,</span>&nbsp;<a href="../../com.adamratzman.spotify.models/-cursor-based-paging-object/index.html"><span class="identifier">CursorBasedPagingObject</span></a><span class="symbol">&lt;</span><a href="../../com.adamratzman.spotify.models/-artist/index.html"><span class="identifier">Artist</span></a><span class="symbol">&gt;</span><span class="symbol">&gt;</span></code>
 <p>Get the current user’s followed artists.</p>
 <p><strong>Requires</strong> the <a href="../../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-f-o-l-l-o-w_-r-e-a-d.html#com.adamratzman.spotify.SpotifyScope.USER_FOLLOW_READ">SpotifyScope.USER_FOLLOW_READ</a> scope</p>
+<p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/get-followed/">Api Reference</a></strong></p>
 <h3>Parameters</h3>
 <p><a name="limit"></a>
 <code>limit</code> - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.</p>