@tidal-music/api 0.48.0 → 0.49.0

package/dist/allAPI.generated.d.ts

@@ -22,12 +22,14 @@ export interface paths {
                     /** @description One of: DEVELOPER, UPLOAD_MARKETPLACE, MERCH_GUIDELINES, TIDAL_CONNECT_DEVELOPER (e.g. `DEVELOPER`) */
                     "filter[terms.termsType]": ("DEVELOPER" | "UPLOAD_MARKETPLACE" | "MERCH_GUIDELINES" | "TIDAL_CONNECT_DEVELOPER")[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, terms
+                     * @description Include related resources. Available relationships: owners, terms
                      * @example terms
                      */
                     include?: string[];
                     /** @description Filter by terms.isLatestVersion */
                     "filter[terms.isLatestVersion]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "terms")[];
                 };
                 header?: never;
                 path?: never;
@@ -117,7 +119,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -178,7 +180,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: terms
+                     * @description Include related resources. Available relationships: terms
                      * @example terms
                      */
                     include?: string[];
@@ -241,8 +243,10 @@ export interface paths {
                      * @example US
                      */
                     countryCode?: string;
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -298,7 +302,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -368,7 +372,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules
+                     * @description Include related resources. Available relationships: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules
                      * @example artists.albums
                      */
                     include?: string[];
@@ -378,6 +382,8 @@ export interface paths {
                     "filter[id]"?: string[];
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albumStatistics" | "artists" | "coverArt" | "genres" | "items" | "owners" | "priceConfig" | "providers" | "replacement" | "shares" | "similarAlbums" | "suggestedCoverArts" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: artists.albums
                      * @example artists.albums
@@ -479,10 +485,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules
+                     * @description Include related resources. Available relationships: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules
                      * @example artists.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albumStatistics" | "artists" | "coverArt" | "genres" | "items" | "owners" | "priceConfig" | "providers" | "replacement" | "shares" | "similarAlbums" | "suggestedCoverArts" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: artists.albums
                      * @example artists.albums
@@ -633,7 +641,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albumStatistics
+                     * @description Include related resources. Available relationships: albumStatistics
                      * @example albumStatistics
                      */
                     include?: string[];
@@ -701,7 +709,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists
+                     * @description Include related resources. Available relationships: artists
                      * @example artists.albums
                      */
                     include?: string[];
@@ -774,7 +782,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: coverArt
+                     * @description Include related resources. Available relationships: coverArt
                      * @example coverArt
                      */
                     include?: string[];
@@ -888,7 +896,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: genres
+                     * @description Include related resources. Available relationships: genres
                      * @example genres
                      */
                     include?: string[];
@@ -956,7 +964,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
@@ -1068,7 +1076,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -1136,7 +1144,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: priceConfig
+                     * @description Include related resources. Available relationships: priceConfig
                      * @example priceConfig
                      */
                     include?: string[];
@@ -1202,7 +1210,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: providers
+                     * @description Include related resources. Available relationships: providers
                      * @example providers
                      */
                     include?: string[];
@@ -1270,7 +1278,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: replacement
+                     * @description Include related resources. Available relationships: replacement
                      * @example replacement
                      */
                     include?: string[];
@@ -1336,7 +1344,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: shares
+                     * @description Include related resources. Available relationships: shares
                      * @example shares.sharedResources
                      */
                     include?: string[];
@@ -1411,7 +1419,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: similarAlbums
+                     * @description Include related resources. Available relationships: similarAlbums
                      * @example similarAlbums
                      */
                     include?: string[];
@@ -1477,7 +1485,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: suggestedCoverArts
+                     * @description Include related resources. Available relationships: suggestedCoverArts
                      * @example suggestedCoverArts
                      */
                     include?: string[];
@@ -1545,7 +1553,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: usageRules
+                     * @description Include related resources. Available relationships: usageRules
                      * @example usageRules
                      */
                     include?: string[];
@@ -1675,8 +1683,10 @@ export interface paths {
                      * @example US
                      */
                     countryCode?: string;
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -1778,7 +1788,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -1891,10 +1901,12 @@ export interface paths {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: acceptedArtists, owners, recommendedArtists
+                     * @description Include related resources. Available relationships: acceptedArtists, owners, recommendedArtists
                      * @example acceptedArtists.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("acceptedArtists" | "owners" | "recommendedArtists")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: acceptedArtists.albums
                      * @example acceptedArtists.albums
@@ -1989,10 +2001,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: acceptedArtists, owners, recommendedArtists
+                     * @description Include related resources. Available relationships: acceptedArtists, owners, recommendedArtists
                      * @example acceptedArtists.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("acceptedArtists" | "owners" | "recommendedArtists")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: acceptedArtists.albums
                      * @example acceptedArtists.albums
@@ -2141,7 +2155,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: acceptedArtists
+                     * @description Include related resources. Available relationships: acceptedArtists
                      * @example acceptedArtists.albums
                      */
                     include?: string[];
@@ -2253,7 +2267,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -2314,7 +2328,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: recommendedArtists
+                     * @description Include related resources. Available relationships: recommendedArtists
                      * @example recommendedArtists.albums
                      */
                     include?: string[];
@@ -2438,7 +2452,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, biography, claimStatus, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos
+                     * @description Include related resources. Available relationships: albums, biography, claimStatus, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos
                      * @example albums
                      */
                     include?: string[];
@@ -2448,6 +2462,8 @@ export interface paths {
                     "filter[id]"?: string[];
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "biography" | "claimStatus" | "followers" | "following" | "owners" | "profileArt" | "radio" | "roles" | "similarArtists" | "trackProviders" | "tracks" | "videos")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -2556,10 +2572,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, biography, claimStatus, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos
+                     * @description Include related resources. Available relationships: albums, biography, claimStatus, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos
                      * @example albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "biography" | "claimStatus" | "followers" | "following" | "owners" | "profileArt" | "radio" | "roles" | "similarArtists" | "trackProviders" | "tracks" | "videos")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -2673,7 +2691,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums
+                     * @description Include related resources. Available relationships: albums
                      * @example albums
                      */
                     include?: string[];
@@ -2742,7 +2760,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: biography
+                     * @description Include related resources. Available relationships: biography
                      * @example biography
                      */
                     include?: string[];
@@ -2801,7 +2819,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: claimStatus
+                     * @description Include related resources. Available relationships: claimStatus
                      * @example claimStatus
                      */
                     include?: string[];
@@ -2863,7 +2881,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: followers
+                     * @description Include related resources. Available relationships: followers
                      * @example followers.albums
                      */
                     include?: string[];
@@ -2930,7 +2948,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: following
+                     * @description Include related resources. Available relationships: following
                      * @example following.albums
                      */
                     include?: string[];
@@ -3086,7 +3104,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -3152,7 +3170,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: profileArt
+                     * @description Include related resources. Available relationships: profileArt
                      * @example profileArt
                      */
                     include?: string[];
@@ -3266,7 +3284,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: radio
+                     * @description Include related resources. Available relationships: radio
                      * @example radio.items
                      */
                     include?: string[];
@@ -3330,7 +3348,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: roles
+                     * @description Include related resources. Available relationships: roles
                      * @example roles
                      */
                     include?: string[];
@@ -3398,7 +3416,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: similarArtists
+                     * @description Include related resources. Available relationships: similarArtists
                      * @example similarArtists.albums
                      */
                     include?: string[];
@@ -3464,7 +3482,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: trackProviders
+                     * @description Include related resources. Available relationships: trackProviders
                      * @example trackProviders
                      */
                     include?: string[];
@@ -3535,7 +3553,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: tracks
+                     * @description Include related resources. Available relationships: tracks
                      * @example tracks
                      */
                     include?: string[];
@@ -3606,7 +3624,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: videos
+                     * @description Include related resources. Available relationships: videos
                      * @example videos
                      */
                     include?: string[];
@@ -3676,8 +3694,10 @@ export interface paths {
                      * @example US
                      */
                     countryCode?: string;
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path?: never;
@@ -3771,8 +3791,10 @@ export interface paths {
                      * @example US
                      */
                     countryCode?: string;
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -3828,7 +3850,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -3890,8 +3912,10 @@ export interface paths {
                 query: {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path?: never;
@@ -3980,8 +4004,10 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -4125,7 +4151,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -4244,10 +4270,12 @@ export interface paths {
                     /** @description Invite code */
                     "filter[code]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, subject
+                     * @description Include related resources. Available relationships: owners, subject
                      * @example subject.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject.items
                      * @example subject.items
@@ -4342,10 +4370,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, subject
+                     * @description Include related resources. Available relationships: owners, subject
                      * @example subject.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject.items
                      * @example subject.items
@@ -4448,7 +4478,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -4509,7 +4539,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject.items
                      */
                     include?: string[];
@@ -4577,7 +4607,7 @@ export interface paths {
                     /** @description Values prefixed with "-" are sorted descending; values without it are sorted ascending. */
                     sort?: ("createdAt" | "-createdAt" | "likeCount" | "-likeCount" | "replyCount" | "-replyCount" | "startTime" | "-startTime")[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: author, owners, parentComment
+                     * @description Include related resources. Available relationships: author, owners, parentComment
                      * @example author.albums
                      */
                     include?: string[];
@@ -4595,6 +4625,8 @@ export interface paths {
                      * @description Deprecated: use filter[subject]. Filter by subject resource type (e.g. `albums`)
                      */
                     "filter[subject.type]"?: ("albums" | "tracks" | "trackSourceFiles")[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("author" | "owners" | "parentComment")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: author.albums
                      * @example author.albums
@@ -4689,10 +4721,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: author, owners, parentComment
+                     * @description Include related resources. Available relationships: author, owners, parentComment
                      * @example author.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("author" | "owners" | "parentComment")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: author.albums
                      * @example author.albums
@@ -4841,7 +4875,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: author
+                     * @description Include related resources. Available relationships: author
                      * @example author.albums
                      */
                     include?: string[];
@@ -4905,7 +4939,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -4966,7 +5000,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: parentComment
+                     * @description Include related resources. Available relationships: parentComment
                      * @example parentComment.author.albums
                      */
                     include?: string[];
@@ -5032,10 +5066,12 @@ export interface paths {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: claimedResource, claimingArtist, owners
+                     * @description Include related resources. Available relationships: claimedResource, claimingArtist, owners
                      * @example claimedResource
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("claimedResource" | "claimingArtist" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: claimedResource
                      * @example claimedResource
@@ -5130,10 +5166,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: claimedResource, claimingArtist, owners
+                     * @description Include related resources. Available relationships: claimedResource, claimingArtist, owners
                      * @example claimedResource
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("claimedResource" | "claimingArtist" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: claimedResource
                      * @example claimedResource
@@ -5194,7 +5232,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: claimedResource
+                     * @description Include related resources. Available relationships: claimedResource
                      * @example claimedResource
                      */
                     include?: string[];
@@ -5258,7 +5296,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: claimingArtist
+                     * @description Include related resources. Available relationships: claimingArtist
                      * @example claimingArtist.albums
                      */
                     include?: string[];
@@ -5322,7 +5360,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -5383,10 +5421,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artist, category
+                     * @description Include related resources. Available relationships: artist, category
                      * @example artist.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("artist" | "category")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: artist.albums
                      * @example artist.albums
@@ -5447,7 +5487,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artist
+                     * @description Include related resources. Available relationships: artist
                      * @example artist.albums
                      */
                     include?: string[];
@@ -5511,7 +5551,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: category
+                     * @description Include related resources. Available relationships: category
                      * @example category
                      */
                     include?: string[];
@@ -5571,8 +5611,10 @@ export interface paths {
                 query: {
                     /** @description Download id (e.g. `VFJBQ0tTOjEyMzQ1`) */
                     "filter[id]": string[];
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path?: never;
@@ -5621,8 +5663,10 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -5678,7 +5722,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -5739,7 +5783,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -5755,6 +5799,8 @@ export interface paths {
                      * @description Deprecated: use filter[subject]. The type of the subject resource (e.g. `tracks`)
                      */
                     "filter[subject.type]"?: ("tracks" | "albums" | "artists")[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "subject"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
                      * @example subject
@@ -5809,7 +5855,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -5902,10 +5948,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, seedItem
+                     * @description Include related resources. Available relationships: items, seedItem
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "seedItem")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -5987,10 +6035,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, seedItem
+                     * @description Include related resources. Available relationships: items, seedItem
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "seedItem")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -6080,7 +6130,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
@@ -6171,7 +6221,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: seedItem
+                     * @description Include related resources. Available relationships: seedItem
                      * @example seedItem
                      */
                     include?: string[];
@@ -6264,7 +6314,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: modules, subject
+                     * @description Include related resources. Available relationships: modules, subject
                      * @example modules.items
                      */
                     include?: string[];
@@ -6275,6 +6325,8 @@ export interface paths {
                      * @description Deprecated alternative to filter[subject]. Omit when subject is supplied or pageType is HOME_FREE. (e.g. `67890`)
                      */
                     "filter[subject.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("modules" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: modules.items
                      * @example modules.items
@@ -6358,7 +6410,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: modules
+                     * @description Include related resources. Available relationships: modules
                      * @example modules.items
                      */
                     include?: string[];
@@ -6422,7 +6474,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -6542,10 +6594,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, parent, subject
+                     * @description Include related resources. Available relationships: owners, parent, subject
                      * @example parent.children.subject
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "parent" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: parent.children.subject
                      * @example parent.children.subject
@@ -6648,7 +6702,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -6709,7 +6763,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: parent
+                     * @description Include related resources. Available relationships: parent
                      * @example parent.children.subject
                      */
                     include?: string[];
@@ -6819,7 +6873,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -6939,10 +6993,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: children, owners
+                     * @description Include related resources. Available relationships: children, owners
                      * @example children.subject
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("children" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: children.subject
                      * @example children.subject
@@ -7093,7 +7149,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: children
+                     * @description Include related resources. Available relationships: children
                      * @example children.subject
                      */
                     include?: string[];
@@ -7157,7 +7213,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -7336,7 +7392,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: offlineInventory, owners
+                     * @description Include related resources. Available relationships: offlineInventory, owners
                      * @example offlineInventory
                      */
                     include?: string[];
@@ -7344,6 +7400,8 @@ export interface paths {
                     "filter[clientProvidedInstallationId]"?: string[];
                     /** @description User ID to filter by. Use `me` for the authenticated user */
                     "filter[owners.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("offlineInventory" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: offlineInventory
                      * @example offlineInventory
@@ -7438,10 +7496,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: offlineInventory, owners
+                     * @description Include related resources. Available relationships: offlineInventory, owners
                      * @example offlineInventory
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("offlineInventory" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: offlineInventory
                      * @example offlineInventory
@@ -7506,7 +7566,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: offlineInventory
+                     * @description Include related resources. Available relationships: offlineInventory
                      * @example offlineInventory
                      */
                     include?: string[];
@@ -7666,7 +7726,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -7783,10 +7843,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, track
+                     * @description Include related resources. Available relationships: owners, track
                      * @example track
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "track")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: track
                      * @example track
@@ -7935,7 +7997,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -8001,7 +8063,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: track
+                     * @description Include related resources. Available relationships: track
                      * @example track
                      */
                     include?: string[];
@@ -8125,10 +8187,12 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collection, item, owners
+                     * @description Include related resources. Available relationships: collection, item, owners
                      * @example collection
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("collection" | "item" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: collection
                      * @example collection
@@ -8183,10 +8247,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collection, item, owners
+                     * @description Include related resources. Available relationships: collection, item, owners
                      * @example collection
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("collection" | "item" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: collection
                      * @example collection
@@ -8293,7 +8359,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collection
+                     * @description Include related resources. Available relationships: collection
                      * @example collection
                      */
                     include?: string[];
@@ -8357,7 +8423,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: item
+                     * @description Include related resources. Available relationships: item
                      * @example item
                      */
                     include?: string[];
@@ -8421,7 +8487,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -8486,10 +8552,12 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: changeEventStream, current, future, owners, past
+                     * @description Include related resources. Available relationships: changeEventStream, current, future, owners, past
                      * @example current
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("changeEventStream" | "current" | "future" | "owners" | "past")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: current
                      * @example current
@@ -8584,10 +8652,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: changeEventStream, current, future, owners, past
+                     * @description Include related resources. Available relationships: changeEventStream, current, future, owners, past
                      * @example current
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("changeEventStream" | "current" | "future" | "owners" | "past")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: current
                      * @example current
@@ -8736,7 +8806,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: changeEventStream
+                     * @description Include related resources. Available relationships: changeEventStream
                      * @example changeEventStream
                      */
                     include?: string[];
@@ -8791,7 +8861,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: current
+                     * @description Include related resources. Available relationships: current
                      * @example current
                      */
                     include?: string[];
@@ -8903,7 +8973,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: future
+                     * @description Include related resources. Available relationships: future
                      * @example future
                      */
                     include?: string[];
@@ -8947,7 +9017,7 @@ export interface paths {
         put?: never;
         /**
          * Add to future relationship ("to-many").
-         * @description Adds item(s) to future relationship.
+         * @description With meta.source, startIndex selects an entry in the first page's data before unsupported types are skipped. Tracks and videos are added in page order, retaining duplicates; other types are skipped without expansion. Reaching 1000 added items or 100 pages queues the collected prefix. Invalid sources or indexes, a suffix with no playable items, repeated pages, and read failures encountered before a cap leave the queue unchanged.
          */
         post: {
             parameters: {
@@ -9105,7 +9175,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -9168,7 +9238,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: past
+                     * @description Include related resources. Available relationships: past
                      * @example past
                      */
                     include?: string[];
@@ -9234,10 +9304,12 @@ export interface paths {
                     /** @description Playlist id (e.g. `550e8400-e29b-41d4-a716-446655440000`) */
                     "filter[playlist.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playlist
+                     * @description Include related resources. Available relationships: playlist
                      * @example playlist.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "playlist"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: playlist.items
                      * @example playlist.items
@@ -9333,10 +9405,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playlist
+                     * @description Include related resources. Available relationships: playlist
                      * @example playlist.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "playlist"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: playlist.items
                      * @example playlist.items
@@ -9473,7 +9547,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playlist
+                     * @description Include related resources. Available relationships: playlist
                      * @example playlist.items
                      */
                     include?: string[];
@@ -9535,10 +9609,12 @@ export interface paths {
                     /** @description Playlist id (e.g. `550e8400-e29b-41d4-a716-446655440000`) */
                     "filter[playlist.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: baseGeneration, playlist, trackPreferences
+                     * @description Include related resources. Available relationships: baseGeneration, playlist, trackPreferences
                      * @example baseGeneration.trackPreferences
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("baseGeneration" | "playlist" | "trackPreferences")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: baseGeneration.trackPreferences
                      * @example baseGeneration.trackPreferences
@@ -9633,10 +9709,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: baseGeneration, playlist, trackPreferences
+                     * @description Include related resources. Available relationships: baseGeneration, playlist, trackPreferences
                      * @example baseGeneration.trackPreferences
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("baseGeneration" | "playlist" | "trackPreferences")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: baseGeneration.trackPreferences
                      * @example baseGeneration.trackPreferences
@@ -9697,7 +9775,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: baseGeneration
+                     * @description Include related resources. Available relationships: baseGeneration
                      * @example baseGeneration.trackPreferences
                      */
                     include?: string[];
@@ -9761,7 +9839,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playlist
+                     * @description Include related resources. Available relationships: playlist
                      * @example playlist.items
                      */
                     include?: string[];
@@ -9827,7 +9905,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: trackPreferences
+                     * @description Include related resources. Available relationships: trackPreferences
                      * @example trackPreferences
                      */
                     include?: string[];
@@ -10038,7 +10116,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collaboratorProfiles, collaborators, coverArt, curators, items, ownerProfiles, owners, suggestedCoverArts
+                     * @description Include related resources. Available relationships: collaboratorProfiles, collaborators, coverArt, curators, items, ownerProfiles, owners, suggestedCoverArts
                      * @example curators.albums
                      */
                     include?: string[];
@@ -10048,6 +10126,8 @@ export interface paths {
                     "filter[id]"?: string[];
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("collaboratorProfiles" | "collaborators" | "coverArt" | "curators" | "items" | "ownerProfiles" | "owners" | "suggestedCoverArts")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: curators.albums
                      * @example curators.albums
@@ -10147,10 +10227,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collaboratorProfiles, collaborators, coverArt, curators, items, ownerProfiles, owners, suggestedCoverArts
+                     * @description Include related resources. Available relationships: collaboratorProfiles, collaborators, coverArt, curators, items, ownerProfiles, owners, suggestedCoverArts
                      * @example curators.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("collaboratorProfiles" | "collaborators" | "coverArt" | "curators" | "items" | "ownerProfiles" | "owners" | "suggestedCoverArts")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: curators.albums
                      * @example curators.albums
@@ -10300,7 +10382,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collaboratorProfiles
+                     * @description Include related resources. Available relationships: collaboratorProfiles
                      * @example collaboratorProfiles
                      */
                     include?: string[];
@@ -10408,7 +10490,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: collaborators
+                     * @description Include related resources. Available relationships: collaborators
                      * @example collaborators
                      */
                     include?: string[];
@@ -10474,7 +10556,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: coverArt
+                     * @description Include related resources. Available relationships: coverArt
                      * @example coverArt
                      */
                     include?: string[];
@@ -10583,7 +10665,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: curators
+                     * @description Include related resources. Available relationships: curators
                      * @example curators.albums
                      */
                     include?: string[];
@@ -10656,7 +10738,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
@@ -10861,7 +10943,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: ownerProfiles
+                     * @description Include related resources. Available relationships: ownerProfiles
                      * @example ownerProfiles
                      */
                     include?: string[];
@@ -10922,7 +11004,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -10983,7 +11065,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: suggestedCoverArts
+                     * @description Include related resources. Available relationships: suggestedCoverArts
                      * @example suggestedCoverArts
                      */
                     include?: string[];
@@ -11189,10 +11271,12 @@ export interface paths {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, provider
+                     * @description Include related resources. Available relationships: owners, provider
                      * @example provider
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "provider")[];
                 };
                 header?: never;
                 path?: never;
@@ -11242,7 +11326,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -11300,7 +11384,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: provider
+                     * @description Include related resources. Available relationships: provider
                      * @example provider
                      */
                     include?: string[];
@@ -11363,7 +11447,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: provider, subject
+                     * @description Include related resources. Available relationships: provider, subject
                      * @example subject
                      */
                     include?: string[];
@@ -11371,6 +11455,8 @@ export interface paths {
                     "filter[barcodeId]"?: string[];
                     /** @description List of GRIDs (Global Release Identifier, ISO 7064) (e.g. `A10302B0013941653J`) */
                     "filter[grid]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("provider" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
                      * @example subject
@@ -11425,7 +11511,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: provider
+                     * @description Include related resources. Available relationships: provider
                      * @example provider
                      */
                     include?: string[];
@@ -11486,7 +11572,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -11606,10 +11692,12 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, subject
+                     * @description Include related resources. Available relationships: owners, subject
                      * @example subject
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "subject")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
                      * @example subject
@@ -11664,7 +11752,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -11725,7 +11813,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: subject
+                     * @description Include related resources. Available relationships: subject
                      * @example subject
                      */
                     include?: string[];
@@ -11794,7 +11882,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: author, ownerProfiles, owners
+                     * @description Include related resources. Available relationships: author, ownerProfiles, owners
                      * @example author.albums
                      */
                     include?: string[];
@@ -11812,6 +11900,8 @@ export interface paths {
                      * @description Deprecated: use filter[subject]. Filter by subject resource type (e.g. `albums`)
                      */
                     "filter[subject.type]"?: ("albums" | "tracks" | "artists" | "videos" | "playlists" | "comments" | "trackSourceFiles")[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("author" | "ownerProfiles" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: author.albums
                      * @example author.albums
@@ -11964,7 +12054,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: author
+                     * @description Include related resources. Available relationships: author
                      * @example author.albums
                      */
                     include?: string[];
@@ -12029,7 +12119,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: ownerProfiles
+                     * @description Include related resources. Available relationships: ownerProfiles
                      * @example ownerProfiles
                      */
                     include?: string[];
@@ -12090,7 +12180,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -12342,10 +12432,12 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, artists, playlists, topHits, tracks, videos
+                     * @description Include related resources. Available relationships: albums, artists, playlists, topHits, tracks, videos
                      * @example albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "artists" | "playlists" | "topHits" | "tracks" | "videos")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -12427,7 +12519,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums
+                     * @description Include related resources. Available relationships: albums
                      * @example albums
                      */
                     include?: string[];
@@ -12515,7 +12607,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists
+                     * @description Include related resources. Available relationships: artists
                      * @example artists
                      */
                     include?: string[];
@@ -12603,7 +12695,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playlists
+                     * @description Include related resources. Available relationships: playlists
                      * @example playlists
                      */
                     include?: string[];
@@ -12691,7 +12783,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: topHits
+                     * @description Include related resources. Available relationships: topHits
                      * @example topHits
                      */
                     include?: string[];
@@ -12779,7 +12871,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: tracks
+                     * @description Include related resources. Available relationships: tracks
                      * @example tracks
                      */
                     include?: string[];
@@ -12867,7 +12959,7 @@ export interface paths {
                      */
                     clientVersion?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: videos
+                     * @description Include related resources. Available relationships: videos
                      * @example videos
                      */
                     include?: string[];
@@ -12940,10 +13032,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: directHits, history
+                     * @description Include related resources. Available relationships: directHits, history
                      * @example directHits
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("directHits" | "history")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: directHits
                      * @example directHits
@@ -13008,7 +13102,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: directHits
+                     * @description Include related resources. Available relationships: directHits
                      * @example directHits
                      */
                     include?: string[];
@@ -13081,7 +13175,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: history
+                     * @description Include related resources. Available relationships: history
                      * @example history
                      */
                     include?: string[];
@@ -13141,10 +13235,12 @@ export interface paths {
                     /** @description A share code (e.g. `xyz`) */
                     "filter[code]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, sharedResources
+                     * @description Include related resources. Available relationships: owners, sharedResources
                      * @example sharedResources
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "sharedResources")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: sharedResources
                      * @example sharedResources
@@ -13239,10 +13335,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners, sharedResources
+                     * @description Include related resources. Available relationships: owners, sharedResources
                      * @example sharedResources
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("owners" | "sharedResources")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: sharedResources
                      * @example sharedResources
@@ -13303,7 +13401,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -13366,7 +13464,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: sharedResources
+                     * @description Include related resources. Available relationships: sharedResources
                      * @example sharedResources
                      */
                     include?: string[];
@@ -13486,10 +13584,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: selectedSite, sites
+                     * @description Include related resources. Available relationships: selectedSite, sites
                      * @example selectedSite
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("selectedSite" | "sites")[];
                 };
                 header?: never;
                 path: {
@@ -13546,7 +13646,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: selectedSite
+                     * @description Include related resources. Available relationships: selectedSite
                      * @example selectedSite
                      */
                     include?: string[];
@@ -13653,7 +13753,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: sites
+                     * @description Include related resources. Available relationships: sites
                      * @example sites
                      */
                     include?: string[];
@@ -13716,8 +13816,10 @@ export interface paths {
                 query: {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path?: never;
@@ -13807,7 +13909,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -13869,8 +13971,10 @@ export interface paths {
                 query: {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path?: never;
@@ -13920,7 +14024,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -13983,10 +14087,12 @@ export interface paths {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: priceChange
+                     * @description Include related resources. Available relationships: priceChange
                      * @example priceChange
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "priceChange"[];
                 };
                 header?: never;
                 path?: never;
@@ -14138,7 +14244,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: priceChange
+                     * @description Include related resources. Available relationships: priceChange
                      * @example priceChange
                      */
                     include?: string[];
@@ -14252,8 +14358,10 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -14309,7 +14417,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -14653,8 +14761,10 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -14710,7 +14820,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -14775,8 +14885,10 @@ export interface paths {
                      * @example US
                      */
                     countryCode?: string;
-                    /** @description Allows the client to customize which related resources should be returned. Available options: owners */
+                    /** @description Include related resources. Available relationships: owners */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "owners"[];
                 };
                 header?: never;
                 path: {
@@ -14832,7 +14944,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -14902,7 +15014,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules
+                     * @description Include related resources. Available relationships: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules
                      * @example albums
                      */
                     include?: string[];
@@ -14912,6 +15024,8 @@ export interface paths {
                     "filter[isrc]"?: string[];
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "artists" | "credits" | "download" | "genres" | "lyrics" | "metadataStatus" | "owners" | "priceConfig" | "providers" | "radio" | "replacement" | "shares" | "similarTracks" | "sourceFile" | "suggestedTracks" | "trackStatistics" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -15013,10 +15127,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules
+                     * @description Include related resources. Available relationships: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules
                      * @example albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "artists" | "credits" | "download" | "genres" | "lyrics" | "metadataStatus" | "owners" | "priceConfig" | "providers" | "radio" | "replacement" | "shares" | "similarTracks" | "sourceFile" | "suggestedTracks" | "trackStatistics" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -15172,7 +15288,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums
+                     * @description Include related resources. Available relationships: albums
                      * @example albums
                      */
                     include?: string[];
@@ -15293,7 +15409,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists
+                     * @description Include related resources. Available relationships: artists
                      * @example artists.albums
                      */
                     include?: string[];
@@ -15361,7 +15477,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: credits
+                     * @description Include related resources. Available relationships: credits
                      * @example credits.artist.albums
                      */
                     include?: string[];
@@ -15427,7 +15543,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: download
+                     * @description Include related resources. Available relationships: download
                      * @example download
                      */
                     include?: string[];
@@ -15493,7 +15609,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: genres
+                     * @description Include related resources. Available relationships: genres
                      * @example genres
                      */
                     include?: string[];
@@ -15556,7 +15672,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: lyrics
+                     * @description Include related resources. Available relationships: lyrics
                      * @example lyrics.track
                      */
                     include?: string[];
@@ -15624,7 +15740,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: metadataStatus
+                     * @description Include related resources. Available relationships: metadataStatus
                      * @example metadataStatus
                      */
                     include?: string[];
@@ -15685,7 +15801,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -15753,7 +15869,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: priceConfig
+                     * @description Include related resources. Available relationships: priceConfig
                      * @example priceConfig
                      */
                     include?: string[];
@@ -15819,7 +15935,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: providers
+                     * @description Include related resources. Available relationships: providers
                      * @example providers
                      */
                     include?: string[];
@@ -15882,7 +15998,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: radio
+                     * @description Include related resources. Available relationships: radio
                      * @example radio.items
                      */
                     include?: string[];
@@ -15955,7 +16071,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: replacement
+                     * @description Include related resources. Available relationships: replacement
                      * @example replacement
                      */
                     include?: string[];
@@ -16021,7 +16137,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: shares
+                     * @description Include related resources. Available relationships: shares
                      * @example shares.sharedResources
                      */
                     include?: string[];
@@ -16096,7 +16212,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: similarTracks
+                     * @description Include related resources. Available relationships: similarTracks
                      * @example similarTracks
                      */
                     include?: string[];
@@ -16162,7 +16278,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: sourceFile
+                     * @description Include related resources. Available relationships: sourceFile
                      * @example sourceFile
                      */
                     include?: string[];
@@ -16230,7 +16346,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: suggestedTracks
+                     * @description Include related resources. Available relationships: suggestedTracks
                      * @example suggestedTracks
                      */
                     include?: string[];
@@ -16296,7 +16412,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: trackStatistics
+                     * @description Include related resources. Available relationships: trackStatistics
                      * @example trackStatistics
                      */
                     include?: string[];
@@ -16362,7 +16478,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: usageRules
+                     * @description Include related resources. Available relationships: usageRules
                      * @example usageRules
                      */
                     include?: string[];
@@ -16590,10 +16706,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -16663,10 +16781,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
+                    /** @description Filter albums by a free-text query matched against the album title and artist names. Internal clients only (e.g. `love`) */
+                    "filter[query]"?: string;
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -16695,6 +16815,7 @@ export interface paths {
                     };
                 };
                 400: components["responses"]["Default400Response"];
+                403: components["responses"]["UserCollectionAlbumsReadMultiDataRelationship403Response"];
                 404: components["responses"]["Default404Response"];
                 405: components["responses"]["Default405Response"];
                 406: components["responses"]["Default406Response"];
@@ -16819,7 +16940,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -16885,10 +17006,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.albums
                      * @example items.albums
@@ -16958,10 +17081,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.albums
                      */
                     include?: string[];
+                    /** @description Filter artists by a free-text query matched against the artist name. Internal clients only (e.g. `love`) */
+                    "filter[query]"?: string;
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.albums
                      * @example items.albums
@@ -16990,6 +17115,7 @@ export interface paths {
                     };
                 };
                 400: components["responses"]["Default400Response"];
+                403: components["responses"]["UserCollectionArtistsReadMultiDataRelationship403Response"];
                 404: components["responses"]["Default404Response"];
                 405: components["responses"]["Default405Response"];
                 406: components["responses"]["Default406Response"];
@@ -17114,7 +17240,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -17177,10 +17303,12 @@ export interface paths {
                     /** @description Folder Id (e.g. `CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX`) */
                     "filter[id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners, userCollection
+                     * @description Include related resources. Available relationships: items, owners, userCollection
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners" | "userCollection")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -17275,10 +17403,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners, userCollection
+                     * @description Include related resources. Available relationships: items, owners, userCollection
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners" | "userCollection")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -17431,7 +17561,7 @@ export interface paths {
                     /** @description Values prefixed with "-" are sorted descending; values without it are sorted ascending. */
                     sort?: ("addedAt" | "-addedAt" | "lastModifiedAt" | "-lastModifiedAt" | "name" | "-name")[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -17587,7 +17717,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -17648,7 +17778,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: userCollection
+                     * @description Include related resources. Available relationships: userCollection
                      * @example userCollection.items.items
                      */
                     include?: string[];
@@ -17717,10 +17847,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -17786,7 +17918,7 @@ export interface paths {
                     /** @description Values prefixed with "-" are sorted descending; values without it are sorted ascending. */
                     sort?: ("addedAt" | "-addedAt" | "lastModifiedAt" | "-lastModifiedAt" | "name" | "-name")[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -17820,6 +17952,7 @@ export interface paths {
                     };
                 };
                 400: components["responses"]["Default400Response"];
+                403: components["responses"]["UserCollectionPlaylistsReadMultiDataRelationship403Response"];
                 404: components["responses"]["Default404Response"];
                 405: components["responses"]["Default405Response"];
                 406: components["responses"]["Default406Response"];
@@ -17944,7 +18077,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -18005,10 +18138,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -18071,7 +18206,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
@@ -18227,7 +18362,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -18293,10 +18428,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -18366,10 +18503,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
+                    /** @description Filter tracks by a free-text query matched against the track title, artist names and album title. Internal clients only (e.g. `love`) */
+                    "filter[query]"?: string;
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -18398,6 +18537,7 @@ export interface paths {
                     };
                 };
                 400: components["responses"]["Default400Response"];
+                403: components["responses"]["UserCollectionTracksReadMultiDataRelationship403Response"];
                 404: components["responses"]["Default404Response"];
                 405: components["responses"]["Default405Response"];
                 406: components["responses"]["Default406Response"];
@@ -18522,7 +18662,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -18588,10 +18728,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items, owners
+                     * @description Include related resources. Available relationships: items, owners
                      * @example items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("items" | "owners")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -18661,10 +18803,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items
                      */
                     include?: string[];
+                    /** @description Filter videos by a free-text query matched against the video title and artist names. Internal clients only (e.g. `love`) */
+                    "filter[query]"?: string;
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items
                      * @example items
@@ -18693,6 +18837,7 @@ export interface paths {
                     };
                 };
                 400: components["responses"]["Default400Response"];
+                403: components["responses"]["UserCollectionVideosReadMultiDataRelationship403Response"];
                 404: components["responses"]["Default404Response"];
                 405: components["responses"]["Default405Response"];
                 406: components["responses"]["Default406Response"];
@@ -18817,7 +18962,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -18883,10 +19028,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "items"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -18954,7 +19101,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -19079,10 +19226,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "items"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -19150,7 +19299,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -19219,10 +19368,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "items"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -19290,7 +19441,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -19359,10 +19510,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "items"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: items.items
                      * @example items.items
@@ -19430,7 +19583,7 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: items
+                     * @description Include related resources. Available relationships: items
                      * @example items.items
                      */
                     include?: string[];
@@ -19494,10 +19647,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: activePlayer, availablePlayers, changeEventStream, playQueue
+                     * @description Include related resources. Available relationships: activePlayer, availablePlayers, changeEventStream, playQueue
                      * @example activePlayer.offlineInventory
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("activePlayer" | "availablePlayers" | "changeEventStream" | "playQueue")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: activePlayer.offlineInventory
                      * @example activePlayer.offlineInventory
@@ -19604,7 +19759,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: activePlayer
+                     * @description Include related resources. Available relationships: activePlayer
                      * @example activePlayer.offlineInventory
                      */
                     include?: string[];
@@ -19714,7 +19869,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: availablePlayers
+                     * @description Include related resources. Available relationships: availablePlayers
                      * @example availablePlayers.offlineInventory
                      */
                     include?: string[];
@@ -19872,7 +20027,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: changeEventStream
+                     * @description Include related resources. Available relationships: changeEventStream
                      * @example changeEventStream
                      */
                     include?: string[];
@@ -19927,7 +20082,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: playQueue
+                     * @description Include related resources. Available relationships: playQueue
                      * @example playQueue.current
                      */
                     include?: string[];
@@ -20042,10 +20197,12 @@ export interface paths {
                      */
                     locale?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists, owners, tracks, videos
+                     * @description Include related resources. Available relationships: artists, owners, tracks, videos
                      * @example artists.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("artists" | "owners" | "tracks" | "videos")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: artists.albums
                      * @example artists.albums
@@ -20108,7 +20265,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists
+                     * @description Include related resources. Available relationships: artists
                      * @example artists.albums
                      */
                     include?: string[];
@@ -20264,7 +20421,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: owners
+                     * @description Include related resources. Available relationships: owners
                      * @example owners
                      */
                     include?: string[];
@@ -20327,7 +20484,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: tracks
+                     * @description Include related resources. Available relationships: tracks
                      * @example tracks
                      */
                     include?: string[];
@@ -20485,7 +20642,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: videos
+                     * @description Include related resources. Available relationships: videos
                      * @example videos
                      */
                     include?: string[];
@@ -20700,10 +20857,12 @@ export interface paths {
                     /** @description User id. Use `me` for the authenticated user */
                     "filter[owners.id]": string[];
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: decision
+                     * @description Include related resources. Available relationships: decision
                      * @example decision
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "decision"[];
                 };
                 header?: never;
                 path?: never;
@@ -20753,7 +20912,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: decision
+                     * @description Include related resources. Available relationships: decision
                      * @example decision
                      */
                     include?: string[];
@@ -20812,10 +20971,12 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artist
+                     * @description Include related resources. Available relationships: artist
                      * @example artist.albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: "artist"[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: artist.albums
                      * @example artist.albums
@@ -20876,7 +21037,7 @@ export interface paths {
             parameters: {
                 query?: {
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artist
+                     * @description Include related resources. Available relationships: artist
                      * @example artist.albums
                      */
                     include?: string[];
@@ -21002,7 +21163,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules
+                     * @description Include related resources. Available relationships: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules
                      * @example albums
                      */
                     include?: string[];
@@ -21010,6 +21171,8 @@ export interface paths {
                     "filter[id]"?: string[];
                     /** @description List of ISRCs (e.g. `QMJMT1701237`) */
                     "filter[isrc]"?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "artists" | "credits" | "providers" | "replacement" | "similarVideos" | "suggestedVideos" | "thumbnailArt" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -21069,10 +21232,12 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules
+                     * @description Include related resources. Available relationships: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules
                      * @example albums
                      */
                     include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("albums" | "artists" | "credits" | "providers" | "replacement" | "similarVideos" | "suggestedVideos" | "thumbnailArt" | "usageRules")[];
                     /**
                      * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: albums
                      * @example albums
@@ -21140,7 +21305,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: albums
+                     * @description Include related resources. Available relationships: albums
                      * @example albums
                      */
                     include?: string[];
@@ -21211,7 +21376,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: artists
+                     * @description Include related resources. Available relationships: artists
                      * @example artists.albums
                      */
                     include?: string[];
@@ -21277,7 +21442,7 @@ export interface paths {
                     /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
                     "page[cursor]"?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: credits
+                     * @description Include related resources. Available relationships: credits
                      * @example credits.artist.albums
                      */
                     include?: string[];
@@ -21348,7 +21513,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: providers
+                     * @description Include related resources. Available relationships: providers
                      * @example providers
                      */
                     include?: string[];
@@ -21412,7 +21577,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: replacement
+                     * @description Include related resources. Available relationships: replacement
                      * @example replacement
                      */
                     include?: string[];
@@ -21483,7 +21648,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: similarVideos
+                     * @description Include related resources. Available relationships: similarVideos
                      * @example similarVideos
                      */
                     include?: string[];
@@ -21554,7 +21719,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: suggestedVideos
+                     * @description Include related resources. Available relationships: suggestedVideos
                      * @example suggestedVideos
                      */
                     include?: string[];
@@ -21625,7 +21790,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: thumbnailArt
+                     * @description Include related resources. Available relationships: thumbnailArt
                      * @example thumbnailArt
                      */
                     include?: string[];
@@ -21689,7 +21854,7 @@ export interface paths {
                      */
                     countryCode?: string;
                     /**
-                     * @description Allows the client to customize which related resources should be returned. Available options: usageRules
+                     * @description Include related resources. Available relationships: usageRules
                      * @example usageRules
                      */
                     include?: string[];
@@ -21733,6 +21898,253 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/viewerContexts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get multiple viewerContexts.
+         * @description Returns viewer contexts for up to 20 original subjects. Duplicate subjects are returned once.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Original subjects to look up. */
+                    "filter[subject]": string[];
+                    /**
+                     * @description Include related resources. Available relationships: subject, viewer
+                     * @example subject
+                     */
+                    include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("subject" | "viewer")[];
+                    /**
+                     * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
+                     * @example subject
+                     */
+                    replaceMedia?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/vnd.api+json": components["schemas"]["ViewerContexts_Multi_Resource_Data_Document"];
+                    };
+                };
+                400: components["responses"]["Default400Response"];
+                404: components["responses"]["Default404Response"];
+                405: components["responses"]["Default405Response"];
+                406: components["responses"]["Default406Response"];
+                415: components["responses"]["Default415Response"];
+                429: components["responses"]["Default429Response"];
+                500: components["responses"]["Default500Response"];
+                503: components["responses"]["Default503Response"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/viewerContexts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get single viewerContext.
+         * @description Retrieves single viewerContext by id.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /**
+                     * @description Include related resources. Available relationships: subject, viewer
+                     * @example subject
+                     */
+                    include?: string[];
+                    /** @description Comma-separated direct relationships to return as linkage only, without related content. */
+                    includeLinkage?: ("subject" | "viewer")[];
+                    /**
+                     * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
+                     * @example subject
+                     */
+                    replaceMedia?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Opaque identifier of one authenticated viewer and original subject pair */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/vnd.api+json": components["schemas"]["ViewerContexts_Single_Resource_Data_Document"];
+                    };
+                };
+                400: components["responses"]["Default400Response"];
+                404: components["responses"]["Default404Response"];
+                405: components["responses"]["Default405Response"];
+                406: components["responses"]["Default406Response"];
+                415: components["responses"]["Default415Response"];
+                429: components["responses"]["Default429Response"];
+                500: components["responses"]["Default500Response"];
+                503: components["responses"]["Default503Response"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/viewerContexts/{id}/relationships/subject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get subject relationship ("to-one").
+         * @description Returns the subject of this viewer context.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /**
+                     * @description Include related resources. Available relationships: subject
+                     * @example subject
+                     */
+                    include?: string[];
+                    /**
+                     * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: subject
+                     * @example subject
+                     */
+                    replaceMedia?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Opaque identifier of one authenticated viewer and original subject pair */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/vnd.api+json": components["schemas"]["ViewerContexts_Subject_Single_Relationship_Data_Document"];
+                    };
+                };
+                400: components["responses"]["Default400Response"];
+                404: components["responses"]["Default404Response"];
+                405: components["responses"]["Default405Response"];
+                406: components["responses"]["Default406Response"];
+                415: components["responses"]["Default415Response"];
+                429: components["responses"]["Default429Response"];
+                500: components["responses"]["Default500Response"];
+                503: components["responses"]["Default503Response"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/viewerContexts/{id}/relationships/viewer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get viewer relationship ("to-one").
+         * @description Returns the authenticated viewer of this context.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /**
+                     * @description Include related resources. Available relationships: viewer
+                     * @example viewer.artist.albums
+                     */
+                    include?: string[];
+                    /**
+                     * @description Applies context-dependent replacements to media resource identifiers in selected relationships without changing stored data. Paths are comma-separated and follow `include` syntax. Example: viewer.artist.albums
+                     * @example viewer.artist.albums
+                     */
+                    replaceMedia?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Opaque identifier of one authenticated viewer and original subject pair */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/vnd.api+json": components["schemas"]["ViewerContexts_Viewer_Single_Relationship_Data_Document"];
+                    };
+                };
+                400: components["responses"]["Default400Response"];
+                404: components["responses"]["Default404Response"];
+                405: components["responses"]["Default405Response"];
+                406: components["responses"]["Default406Response"];
+                415: components["responses"]["Default415Response"];
+                429: components["responses"]["Default429Response"];
+                500: components["responses"]["Default500Response"];
+                503: components["responses"]["Default503Response"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -22084,7 +22496,6 @@ export interface components {
             type: string;
         };
         Albums_Items_Resource_Identifier_Meta: {
-            itemCursor?: string;
             replacement?: components["schemas"]["Replacement_Provenance"];
             /**
              * Format: int32
@@ -22830,7 +23241,10 @@ export interface components {
         };
         /** @description Artwork files */
         Artwork_File: {
-            /** @description Artwork file href */
+            /**
+             * Format: uri
+             * @description Artwork file href
+             */
             href: string;
             meta: components["schemas"]["Artwork_File_Meta"];
         };
@@ -23159,6 +23573,8 @@ export interface components {
             included?: components["schemas"]["Included"];
             links: components["schemas"]["Links"];
         };
+        /** @description The viewer has at least one existing comment on the subject; deleted historical comments do not count. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        Commented: Record<string, never>;
         CommentsCreateOperation_Payload: {
             data: components["schemas"]["CommentsCreateOperation_Payload_Data"];
         };
@@ -23543,7 +23959,10 @@ export interface components {
             }[];
         };
         Download_Link: {
-            /** @description URL to download the content from */
+            /**
+             * Format: uri
+             * @description URL to download the content from
+             */
             href: string;
             meta: components["schemas"]["Download_Link_Meta"];
         };
@@ -23848,6 +24267,7 @@ export interface components {
             links?: components["schemas"]["Links"];
         };
         External_Link: {
+            /** Format: uri */
             href: string;
             meta: components["schemas"]["External_Link_Meta"];
         };
@@ -23857,6 +24277,7 @@ export interface components {
             type: "TIDAL_SHARING" | "TIDAL_USER_SHARING" | "TIDAL_AUTOPLAY_ANDROID" | "TIDAL_AUTOPLAY_IOS" | "TIDAL_AUTOPLAY_WEB" | "TWITTER" | "FACEBOOK" | "INSTAGRAM" | "TIKTOK" | "SNAPCHAT" | "OFFICIAL_HOMEPAGE" | "CASHAPP_CONTRIBUTIONS" | "ARTIST_CLAIM_PROVIDER_REDIRECT" | "STRIPE_AUTHORIZATION_REDIRECT" | "SQUARE_AUTHORIZATION_REDIRECT";
         };
         External_Link_Payload: {
+            /** Format: uri */
             href?: string;
             meta: components["schemas"]["External_Link_Meta"];
         };
@@ -23880,7 +24301,10 @@ export interface components {
         };
         /** @description Upload link */
         File_Upload_Link: {
-            /** @description Href to upload actual file to */
+            /**
+             * Format: uri
+             * @description Href to upload actual file to
+             */
             href: string;
             meta: components["schemas"]["File_Upload_Link_Meta"];
         };
@@ -24117,6 +24541,10 @@ export interface components {
             data: components["schemas"]["Folders_Resource_Object"];
             links: components["schemas"]["Links"];
         };
+        /** @description The viewer is followed by the subject. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        FollowedBy: Record<string, never>;
+        /** @description The viewer follows the subject. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        Following: Record<string, never>;
         Genres_Attributes: {
             /**
              * @description Genre name
@@ -24173,7 +24601,9 @@ export interface components {
                 status: string;
             }[];
         };
-        Included: (components["schemas"]["AcceptedTerms_Resource_Object"] | components["schemas"]["AlbumStatistics_Resource_Object"] | components["schemas"]["Albums_Resource_Object"] | components["schemas"]["Appreciations_Resource_Object"] | components["schemas"]["ArtistBiographies_Resource_Object"] | components["schemas"]["ArtistClaimStatuses_Resource_Object"] | components["schemas"]["ArtistClaims_Resource_Object"] | components["schemas"]["ArtistRoles_Resource_Object"] | components["schemas"]["Artists_Resource_Object"] | components["schemas"]["Artworks_Resource_Object"] | components["schemas"]["ChangeEventStreams_Resource_Object"] | components["schemas"]["Clients_Resource_Object"] | components["schemas"]["CollaborationInviteRedemptions_Resource_Object"] | components["schemas"]["CollaborationInvites_Resource_Object"] | components["schemas"]["Comments_Resource_Object"] | components["schemas"]["ContentClaims_Resource_Object"] | components["schemas"]["Credits_Resource_Object"] | components["schemas"]["Downloads_Resource_Object"] | components["schemas"]["DspSharingLinks_Resource_Object"] | components["schemas"]["DynamicModules_Resource_Object"] | components["schemas"]["DynamicPages_Resource_Object"] | components["schemas"]["FolderItems_Resource_Object"] | components["schemas"]["Folders_Resource_Object"] | components["schemas"]["Genres_Resource_Object"] | components["schemas"]["Installations_Resource_Object"] | components["schemas"]["Lyrics_Resource_Object"] | components["schemas"]["ManualArtistClaims_Resource_Object"] | components["schemas"]["OfflineTasks_Resource_Object"] | components["schemas"]["PlayQueues_Resource_Object"] | components["schemas"]["PlaylistGenerationSchedules_Resource_Object"] | components["schemas"]["PlaylistGenerations_Resource_Object"] | components["schemas"]["Playlists_Resource_Object"] | components["schemas"]["PriceConfigurations_Resource_Object"] | components["schemas"]["ProviderOwners_Resource_Object"] | components["schemas"]["ProviderProductInfos_Resource_Object"] | components["schemas"]["Providers_Resource_Object"] | components["schemas"]["Purchases_Resource_Object"] | components["schemas"]["Reactions_Resource_Object"] | components["schemas"]["SavedShares_Resource_Object"] | components["schemas"]["Scopes_Resource_Object"] | components["schemas"]["SearchHistoryEntries_Resource_Object"] | components["schemas"]["SearchResults_Resource_Object"] | components["schemas"]["SearchSuggestions_Resource_Object"] | components["schemas"]["Shares_Resource_Object"] | components["schemas"]["SquareConnections_Resource_Object"] | components["schemas"]["SquareSites_Resource_Object"] | components["schemas"]["StripeConnections_Resource_Object"] | components["schemas"]["StripeDashboardLinks_Resource_Object"] | components["schemas"]["SubscriptionPriceChangeDecisions_Resource_Object"] | components["schemas"]["TemporaryUserTokens_Resource_Object"] | components["schemas"]["Terms_Resource_Object"] | components["schemas"]["TrackFiles_Resource_Object"] | components["schemas"]["TrackManifests_Resource_Object"] | components["schemas"]["TrackSourceFiles_Resource_Object"] | components["schemas"]["TrackStatistics_Resource_Object"] | components["schemas"]["Tracks_Resource_Object"] | components["schemas"]["TracksMetadataStatus_Resource_Object"] | components["schemas"]["UsageRules_Resource_Object"] | components["schemas"]["UserCollectionAlbums_Resource_Object"] | components["schemas"]["UserCollectionArtists_Resource_Object"] | components["schemas"]["UserCollectionFolders_Resource_Object"] | components["schemas"]["UserCollectionPlaylists_Resource_Object"] | components["schemas"]["UserCollectionSaveForLaters_Resource_Object"] | components["schemas"]["UserCollectionTracks_Resource_Object"] | components["schemas"]["UserCollectionVideos_Resource_Object"] | components["schemas"]["UserDailyMixes_Resource_Object"] | components["schemas"]["UserDataExportRequests_Resource_Object"] | components["schemas"]["UserDiscoveryMixes_Resource_Object"] | components["schemas"]["UserNewReleaseMixes_Resource_Object"] | components["schemas"]["UserOfflineMixes_Resource_Object"] | components["schemas"]["UserPlaybackStates_Resource_Object"] | components["schemas"]["UserRecommendationBlocks_Resource_Object"] | components["schemas"]["UserReports_Resource_Object"] | components["schemas"]["UserSubscriptionPriceChanges_Resource_Object"] | components["schemas"]["Users_Resource_Object"] | components["schemas"]["VideoManifests_Resource_Object"] | components["schemas"]["Videos_Resource_Object"])[];
+        /** @description The viewer has the original subject in their normal collection. Present as an empty object when known present, otherwise omitted. Includes owned and saved playlists and saved mixes across folders; excludes Save for Later. */
+        InCollection: Record<string, never>;
+        Included: (components["schemas"]["AcceptedTerms_Resource_Object"] | components["schemas"]["AlbumStatistics_Resource_Object"] | components["schemas"]["Albums_Resource_Object"] | components["schemas"]["Appreciations_Resource_Object"] | components["schemas"]["ArtistBiographies_Resource_Object"] | components["schemas"]["ArtistClaimStatuses_Resource_Object"] | components["schemas"]["ArtistClaims_Resource_Object"] | components["schemas"]["ArtistRoles_Resource_Object"] | components["schemas"]["Artists_Resource_Object"] | components["schemas"]["Artworks_Resource_Object"] | components["schemas"]["ChangeEventStreams_Resource_Object"] | components["schemas"]["Clients_Resource_Object"] | components["schemas"]["CollaborationInviteRedemptions_Resource_Object"] | components["schemas"]["CollaborationInvites_Resource_Object"] | components["schemas"]["Comments_Resource_Object"] | components["schemas"]["ContentClaims_Resource_Object"] | components["schemas"]["Credits_Resource_Object"] | components["schemas"]["Downloads_Resource_Object"] | components["schemas"]["DspSharingLinks_Resource_Object"] | components["schemas"]["DynamicModules_Resource_Object"] | components["schemas"]["DynamicPages_Resource_Object"] | components["schemas"]["FolderItems_Resource_Object"] | components["schemas"]["Folders_Resource_Object"] | components["schemas"]["Genres_Resource_Object"] | components["schemas"]["Installations_Resource_Object"] | components["schemas"]["Lyrics_Resource_Object"] | components["schemas"]["ManualArtistClaims_Resource_Object"] | components["schemas"]["OfflineTasks_Resource_Object"] | components["schemas"]["PlayQueues_Resource_Object"] | components["schemas"]["PlaylistGenerationSchedules_Resource_Object"] | components["schemas"]["PlaylistGenerations_Resource_Object"] | components["schemas"]["Playlists_Resource_Object"] | components["schemas"]["PriceConfigurations_Resource_Object"] | components["schemas"]["ProviderOwners_Resource_Object"] | components["schemas"]["ProviderProductInfos_Resource_Object"] | components["schemas"]["Providers_Resource_Object"] | components["schemas"]["Purchases_Resource_Object"] | components["schemas"]["Reactions_Resource_Object"] | components["schemas"]["SavedShares_Resource_Object"] | components["schemas"]["Scopes_Resource_Object"] | components["schemas"]["SearchHistoryEntries_Resource_Object"] | components["schemas"]["SearchResults_Resource_Object"] | components["schemas"]["SearchSuggestions_Resource_Object"] | components["schemas"]["Shares_Resource_Object"] | components["schemas"]["SquareConnections_Resource_Object"] | components["schemas"]["SquareSites_Resource_Object"] | components["schemas"]["StripeConnections_Resource_Object"] | components["schemas"]["StripeDashboardLinks_Resource_Object"] | components["schemas"]["SubscriptionPriceChangeDecisions_Resource_Object"] | components["schemas"]["TemporaryUserTokens_Resource_Object"] | components["schemas"]["Terms_Resource_Object"] | components["schemas"]["TrackFiles_Resource_Object"] | components["schemas"]["TrackManifests_Resource_Object"] | components["schemas"]["TrackSourceFiles_Resource_Object"] | components["schemas"]["TrackStatistics_Resource_Object"] | components["schemas"]["Tracks_Resource_Object"] | components["schemas"]["TracksMetadataStatus_Resource_Object"] | components["schemas"]["UsageRules_Resource_Object"] | components["schemas"]["UserCollectionAlbums_Resource_Object"] | components["schemas"]["UserCollectionArtists_Resource_Object"] | components["schemas"]["UserCollectionFolders_Resource_Object"] | components["schemas"]["UserCollectionPlaylists_Resource_Object"] | components["schemas"]["UserCollectionSaveForLaters_Resource_Object"] | components["schemas"]["UserCollectionTracks_Resource_Object"] | components["schemas"]["UserCollectionVideos_Resource_Object"] | components["schemas"]["UserDailyMixes_Resource_Object"] | components["schemas"]["UserDataExportRequests_Resource_Object"] | components["schemas"]["UserDiscoveryMixes_Resource_Object"] | components["schemas"]["UserNewReleaseMixes_Resource_Object"] | components["schemas"]["UserOfflineMixes_Resource_Object"] | components["schemas"]["UserPlaybackStates_Resource_Object"] | components["schemas"]["UserRecommendationBlocks_Resource_Object"] | components["schemas"]["UserReports_Resource_Object"] | components["schemas"]["UserSubscriptionPriceChanges_Resource_Object"] | components["schemas"]["Users_Resource_Object"] | components["schemas"]["VideoManifests_Resource_Object"] | components["schemas"]["Videos_Resource_Object"] | components["schemas"]["ViewerContexts_Resource_Object"])[];
         InstallationsCreateOperation_Payload: {
             data: components["schemas"]["InstallationsCreateOperation_Payload_Data"];
         };
@@ -24442,9 +24872,13 @@ export interface components {
             role?: string;
             selectedAlbums?: string[];
             selectedSingles?: string[];
-            socialLink?: components["schemas"]["Link_Object"];
+            socialLink?: components["schemas"]["ManualArtistClaimsExternalLink"];
             upcs?: string[];
-            websiteOrSocialLink: components["schemas"]["Link_Object"];
+            websiteOrSocialLink: components["schemas"]["ManualArtistClaimsExternalLink"];
+        };
+        ManualArtistClaimsExternalLink: {
+            /** Format: uri */
+            href: string;
         };
         ManualArtistClaims_Attributes: {
             /** @description Accepted terms and conditions */
@@ -24514,6 +24948,14 @@ export interface components {
              */
             type: "manualArtistClaims";
         };
+        /** @description The viewer has current identity-derived membership in the subject; role describes that membership and excludes raw share bearer access. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        Membership: {
+            /**
+             * @description Positive identity-derived membership role; NONE does not represent membership.
+             * @enum {string}
+             */
+            role: "NONE" | "VIEWER" | "COLLABORATOR" | "OWNER";
+        };
         Mutation_Response_Document: {
             links: components["schemas"]["Links"];
             /** @description Non-standard meta information */
@@ -24662,12 +25104,8 @@ export interface components {
         };
         PlayQueuesFutureRelationshipAddOperation_Payload_Data: {
             id: string;
-            meta?: components["schemas"]["PlayQueuesFutureRelationshipAddOperation_Payload_Data_Meta"];
             /** @enum {string} */
-            type: "tracks" | "videos" | "albums" | "playlists";
-        };
-        PlayQueuesFutureRelationshipAddOperation_Payload_Data_Meta: {
-            itemCursor?: string;
+            type: "tracks" | "videos";
         };
         PlayQueuesFutureRelationshipAddOperation_Payload_Meta: {
             /** Format: uuid */
@@ -24676,6 +25114,7 @@ export interface components {
             /** @enum {string} */
             mode: "ADD_TO_FRONT" | "ADD_TO_BACK" | "ADD_BEFORE" | "REPLACE_ALL" | "REPLACE_ALL_AND_CURRENT" | "ADD_TO_FRONT_REPLACE_CURRENT";
             positionBefore?: string;
+            source?: components["schemas"]["PlayQueuesFutureRelationshipSource"];
         };
         PlayQueuesFutureRelationshipRemoveOperation_Payload: {
             data: components["schemas"]["PlayQueuesFutureRelationshipRemoveOperation_Payload_Data"][];
@@ -24689,6 +25128,19 @@ export interface components {
         PlayQueuesFutureRelationshipRemoveOperation_Payload_Data_Meta: {
             itemId: string;
         };
+        /** @description Adds up to 1000 playable items from a relationship page and subsequent pages, reading at most 100 pages. Requires empty data. */
+        PlayQueuesFutureRelationshipSource: {
+            /**
+             * Format: uri-reference
+             * @description API-relative self link of a TIDAL API to-many relationship page.
+             */
+            href: string;
+            /**
+             * Format: int32
+             * @description Zero-based index in the page's complete data array from which to start adding.
+             */
+            startIndex: number;
+        };
         PlayQueuesFutureRelationshipUpdateOperation_Payload: {
             data: components["schemas"]["PlayQueuesFutureRelationshipUpdateOperation_Payload_Data"][];
             meta: components["schemas"]["PlayQueuesFutureRelationshipUpdateOperation_Payload_Meta"];
@@ -25266,7 +25718,7 @@ export interface components {
                  * @example DUPLICATE_ITEMS_IN_PLAYLIST
                  * @enum {string}
                  */
-                code: "DUPLICATE_ITEMS_IN_PLAYLIST" | "IDEMPOTENT_REQUEST_IN_PROGRESS";
+                code: "DUPLICATE_ITEMS_IN_PLAYLIST" | "IDEMPOTENT_REQUEST_IN_PROGRESS" | "TOO_MANY_ITEMS_IN_PLAYLIST";
                 /** @example Playlist already contains one or more requested items */
                 detail?: string;
                 /** @example 409 */
@@ -25510,7 +25962,6 @@ export interface components {
         Playlists_Items_Resource_Identifier_Meta: {
             /** Format: date-time */
             addedAt?: string;
-            itemCursor?: string;
             itemId?: string;
             replacement?: components["schemas"]["Replacement_Provenance"];
         };
@@ -25778,6 +26229,8 @@ export interface components {
             included?: components["schemas"]["Included"];
             links: components["schemas"]["Links"];
         };
+        /** @description The viewer has a current qualifying purchase entitlement. Includes a track covered by its purchased album; excludes subscription access and free downloads. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        Purchased: Record<string, never>;
         Purchases_Attributes: {
             /**
              * Format: date-time
@@ -25839,6 +26292,10 @@ export interface components {
             included?: components["schemas"]["Included"];
             links: components["schemas"]["Links"];
         };
+        /** @description The viewer has a current reaction to the subject, with its emoji. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        Reaction: {
+            emoji: string;
+        };
         /** @description Reaction statistics */
         ReactionStats: {
             /** @description Count of reactions by type */
@@ -25973,6 +26430,8 @@ export interface components {
              */
             type: string;
         };
+        /** @description The viewer has saved the subject for later. Reserved; not currently populated and omitted from responses. Omission does not indicate that the relation is absent. */
+        SavedForLater: Record<string, never>;
         SavedSharesCreateOperation_Payload: {
             data: components["schemas"]["SavedSharesCreateOperation_Payload_Data"];
         };
@@ -27693,6 +28152,19 @@ export interface components {
             /** @enum {string} */
             type: "albums";
         };
+        UserCollectionAlbumsReadMultiDataRelationship403ResponseBody: {
+            errors: {
+                /**
+                 * @example UNAUTHORIZED
+                 * @enum {string}
+                 */
+                code: "UNAUTHORIZED";
+                /** @example filter[query] requires INTERNAL access tier */
+                detail?: string;
+                /** @example 403 */
+                status: string;
+            }[];
+        };
         UserCollectionAlbums_Attributes: {
             /**
              * Format: date-time
@@ -27815,6 +28287,19 @@ export interface components {
             /** @enum {string} */
             type: "artists";
         };
+        UserCollectionArtistsReadMultiDataRelationship403ResponseBody: {
+            errors: {
+                /**
+                 * @example UNAUTHORIZED
+                 * @enum {string}
+                 */
+                code: "UNAUTHORIZED";
+                /** @example filter[query] requires INTERNAL access tier */
+                detail?: string;
+                /** @example 403 */
+                status: string;
+            }[];
+        };
         UserCollectionArtists_Attributes: {
             /**
              * Format: date-time
@@ -28069,6 +28554,19 @@ export interface components {
             /** @enum {string} */
             type: "playlists";
         };
+        UserCollectionPlaylistsReadMultiDataRelationship403ResponseBody: {
+            errors: {
+                /**
+                 * @example UNAUTHORIZED
+                 * @enum {string}
+                 */
+                code: "UNAUTHORIZED";
+                /** @example filter[query] requires INTERNAL access tier */
+                detail?: string;
+                /** @example 403 */
+                status: string;
+            }[];
+        };
         UserCollectionPlaylists_Attributes: {
             /**
              * Format: date-time
@@ -28307,6 +28805,19 @@ export interface components {
             /** @enum {string} */
             type: "tracks";
         };
+        UserCollectionTracksReadMultiDataRelationship403ResponseBody: {
+            errors: {
+                /**
+                 * @example UNAUTHORIZED
+                 * @enum {string}
+                 */
+                code: "UNAUTHORIZED";
+                /** @example filter[query] requires INTERNAL access tier */
+                detail?: string;
+                /** @example 403 */
+                status: string;
+            }[];
+        };
         UserCollectionTracks_Attributes: {
             /**
              * Format: date-time
@@ -28429,6 +28940,19 @@ export interface components {
             /** @enum {string} */
             type: "videos";
         };
+        UserCollectionVideosReadMultiDataRelationship403ResponseBody: {
+            errors: {
+                /**
+                 * @example UNAUTHORIZED
+                 * @enum {string}
+                 */
+                code: "UNAUTHORIZED";
+                /** @example filter[query] requires INTERNAL access tier */
+                detail?: string;
+                /** @example 403 */
+                status: string;
+            }[];
+        };
         UserCollectionVideos_Attributes: {
             /**
              * Format: date-time
@@ -29406,6 +29930,70 @@ export interface components {
             included?: components["schemas"]["Included"];
             links: components["schemas"]["Links"];
         };
+        ViewerContexts_Attributes: {
+            hasCommentedOn?: components["schemas"]["Commented"];
+            hasInCollection?: components["schemas"]["InCollection"];
+            hasPurchased?: components["schemas"]["Purchased"];
+            hasReactedTo?: components["schemas"]["Reaction"];
+            hasSavedForLater?: components["schemas"]["SavedForLater"];
+            isFollowedBy?: components["schemas"]["FollowedBy"];
+            isFollowing?: components["schemas"]["Following"];
+            isMemberOf?: components["schemas"]["Membership"];
+        };
+        ViewerContexts_Multi_Resource_Data_Document: {
+            data: components["schemas"]["ViewerContexts_Resource_Object"][];
+            included?: components["schemas"]["Included"];
+            links: components["schemas"]["Links"];
+        };
+        ViewerContexts_Relationships: {
+            subject?: components["schemas"]["ViewerContexts_Subject_Single_Relationship_Data_Document"];
+            viewer?: components["schemas"]["ViewerContexts_Viewer_Single_Relationship_Data_Document"];
+        };
+        ViewerContexts_Resource_Object: {
+            attributes?: components["schemas"]["ViewerContexts_Attributes"];
+            /**
+             * @description Resource id
+             * @example 12345
+             */
+            id: string;
+            relationships?: components["schemas"]["ViewerContexts_Relationships"];
+            /**
+             * @description Resource type (enum property replaced by openapi-typescript)
+             * @enum {string}
+             */
+            type: "viewerContexts";
+        };
+        ViewerContexts_Single_Resource_Data_Document: {
+            data: components["schemas"]["ViewerContexts_Resource_Object"];
+            included?: components["schemas"]["Included"];
+            links: components["schemas"]["Links"];
+        };
+        ViewerContexts_Subject_Resource_Identifier: {
+            /**
+             * @description Resource id
+             * @example 12345
+             */
+            id: string;
+            meta?: components["schemas"]["ViewerContexts_Subject_Resource_Identifier_Meta"];
+            /**
+             * @description Resource type
+             * @example tracks
+             */
+            type: string;
+        };
+        ViewerContexts_Subject_Resource_Identifier_Meta: {
+            replacement?: components["schemas"]["Replacement_Provenance"];
+        };
+        ViewerContexts_Subject_Single_Relationship_Data_Document: {
+            data?: components["schemas"]["ViewerContexts_Subject_Resource_Identifier"] | (never | null);
+            included?: components["schemas"]["Included"];
+            links: components["schemas"]["Links"];
+        };
+        ViewerContexts_Viewer_Single_Relationship_Data_Document: {
+            data?: components["schemas"]["Resource_Identifier"] | (never | null);
+            included?: components["schemas"]["Included"];
+            links: components["schemas"]["Links"];
+        };
     };
     responses: {
         /** @description Invalid request */
@@ -29579,7 +30167,7 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["PlaylistGenerationsUpdateMultiDataRelationship409ResponseBody"];
             };
         };
-        /** @description Playlist already contains one or more requested items; Request already in progress for this idempotency key */
+        /** @description Playlist already contains one or more requested items; Playlist item limit reached; Request already in progress for this idempotency key */
         PlaylistsAddMultiDataRelationshipWithResponse409Response: {
             headers: {
                 [name: string]: unknown;
@@ -29678,6 +30266,15 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["UserCollectionAlbumsAddMultiDataRelationshipWithResponse409ResponseBody"];
             };
         };
+        /** @description filter[query] requires INTERNAL access tier */
+        UserCollectionAlbumsReadMultiDataRelationship403Response: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/vnd.api+json": components["schemas"]["UserCollectionAlbumsReadMultiDataRelationship403ResponseBody"];
+            };
+        };
         /** @description Collection item limit reached; Collection already contains one or more items; Request already in progress for this idempotency key */
         UserCollectionArtistsAddMultiDataRelationshipWithResponse409Response: {
             headers: {
@@ -29687,6 +30284,15 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["UserCollectionArtistsAddMultiDataRelationshipWithResponse409ResponseBody"];
             };
         };
+        /** @description filter[query] requires INTERNAL access tier */
+        UserCollectionArtistsReadMultiDataRelationship403Response: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/vnd.api+json": components["schemas"]["UserCollectionArtistsReadMultiDataRelationship403ResponseBody"];
+            };
+        };
         /** @description Folder must be empty and owned by you */
         UserCollectionFoldersDeleteResource400Response: {
             headers: {
@@ -29705,6 +30311,15 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["UserCollectionPlaylistsAddMultiDataRelationshipWithResponse409ResponseBody"];
             };
         };
+        /** @description filter[query] requires INTERNAL access tier */
+        UserCollectionPlaylistsReadMultiDataRelationship403Response: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/vnd.api+json": components["schemas"]["UserCollectionPlaylistsReadMultiDataRelationship403ResponseBody"];
+            };
+        };
         /** @description Collection item limit reached; Collection already contains one or more items; Request already in progress for this idempotency key */
         UserCollectionSaveForLatersAddMultiDataRelationshipWithResponse409Response: {
             headers: {
@@ -29723,6 +30338,15 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["UserCollectionTracksAddMultiDataRelationshipWithResponse409ResponseBody"];
             };
         };
+        /** @description filter[query] requires INTERNAL access tier */
+        UserCollectionTracksReadMultiDataRelationship403Response: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/vnd.api+json": components["schemas"]["UserCollectionTracksReadMultiDataRelationship403ResponseBody"];
+            };
+        };
         /** @description Collection item limit reached; Collection already contains one or more items; Request already in progress for this idempotency key */
         UserCollectionVideosAddMultiDataRelationshipWithResponse409Response: {
             headers: {
@@ -29732,6 +30356,15 @@ export interface components {
                 "application/vnd.api+json": components["schemas"]["UserCollectionVideosAddMultiDataRelationshipWithResponse409ResponseBody"];
             };
         };
+        /** @description filter[query] requires INTERNAL access tier */
+        UserCollectionVideosReadMultiDataRelationship403Response: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/vnd.api+json": components["schemas"]["UserCollectionVideosReadMultiDataRelationship403ResponseBody"];
+            };
+        };
         /** @description Recommendation block limit reached; Request already in progress for this idempotency key */
         UserRecommendationBlocksAddMultiDataRelationshipWithResponse409Response: {
             headers: {