TIDAL userCollections API

The userCollections API from TIDAL — 7 operation(s) for usercollections.

OpenAPI Specification

tidal-usercollections-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  title: TIDAL Catalog acceptedTerms userCollections API
  version: 1.10.14
  description: 'Browse TIDAL''s high-fidelity music catalog: albums, artists, tracks, videos, genres, lyrics, credits, and artwork. JSON:API compliant with relationship traversal.'
  x-source: https://tidal-music.github.io/tidal-api-reference/tidal-api-oas.json
servers:
- url: https://openapi.tidal.com/v2
  description: Production
tags:
- name: userCollections
paths:
  /userCollections/{id}:
    get:
      deprecated: true
      description: 'Deprecated. Use the dedicated collection resources instead: userCollectionAlbums, userCollectionArtists, userCollectionTracks, userCollectionVideos, or userCollectionPlaylists.'
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - description: BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
        example: en-US
        in: query
        name: locale
        required: false
        schema:
          type: string
          default: en-US
      - description: 'Allows the client to customize which related resources should be returned. Available options: albums, artists, owners, playlists, tracks, videos'
        example: albums
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: albums
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Single_Resource_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get single userCollection.
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/albums:
    delete:
      deprecated: true
      description: Deprecated. Use the userCollectionAlbums resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsAlbumsRelationshipRemoveOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/Idempotency409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Delete from albums relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      deprecated: true
      description: Deprecated. Use the userCollectionAlbums resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified
        in: query
        name: page[cursor]
        required: false
        schema:
          type: string
      - description: Values prefixed with "-" are sorted descending; values without it are sorted ascending.
        in: query
        name: sort
        required: false
        schema:
          type: array
          items:
            type: string
            example: albums.addedAt
            enum:
            - albums.addedAt
            - -albums.addedAt
            - albums.artists.name
            - -albums.artists.name
            - albums.releaseDate
            - -albums.releaseDate
            - albums.title
            - -albums.title
            default: -albums.addedAt
            x-enum-varnames:
            - AlbumsAddedAtAsc
            - AlbumsAddedAtDesc
            - AlbumsArtistsNameAsc
            - AlbumsArtistsNameDesc
            - AlbumsReleaseDateAsc
            - AlbumsReleaseDateDesc
            - AlbumsTitleAsc
            - AlbumsTitleDesc
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - description: BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
        example: en-US
        in: query
        name: locale
        required: false
        schema:
          type: string
          default: en-US
      - description: 'Allows the client to customize which related resources should be returned. Available options: albums'
        example: albums
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: albums
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Albums_Multi_Relationship_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get albums relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      deprecated: true
      description: Deprecated. Use the userCollectionAlbums resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsAlbumsRelationshipAddOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/UserCollectionsAddMultiDataRelationship409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Add to albums relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/artists:
    delete:
      deprecated: true
      description: Deprecated. Use the userCollectionArtists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsArtistsRelationshipRemoveOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/Idempotency409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Delete from artists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      deprecated: true
      description: Deprecated. Use the userCollectionArtists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified
        in: query
        name: page[cursor]
        required: false
        schema:
          type: string
      - description: Values prefixed with "-" are sorted descending; values without it are sorted ascending.
        in: query
        name: sort
        required: false
        schema:
          type: array
          items:
            type: string
            example: artists.addedAt
            enum:
            - artists.addedAt
            - -artists.addedAt
            - artists.name
            - -artists.name
            default: -artists.addedAt
            x-enum-varnames:
            - ArtistsAddedAtAsc
            - ArtistsAddedAtDesc
            - ArtistsNameAsc
            - ArtistsNameDesc
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - description: BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
        example: en-US
        in: query
        name: locale
        required: false
        schema:
          type: string
          default: en-US
      - description: 'Allows the client to customize which related resources should be returned. Available options: artists'
        example: artists
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: artists
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Artists_Multi_Relationship_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get artists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      deprecated: true
      description: Deprecated. Use the userCollectionArtists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsArtistsRelationshipAddOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/UserCollectionsAddMultiDataRelationship409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Add to artists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/owners:
    get:
      description: Retrieves owners relationship.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: 'Allows the client to customize which related resources should be returned. Available options: owners'
        example: owners
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: owners
      - description: Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified
        in: query
        name: page[cursor]
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Multi_Relationship_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get owners relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/playlists:
    delete:
      deprecated: true
      description: Deprecated. Use the userCollectionPlaylists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsPlaylistsRelationshipRemoveOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/Idempotency409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Delete from playlists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      deprecated: true
      description: Deprecated. Use the userCollectionPlaylists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - in: query
        name: collectionView
        required: false
        schema:
          type: string
          enum:
          - FOLDERS
      - description: Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified
        in: query
        name: page[cursor]
        required: false
        schema:
          type: string
      - description: Values prefixed with "-" are sorted descending; values without it are sorted ascending.
        in: query
        name: sort
        required: false
        schema:
          type: array
          items:
            type: string
            example: playlists.addedAt
            enum:
            - playlists.addedAt
            - -playlists.addedAt
            - playlists.lastUpdatedAt
            - -playlists.lastUpdatedAt
            - playlists.name
            - -playlists.name
            default: -playlists.addedAt
            x-enum-varnames:
            - PlaylistsAddedAtAsc
            - PlaylistsAddedAtDesc
            - PlaylistsLastUpdatedAtAsc
            - PlaylistsLastUpdatedAtDesc
            - PlaylistsNameAsc
            - PlaylistsNameDesc
      - description: 'Allows the client to customize which related resources should be returned. Available options: playlists'
        example: playlists
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: playlists
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Playlists_Multi_Relationship_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get playlists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      deprecated: true
      description: Deprecated. Use the userCollectionPlaylists resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsPlaylistsRelationshipAddOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/UserCollectionsAddMultiDataRelationship409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Add to playlists relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/tracks:
    delete:
      deprecated: true
      description: Deprecated. Use the userCollectionTracks resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsTracksRelationshipRemoveOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/Idempotency409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Delete from tracks relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      deprecated: true
      description: Deprecated. Use the userCollectionTracks resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified
        in: query
        name: page[cursor]
        required: false
        schema:
          type: string
      - description: Values prefixed with "-" are sorted descending; values without it are sorted ascending.
        in: query
        name: sort
        required: false
        schema:
          type: array
          items:
            type: string
            example: tracks.addedAt
            enum:
            - tracks.addedAt
            - -tracks.addedAt
            - tracks.albums.title
            - -tracks.albums.title
            - tracks.artists.name
            - -tracks.artists.name
            - tracks.duration
            - -tracks.duration
            - tracks.title
            - -tracks.title
            default: -tracks.addedAt
            x-enum-varnames:
            - TracksAddedAtAsc
            - TracksAddedAtDesc
            - TracksAlbumsTitleAsc
            - TracksAlbumsTitleDesc
            - TracksArtistsNameAsc
            - TracksArtistsNameDesc
            - TracksDurationAsc
            - TracksDurationDesc
            - TracksTitleAsc
            - TracksTitleDesc
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - description: BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
        example: en-US
        in: query
        name: locale
        required: false
        schema:
          type: string
          default: en-US
      - description: 'Allows the client to customize which related resources should be returned. Available options: tracks'
        example: tracks
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: tracks
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollections_Tracks_Multi_Relationship_Data_Document'
          description: Successful response
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.read
        - r_usr
      summary: Get tracks relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      deprecated: true
      description: Deprecated. Use the userCollectionTracks resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: ISO 3166-1 alpha-2 country code
        example: US
        in: query
        name: countryCode
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsTracksRelationshipAddOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/UserCollectionsAddMultiDataRelationship409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Add to tracks relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollections/{id}/relationships/videos:
    delete:
      deprecated: true
      description: Deprecated. Use the userCollectionVideos resource and its items relationship instead.
      parameters:
      - description: User collection id
        example: '123456'
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionsVideosRelationshipRemoveOperation_Payload'
      responses:
        '400':
          $ref: '#/components/responses/Default400Response'
        '404':
          $ref: '#/components/responses/Default404Response'
        '405':
          $ref: '#/components/responses/Default405Response'
        '406':
          $ref: '#/components/responses/Default406Response'
        '409':
          $ref: '#/components/responses/Idempotency409Response'
        '415':
          $ref: '#/components/responses/Default415Response'
        '422':
          $ref: '#/components/responses/Idempotency422Response'
        '429':
          $ref: '#/components/responses/Default429Response'
        '500':
          $ref: '#/components/responses/Default500Response'
        '503':
          $ref: '#/components/responses/Default503Response'
      security:
      - Authorization_Code_PKCE:
        - collection.write
        - w_usr
      summary: Delete from videos relationship ("to-many").
      tags:
      - userCollections
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
    

# --- truncated at 32 KB (178 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/openapi/tidal-usercollections-api-openapi.yml