{
  "opencollection": "1.0.0",
  "info": {
    "name": "TIDAL Catalog acceptedTerms userCollections API",
    "version": "1.10.14"
  },
  "items": [
    {
      "info": {
        "name": "userCollections",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get single userCollection.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              },
              {
                "name": "locale",
                "value": "en-US",
                "type": "query",
                "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported."
              },
              {
                "name": "include",
                "value": "albums",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: albums, artists, owners, playlists, tracks, videos"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the dedicated collection resources instead: userCollectionAlbums, userCollectionArtists, userCollectionTracks, userCollectionVideos, or userCollectionPlaylists."
        },
        {
          "info": {
            "name": "Get albums relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/albums",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending."
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              },
              {
                "name": "locale",
                "value": "en-US",
                "type": "query",
                "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported."
              },
              {
                "name": "include",
                "value": "albums",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: albums"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionAlbums resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Add to albums relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/albums",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionAlbums resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Delete from albums relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/albums",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionAlbums resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Get artists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/artists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending."
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              },
              {
                "name": "locale",
                "value": "en-US",
                "type": "query",
                "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported."
              },
              {
                "name": "include",
                "value": "artists",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: artists"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionArtists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Add to artists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/artists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionArtists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Delete from artists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/artists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionArtists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Get owners relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/owners",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "include",
                "value": "owners",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: owners"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Retrieves owners relationship."
        },
        {
          "info": {
            "name": "Get playlists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/playlists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "collectionView",
                "value": "",
                "type": "query"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending."
              },
              {
                "name": "include",
                "value": "playlists",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: playlists"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionPlaylists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Add to playlists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/playlists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionPlaylists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Delete from playlists relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/playlists",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionPlaylists resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Get tracks relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/tracks",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending."
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              },
              {
                "name": "locale",
                "value": "en-US",
                "type": "query",
                "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported."
              },
              {
                "name": "include",
                "value": "tracks",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: tracks"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionTracks resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Add to tracks relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/tracks",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionTracks resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Delete from tracks relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/tracks",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionTracks resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Get videos relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/videos",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending."
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              },
              {
                "name": "locale",
                "value": "en-US",
                "type": "query",
                "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported."
              },
              {
                "name": "include",
                "value": "videos",
                "type": "query",
                "description": "Allows the client to customize which related resources should be returned. Available options: videos"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionVideos resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Add to videos relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/videos",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              },
              {
                "name": "countryCode",
                "value": "US",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionVideos resource and its items relationship instead."
        },
        {
          "info": {
            "name": "Delete from videos relationship (\"to-many\").",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://openapi.tidal.com/v2/userCollections/:id/relationships/videos",
            "params": [
              {
                "name": "id",
                "value": "123456",
                "type": "path",
                "description": "User collection id"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "oauth2",
              "flow": "authorization_code",
              "authorizationUrl": "https://login.tidal.com/authorize",
              "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token",
              "credentials": {
                "clientId": "{{clientId}}",
                "clientSecret": "{{clientSecret}}"
              }
            }
          },
          "docs": "Deprecated. Use the userCollectionVideos resource and its items relationship instead."
        }
      ]
    }
  ],
  "bundled": true
}