TIDAL

TIDAL User Collections API

TIDAL's My Collection — the user's saved albums, artists, tracks, videos, playlists, folders, and save-for-later items. Add, remove, organize into folders, and traverse the collection via JSON:API relationships. Requires collection.read/write scopes.

TIDAL User Collections API is one of 10 APIs that TIDAL publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 6 machine-runnable capabilities that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Users, Collections, Library, and My Collection. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 6 Naftiko capability specs.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.tidal.com/documentation/api-sdk/api-sdk-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/openapi/tidal-user-collections-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-albums.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-artists.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-tracks.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-playlists.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-videos.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/capabilities/user-collections-folders.yaml

OpenAPI Specification

tidal-user-collections-api-openapi.yml Raw ↑ 
openapi: 3.0.1
info:
  title: TIDAL User Collections API
  version: 1.10.14
  description: 'My Collection: the user''s saved albums, artists, playlists, tracks, videos, folders, and save-for-later items.'
  x-source: https://tidal-music.github.io/tidal-api-reference/tidal-api-oas.json
servers:
- url: https://openapi.tidal.com/v2
  description: Production
paths:
  /userCollectionAlbums/{id}:
    get:
      description: Retrieves single userCollectionAlbum by id.
      parameters:
      - description: User collection albums id. Use `me` for the authenticated user's resource
        example: me
        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: items,
          owners'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionAlbums_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 userCollectionAlbum.
      tags:
      - userCollectionAlbums
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionAlbums/{id}/relationships/items:
    delete:
      description: Deletes item(s) from items relationship.
      parameters:
      - description: User collection albums id. Use `me` for the authenticated user's resource
        example: me
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionAlbumsItemsRelationshipRemoveOperation_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 items relationship ("to-many").
      tags:
      - userCollectionAlbums
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      description: Retrieves items relationship.
      parameters:
      - description: User collection albums id. Use `me` for the authenticated user's resource
        example: me
        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: addedAt
            enum:
            - addedAt
            - -addedAt
            - artists.name
            - -artists.name
            - releaseDate
            - -releaseDate
            - title
            - -title
            default: -addedAt
            x-enum-varnames:
            - AddedAtAsc
            - AddedAtDesc
            - ArtistsNameAsc
            - ArtistsNameDesc
            - ReleaseDateAsc
            - ReleaseDateDesc
            - TitleAsc
            - TitleDesc
      - 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: items'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionAlbums_Items_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 items relationship ("to-many").
      tags:
      - userCollectionAlbums
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      description: Adds item(s) to items relationship.
      parameters:
      - description: User collection albums id. Use `me` for the authenticated user's resource
        example: me
        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/UserCollectionAlbumsItemsRelationshipAddOperation_Payload'
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionAlbums_Items_Add_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'
        '409':
          $ref: '#/components/responses/UserCollectionAlbumsAddMultiDataRelationshipWithResponse409Response'
        '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 items relationship ("to-many").
      tags:
      - userCollectionAlbums
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionAlbums/{id}/relationships/owners:
    get:
      description: Retrieves owners relationship.
      parameters:
      - description: User collection albums id. Use `me` for the authenticated user's resource
        example: me
        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/UserCollectionAlbums_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:
      - userCollectionAlbums
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionArtists/{id}:
    get:
      description: Retrieves single userCollectionArtist by id.
      parameters:
      - description: User collection artists id. Use `me` for the authenticated user's resource
        example: me
        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: items,
          owners'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionArtists_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 userCollectionArtist.
      tags:
      - userCollectionArtists
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionArtists/{id}/relationships/items:
    delete:
      description: Deletes item(s) from items relationship.
      parameters:
      - description: User collection artists id. Use `me` for the authenticated user's resource
        example: me
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionArtistsItemsRelationshipRemoveOperation_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 items relationship ("to-many").
      tags:
      - userCollectionArtists
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    get:
      description: Retrieves items relationship.
      parameters:
      - description: User collection artists id. Use `me` for the authenticated user's resource
        example: me
        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: addedAt
            enum:
            - addedAt
            - -addedAt
            - name
            - -name
            default: -addedAt
            x-enum-varnames:
            - AddedAtAsc
            - AddedAtDesc
            - NameAsc
            - NameDesc
      - 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: items'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionArtists_Items_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 items relationship ("to-many").
      tags:
      - userCollectionArtists
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
    post:
      description: Adds item(s) to items relationship.
      parameters:
      - description: User collection artists id. Use `me` for the authenticated user's resource
        example: me
        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/UserCollectionArtistsItemsRelationshipAddOperation_Payload'
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionArtists_Items_Add_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'
        '409':
          $ref: '#/components/responses/UserCollectionArtistsAddMultiDataRelationshipWithResponse409Response'
        '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 items relationship ("to-many").
      tags:
      - userCollectionArtists
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionArtists/{id}/relationships/owners:
    get:
      description: Retrieves owners relationship.
      parameters:
      - description: User collection artists id. Use `me` for the authenticated user's resource
        example: me
        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/UserCollectionArtists_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:
      - userCollectionArtists
      x-path-item-properties:
        required-access-tier: THIRD_PARTY
  /userCollectionFolders:
    get:
      description: Retrieves multiple userCollectionFolders by available filters, or without if applicable.
      parameters:
      - description: 'Allows the client to customize which related resources should be returned. Available options: items,
          owners'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      - description: Folder Id (e.g. `CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX`)
        in: query
        name: filter[id]
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionFolders_Multi_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 multiple userCollectionFolders.
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
    post:
      description: Creates a new userCollectionFolder.
      parameters:
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionFoldersCreateOperation_Payload'
      responses:
        '201':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionFolders_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'
        '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: Create single userCollectionFolder.
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
  /userCollectionFolders/{id}:
    delete:
      description: Deletes existing userCollectionFolder.
      parameters:
      - description: Folder Id
        example: CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      responses:
        '400':
          $ref: '#/components/responses/UserCollectionFoldersDeleteResource400Response'
        '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 single userCollectionFolder.
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
    get:
      description: Retrieves single userCollectionFolder by id.
      parameters:
      - description: Folder Id
        example: CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: 'Allows the client to customize which related resources should be returned. Available options: items,
          owners'
        example: items
        in: query
        name: include
        required: false
        schema:
          type: array
          items:
            type: string
            example: items
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UserCollectionFolders_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 userCollectionFolder.
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
    patch:
      description: Updates existing userCollectionFolder.
      parameters:
      - description: Folder Id
        example: CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionFoldersUpdateOperation_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: Update single userCollectionFolder.
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
  /userCollectionFolders/{id}/relationships/items:
    delete:
      description: Deletes item(s) from items relationship.
      parameters:
      - description: Folder Id
        example: CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX
        in: path
        name: id
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UserCollectionFoldersItemsRelationshipRemoveOperation_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 items relationship ("to-many").
      tags:
      - userCollectionFolders
      x-path-item-properties:
        required-access-tier: INTERNAL
    get:
      description: Retrieves items relationship.
      parameters:
      - description: Folder Id
        example: CBMHXUOuJZgroV2kWpeVLL1I7xdgvF6ocDEGCXov8SZq3WVhrOcOq5pjnGawKX
        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
 

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