songtradr_api_client_ruby 1.12.21

data/docs/UserDTO.md

@@ -0,0 +1,56 @@
+# SongtradrApiClientRuby::UserDTO
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **username** | **String** |  |  |
+| **email_address** | **String** |  |  |
+| **company_name** | **String** |  | [optional] |
+| **is_admin** | **Boolean** |  |  |
+| **full_search_allowed** | **Boolean** |  |  |
+| **voice_search_allowed** | **Boolean** |  |  |
+| **recording_detail_allowed** | **Boolean** |  |  |
+| **artist_detail_allowed** | **Boolean** |  |  |
+| **playlist_prediction_allowed** | **Boolean** |  |  |
+| **widgets_allowed** | **Boolean** |  |  |
+| **signup_allowed** | **Boolean** |  |  |
+| **upload_allowed** | **Boolean** |  |  |
+| **fingerprint_allowed** | **Boolean** |  |  |
+| **audiotagging_allowed** | **Boolean** |  |  |
+| **b2b_allowed** | **Boolean** |  |  |
+| **editor_allowed** | **Boolean** |  |  |
+| **reduced_musical_features** | **Boolean** |  |  |
+| **confirmed** | **Boolean** |  |  |
+| **language** | **String** |  |  |
+| **admin** | **Boolean** |  | [optional] |
+
+## Example
+
+```ruby
+require 'songtradr_api_client_ruby'
+
+instance = SongtradrApiClientRuby::UserDTO.new(
+  username: null,
+  email_address: null,
+  company_name: null,
+  is_admin: null,
+  full_search_allowed: null,
+  voice_search_allowed: null,
+  recording_detail_allowed: null,
+  artist_detail_allowed: null,
+  playlist_prediction_allowed: null,
+  widgets_allowed: null,
+  signup_allowed: null,
+  upload_allowed: null,
+  fingerprint_allowed: null,
+  audiotagging_allowed: null,
+  b2b_allowed: null,
+  editor_allowed: null,
+  reduced_musical_features: null,
+  confirmed: null,
+  language: null,
+  admin: null
+)
+```
+

data/getspec.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "json"
+require 'net/http'
+
+api_response = Net::HTTP.get URI(ENV['SONGTRADR_API'])
+json = JSON.parse api_response
+version = json["info"]["version"]
+ruby_gems_response = Net::HTTP.get_response URI("https://rubygems.org/gems/songtradr_api_client_ruby/versions/#{version}")
+puts ruby_gems_response.code == "404" ? version : "0"

data/git_push.sh

@@ -0,0 +1,57 @@
+#!/bin/sh
+# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
+#
+# Usage example: /bin/sh ./git_push.sh wing328 openapi-petstore-perl "minor update" "gitlab.com"
+
+git_user_id=$1
+git_repo_id=$2
+release_note=$3
+git_host=$4
+
+if [ "$git_host" = "" ]; then
+    git_host="github.com"
+    echo "[INFO] No command line input provided. Set \$git_host to $git_host"
+fi
+
+if [ "$git_user_id" = "" ]; then
+    git_user_id="GIT_USER_ID"
+    echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
+fi
+
+if [ "$git_repo_id" = "" ]; then
+    git_repo_id="GIT_REPO_ID"
+    echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
+fi
+
+if [ "$release_note" = "" ]; then
+    release_note="Minor update"
+    echo "[INFO] No command line input provided. Set \$release_note to $release_note"
+fi
+
+# Initialize the local directory as a Git repository
+git init
+
+# Adds the files in the local repository and stages them for commit.
+git add .
+
+# Commits the tracked changes and prepares them to be pushed to a remote repository.
+git commit -m "$release_note"
+
+# Sets the new remote
+git_remote=$(git remote)
+if [ "$git_remote" = "" ]; then # git remote not defined
+
+    if [ "$GIT_TOKEN" = "" ]; then
+        echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
+        git remote add origin https://${git_host}/${git_user_id}/${git_repo_id}.git
+    else
+        git remote add origin https://${git_user_id}:"${GIT_TOKEN}"@${git_host}/${git_user_id}/${git_repo_id}.git
+    fi
+
+fi
+
+git pull origin master
+
+# Pushes (Forces) the changes in the local repository up to the remote repository
+echo "Git pushing to https://${git_host}/${git_user_id}/${git_repo_id}.git"
+git push origin master 2>&1 | grep -v 'To https'

data/lib/songtradr_api_client_ruby/api/allowed_values_api.rb

@@ -0,0 +1,213 @@
+=begin
+#Songtradr API
+
+#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging.  You can also use the API to manage your account and musicube cloud data.  **Authentication**  1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up.  2. To authenticate, you need to login via the POST /api/v1/user/login endpoint.  3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token.  **Rate Limiting**  The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more.  **Getting Started with auto-tagging**  1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint.  **Getting Started with search**  You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints.  1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
+
+The version of the OpenAPI document: 1.12.21
+Contact: info@songtradr.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 7.0.0-SNAPSHOT
+
+=end
+
+require 'cgi'
+
+module SongtradrApiClientRuby
+  class AllowedValuesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Allowed values for music descriptive parameters to be used in the searchAll endpoint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :response_size Size the response should have. (default to 's')
+    # @return [SearchFilterValuesDTO]
+    def allowed_musical_features(opts = {})
+      data, _status_code, _headers = allowed_musical_features_with_http_info(opts)
+      data
+    end
+
+    # Allowed values for music descriptive parameters to be used in the searchAll endpoint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :response_size Size the response should have. (default to 's')
+    # @return [Array<(SearchFilterValuesDTO, Integer, Hash)>] SearchFilterValuesDTO data, response status code and response headers
+    def allowed_musical_features_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AllowedValuesApi.allowed_musical_features ...'
+      end
+      allowable_values = ["s", "l"]
+      if @api_client.config.client_side_validation && opts[:'response_size'] && !allowable_values.include?(opts[:'response_size'])
+        fail ArgumentError, "invalid value for \"response_size\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/allowedValues/musicalFeatures'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'responseSize'] = opts[:'response_size'] if !opts[:'response_size'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchFilterValuesDTO'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"AllowedValuesApi.allowed_musical_features",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AllowedValuesApi#allowed_musical_features\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Allowed values for genres.
+    # @param genre_type [String] Type of the response should have.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<GenreDTO>]
+    def genres(genre_type, opts = {})
+      data, _status_code, _headers = genres_with_http_info(genre_type, opts)
+      data
+    end
+
+    # Allowed values for genres.
+    # @param genre_type [String] Type of the response should have.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<GenreDTO>, Integer, Hash)>] Array<GenreDTO> data, response status code and response headers
+    def genres_with_http_info(genre_type, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AllowedValuesApi.genres ...'
+      end
+      # verify the required parameter 'genre_type' is set
+      if @api_client.config.client_side_validation && genre_type.nil?
+        fail ArgumentError, "Missing the required parameter 'genre_type' when calling AllowedValuesApi.genres"
+      end
+      # verify enum value
+      allowable_values = ["level1Genre", "level2Genre"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(genre_type)
+        fail ArgumentError, "invalid value for \"genre_type\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/allowedValues/genre'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'genreType'] = genre_type
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<GenreDTO>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"AllowedValuesApi.genres",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AllowedValuesApi#genres\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # All descriptive tags inside of tag-categories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_name Filters tags for one category only 
+    # @return [Array<CategoryMediumDTO>]
+    def tags(opts = {})
+      data, _status_code, _headers = tags_with_http_info(opts)
+      data
+    end
+
+    # All descriptive tags inside of tag-categories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :category_name Filters tags for one category only 
+    # @return [Array<(Array<CategoryMediumDTO>, Integer, Hash)>] Array<CategoryMediumDTO> data, response status code and response headers
+    def tags_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AllowedValuesApi.tags ...'
+      end
+      allowable_values = ["mood", "instrument", "soundFeature", "era", "musicalFeature", "originRegion", "effectAndContext", "formation", "form", "vocals", "energy", "soundGeneration", "tempo", "key", "rhythm", "productionMusicMood"]
+      if @api_client.config.client_side_validation && opts[:'category_name'] && !allowable_values.include?(opts[:'category_name'])
+        fail ArgumentError, "invalid value for \"category_name\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/allowedValues/tag'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'categoryName'] = opts[:'category_name'] if !opts[:'category_name'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<CategoryMediumDTO>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"AllowedValuesApi.tags",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AllowedValuesApi#tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/songtradr_api_client_ruby/api/party_api.rb

@@ -0,0 +1,84 @@
+=begin
+#Songtradr API
+
+#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging.  You can also use the API to manage your account and musicube cloud data.  **Authentication**  1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up.  2. To authenticate, you need to login via the POST /api/v1/user/login endpoint.  3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token.  **Rate Limiting**  The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more.  **Getting Started with auto-tagging**  1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint.  **Getting Started with search**  You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints.  1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
+
+The version of the OpenAPI document: 1.12.21
+Contact: info@songtradr.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 7.0.0-SNAPSHOT
+
+=end
+
+require 'cgi'
+
+module SongtradrApiClientRuby
+  class PartyApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Information on a person, group or company.
+    # @param full_name [String] Full Name of the person, group, company or organisation.
+    # @param [Hash] opts the optional parameters
+    # @return [PartyLargeDTO]
+    def party(full_name, opts = {})
+      data, _status_code, _headers = party_with_http_info(full_name, opts)
+      data
+    end
+
+    # Information on a person, group or company.
+    # @param full_name [String] Full Name of the person, group, company or organisation.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PartyLargeDTO, Integer, Hash)>] PartyLargeDTO data, response status code and response headers
+    def party_with_http_info(full_name, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PartyApi.party ...'
+      end
+      # verify the required parameter 'full_name' is set
+      if @api_client.config.client_side_validation && full_name.nil?
+        fail ArgumentError, "Missing the required parameter 'full_name' when calling PartyApi.party"
+      end
+      # resource path
+      local_var_path = '/api/v1/party'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'fullName'] = full_name
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PartyLargeDTO'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"PartyApi.party",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PartyApi#party\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/songtradr_api_client_ruby/api/playlist_api.rb

@@ -0,0 +1,222 @@
+=begin
+#Songtradr API
+
+#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging.  You can also use the API to manage your account and musicube cloud data.  **Authentication**  1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up.  2. To authenticate, you need to login via the POST /api/v1/user/login endpoint.  3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token.  **Rate Limiting**  The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more.  **Getting Started with auto-tagging**  1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint.  **Getting Started with search**  You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints.  1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
+
+The version of the OpenAPI document: 1.12.21
+Contact: info@songtradr.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 7.0.0-SNAPSHOT
+
+=end
+
+require 'cgi'
+
+module SongtradrApiClientRuby
+  class PlaylistApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # All playlists.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :include_recordings Whether a playlist shall include recordings or not. (default to false)
+    # @option opts [Boolean] :ignore_usages Whether a playlist shall include all songs regardless of their track usages. (default to false)
+    # @option opts [String] :usage_filter_mode Whether a playlist recordings shall include all playlist usages or not. (default to 'any')
+    # @option opts [String] :songtradr_playlist_guid 
+    # @return [Array<PlaylistLargeDTO>]
+    def all_playlists(opts = {})
+      data, _status_code, _headers = all_playlists_with_http_info(opts)
+      data
+    end
+
+    # All playlists.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :include_recordings Whether a playlist shall include recordings or not. (default to false)
+    # @option opts [Boolean] :ignore_usages Whether a playlist shall include all songs regardless of their track usages. (default to false)
+    # @option opts [String] :usage_filter_mode Whether a playlist recordings shall include all playlist usages or not. (default to 'any')
+    # @option opts [String] :songtradr_playlist_guid 
+    # @return [Array<(Array<PlaylistLargeDTO>, Integer, Hash)>] Array<PlaylistLargeDTO> data, response status code and response headers
+    def all_playlists_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlaylistApi.all_playlists ...'
+      end
+      allowable_values = ["any", "all"]
+      if @api_client.config.client_side_validation && opts[:'usage_filter_mode'] && !allowable_values.include?(opts[:'usage_filter_mode'])
+        fail ArgumentError, "invalid value for \"usage_filter_mode\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/playlist'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'includeRecordings'] = opts[:'include_recordings'] if !opts[:'include_recordings'].nil?
+      query_params[:'ignoreUsages'] = opts[:'ignore_usages'] if !opts[:'ignore_usages'].nil?
+      query_params[:'usageFilterMode'] = opts[:'usage_filter_mode'] if !opts[:'usage_filter_mode'].nil?
+      query_params[:'songtradrPlaylistGuid'] = opts[:'songtradr_playlist_guid'] if !opts[:'songtradr_playlist_guid'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<PlaylistLargeDTO>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"PlaylistApi.all_playlists",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlaylistApi#all_playlists\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create and edit playlist.
+    # This endpoint expects always the full amount of information including all recordings.
+    # @param save_playlist_dto [SavePlaylistDTO] 
+    # @param [Hash] opts the optional parameters
+    # @return [Object]
+    def create_or_update_playlist(save_playlist_dto, opts = {})
+      data, _status_code, _headers = create_or_update_playlist_with_http_info(save_playlist_dto, opts)
+      data
+    end
+
+    # Create and edit playlist.
+    # This endpoint expects always the full amount of information including all recordings.
+    # @param save_playlist_dto [SavePlaylistDTO] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def create_or_update_playlist_with_http_info(save_playlist_dto, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlaylistApi.create_or_update_playlist ...'
+      end
+      # verify the required parameter 'save_playlist_dto' is set
+      if @api_client.config.client_side_validation && save_playlist_dto.nil?
+        fail ArgumentError, "Missing the required parameter 'save_playlist_dto' when calling PlaylistApi.create_or_update_playlist"
+      end
+      # resource path
+      local_var_path = '/api/v1/playlist'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(save_playlist_dto)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"PlaylistApi.create_or_update_playlist",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlaylistApi#create_or_update_playlist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete playlist.
+    # @param songtradr_playlist_guid [String] ID of the file that should be deleted.
+    # @param [Hash] opts the optional parameters
+    # @return [Object]
+    def delete_playlist(songtradr_playlist_guid, opts = {})
+      data, _status_code, _headers = delete_playlist_with_http_info(songtradr_playlist_guid, opts)
+      data
+    end
+
+    # Delete playlist.
+    # @param songtradr_playlist_guid [String] ID of the file that should be deleted.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def delete_playlist_with_http_info(songtradr_playlist_guid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlaylistApi.delete_playlist ...'
+      end
+      # verify the required parameter 'songtradr_playlist_guid' is set
+      if @api_client.config.client_side_validation && songtradr_playlist_guid.nil?
+        fail ArgumentError, "Missing the required parameter 'songtradr_playlist_guid' when calling PlaylistApi.delete_playlist"
+      end
+      # resource path
+      local_var_path = '/api/v1/playlist/{songtradrPlaylistGuid}'.sub('{' + 'songtradrPlaylistGuid' + '}', CGI.escape(songtradr_playlist_guid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/hal+json', 'application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"PlaylistApi.delete_playlist",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlaylistApi#delete_playlist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end