songtradr_api_client_ruby 1.17.0 → 1.18.0

data/lib/songtradr_api_client_ruby/api/user_api.rb

@@ -3,10 +3,10 @@
 
 #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.17.0
+The version of the OpenAPI document: 1.18.0
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 7.3.0-SNAPSHOT
+OpenAPI Generator version: 7.4.0-SNAPSHOT
 
 =end
 
@@ -544,6 +544,68 @@ module SongtradrApiClientRuby
       return data, status_code, headers
     end
 
+    # Files for query.
+    # @param query [String] Query.
+    # @param [Hash] opts the optional parameters
+    # @return [FileListDTO]
+    def prompt_search_user_files(query, opts = {})
+      data, _status_code, _headers = prompt_search_user_files_with_http_info(query, opts)
+      data
+    end
+
+    # Files for query.
+    # @param query [String] Query.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FileListDTO, Integer, Hash)>] FileListDTO data, response status code and response headers
+    def prompt_search_user_files_with_http_info(query, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UserApi.prompt_search_user_files ...'
+      end
+      # verify the required parameter 'query' is set
+      if @api_client.config.client_side_validation && query.nil?
+        fail ArgumentError, "Missing the required parameter 'query' when calling UserApi.prompt_search_user_files"
+      end
+      # resource path
+      local_var_path = '/api/v1/user/promptSearch'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'query'] = query
+
+      # 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] || 'FileListDTO'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"UserApi.prompt_search_user_files",
+        :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: UserApi#prompt_search_user_files\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Timeseries of AI generated moods, musical features and more for recordings in your folder.
     # @param folder_name [String] Folder name
     # @param [Hash] opts the optional parameters
@@ -583,7 +645,7 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && folder_name.nil?
         fail ArgumentError, "Missing the required parameter 'folder_name' when calling UserApi.recordings_by_folder_with_taggrams"
       end
-      allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre"]
+      allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre", "curateability", "useCase", "channelSuitability", "industrySuitability", "loudness"]
       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
@@ -669,7 +731,7 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && folder_name.nil?
         fail ArgumentError, "Missing the required parameter 'folder_name' when calling UserApi.recordings_by_folder_with_tagstrengths"
       end
-      allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre"]
+      allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre", "curateability", "useCase", "channelSuitability", "industrySuitability", "loudness"]
       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
@@ -719,399 +781,6 @@ module SongtradrApiClientRuby
       return data, status_code, headers
     end
 
-    # List, search and create playlist of your own files.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :isrc Search for a ISRC
-    # @option opts [String] :contributor Search for a name that was involved as any contributor.
-    # @option opts [String] :main_artist Search for a main artist.
-    # @option opts [String] :composer Search for a composer.
-    # @option opts [String] :title Search for a title.
-    # @option opts [String] :party_and_title Search for party and title.
-    # @option opts [String] :language Search for a language of the lyrics.
-    # @option opts [Array<String>] :genre_names 
-    # @option opts [Array<String>] :tag_names 
-    # @option opts [Time] :release_date 
-    # @option opts [String] :primary_mood_cluster 
-    # @option opts [String] :secondary_mood_cluster 
-    # @option opts [String] :tertiary_mood_cluster 
-    # @option opts [String] :valence 
-    # @option opts [String] :arousal 
-    # @option opts [String] :pleasantness 
-    # @option opts [String] :engagement 
-    # @option opts [String] :vocals 
-    # @option opts [String] :dominant_instrument 
-    # @option opts [String] :secondary_instrument 
-    # @option opts [String] :tertiary_instrument 
-    # @option opts [String] :energy 
-    # @option opts [String] :sound_generation 
-    # @option opts [String] :tempo 
-    # @option opts [String] :scale 
-    # @option opts [String] :key 
-    # @option opts [String] :rhythm 
-    # @option opts [String] :primary_sound_character 
-    # @option opts [String] :timbre 
-    # @option opts [String] :roughness 
-    # @option opts [String] :tonality 
-    # @option opts [String] :harmony 
-    # @option opts [String] :texture 
-    # @option opts [String] :groovyness 
-    # @option opts [String] :space 
-    # @option opts [String] :production_rating 
-    # @option opts [String] :performance_rating 
-    # @option opts [String] :song_rating 
-    # @option opts [String] :audience_age 
-    # @option opts [String] :audience_region 
-    # @option opts [String] :audience_gender 
-    # @option opts [String] :origin_decade 
-    # @option opts [String] :curateability 
-    # @option opts [String] :use_case 
-    # @option opts [String] :channel_suitability 
-    # @option opts [String] :similar_to_recording 
-    # @option opts [String] :create_playlist_with_name 
-    # @option opts [String] :songtradr_track_id 
-    # @option opts [String] :usage_name 
-    # @option opts [Integer] :bpm_min Search for a minimal bpm.
-    # @option opts [Integer] :bpm_max Search for a maximal bpm.
-    # @option opts [String] :name Search for a file name.
-    # @option opts [String] :folder Search for a folder.
-    # @option opts [String] :extension Search for a file extension.
-    # @option opts [Time] :upload_end_time 
-    # @option opts [Time] :min_upload_end_time 
-    # @option opts [Time] :max_upload_end_time 
-    # @option opts [String] :fingerprint_status Search for a fingerprint status.
-    # @option opts [String] :inference_status Search for a inference status.
-    # @option opts [Integer] :page Zero-based page index (0..N) (default to 0)
-    # @option opts [Integer] :size The size of the page to be returned (default to 100)
-    # @option opts [Array<String>] :sort Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
-    # @return [FileListDTO]
-    def save_playlist(opts = {})
-      data, _status_code, _headers = save_playlist_with_http_info(opts)
-      data
-    end
-
-    # List, search and create playlist of your own files.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :isrc Search for a ISRC
-    # @option opts [String] :contributor Search for a name that was involved as any contributor.
-    # @option opts [String] :main_artist Search for a main artist.
-    # @option opts [String] :composer Search for a composer.
-    # @option opts [String] :title Search for a title.
-    # @option opts [String] :party_and_title Search for party and title.
-    # @option opts [String] :language Search for a language of the lyrics.
-    # @option opts [Array<String>] :genre_names 
-    # @option opts [Array<String>] :tag_names 
-    # @option opts [Time] :release_date 
-    # @option opts [String] :primary_mood_cluster 
-    # @option opts [String] :secondary_mood_cluster 
-    # @option opts [String] :tertiary_mood_cluster 
-    # @option opts [String] :valence 
-    # @option opts [String] :arousal 
-    # @option opts [String] :pleasantness 
-    # @option opts [String] :engagement 
-    # @option opts [String] :vocals 
-    # @option opts [String] :dominant_instrument 
-    # @option opts [String] :secondary_instrument 
-    # @option opts [String] :tertiary_instrument 
-    # @option opts [String] :energy 
-    # @option opts [String] :sound_generation 
-    # @option opts [String] :tempo 
-    # @option opts [String] :scale 
-    # @option opts [String] :key 
-    # @option opts [String] :rhythm 
-    # @option opts [String] :primary_sound_character 
-    # @option opts [String] :timbre 
-    # @option opts [String] :roughness 
-    # @option opts [String] :tonality 
-    # @option opts [String] :harmony 
-    # @option opts [String] :texture 
-    # @option opts [String] :groovyness 
-    # @option opts [String] :space 
-    # @option opts [String] :production_rating 
-    # @option opts [String] :performance_rating 
-    # @option opts [String] :song_rating 
-    # @option opts [String] :audience_age 
-    # @option opts [String] :audience_region 
-    # @option opts [String] :audience_gender 
-    # @option opts [String] :origin_decade 
-    # @option opts [String] :curateability 
-    # @option opts [String] :use_case 
-    # @option opts [String] :channel_suitability 
-    # @option opts [String] :similar_to_recording 
-    # @option opts [String] :create_playlist_with_name 
-    # @option opts [String] :songtradr_track_id 
-    # @option opts [String] :usage_name 
-    # @option opts [Integer] :bpm_min Search for a minimal bpm.
-    # @option opts [Integer] :bpm_max Search for a maximal bpm.
-    # @option opts [String] :name Search for a file name.
-    # @option opts [String] :folder Search for a folder.
-    # @option opts [String] :extension Search for a file extension.
-    # @option opts [Time] :upload_end_time 
-    # @option opts [Time] :min_upload_end_time 
-    # @option opts [Time] :max_upload_end_time 
-    # @option opts [String] :fingerprint_status Search for a fingerprint status.
-    # @option opts [String] :inference_status Search for a inference status.
-    # @option opts [Integer] :page Zero-based page index (0..N) (default to 0)
-    # @option opts [Integer] :size The size of the page to be returned (default to 100)
-    # @option opts [Array<String>] :sort Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
-    # @return [Array<(FileListDTO, Integer, Hash)>] FileListDTO data, response status code and response headers
-    def save_playlist_with_http_info(opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: UserApi.save_playlist ...'
-      end
-      allowable_values = ["en", "es", "fr", "de", "jp", "cn", "IT", "RU"]
-      if @api_client.config.client_side_validation && opts[:'language'] && !allowable_values.include?(opts[:'language'])
-        fail ArgumentError, "invalid value for \"language\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["aggressive", "amusing", "anxious", "calm", "devotional", "dreamy", "energetic", "enigmatic", "epic", "erotic", "positive", "sad", "scary", "wild"]
-      if @api_client.config.client_side_validation && opts[:'primary_mood_cluster'] && !allowable_values.include?(opts[:'primary_mood_cluster'])
-        fail ArgumentError, "invalid value for \"primary_mood_cluster\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["aggressive", "amusing", "anxious", "calm", "devotional", "dreamy", "energetic", "enigmatic", "epic", "erotic", "positive", "sad", "scary", "wild"]
-      if @api_client.config.client_side_validation && opts[:'secondary_mood_cluster'] && !allowable_values.include?(opts[:'secondary_mood_cluster'])
-        fail ArgumentError, "invalid value for \"secondary_mood_cluster\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["aggressive", "amusing", "anxious", "calm", "devotional", "dreamy", "energetic", "enigmatic", "epic", "erotic", "positive", "sad", "scary", "wild"]
-      if @api_client.config.client_side_validation && opts[:'tertiary_mood_cluster'] && !allowable_values.include?(opts[:'tertiary_mood_cluster'])
-        fail ArgumentError, "invalid value for \"tertiary_mood_cluster\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very sad", "sad", "moderate valence", "positive", "very positive", "varying valence"]
-      if @api_client.config.client_side_validation && opts[:'valence'] && !allowable_values.include?(opts[:'valence'])
-        fail ArgumentError, "invalid value for \"valence\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very calm", "calm", "moderate arousal", "energetic", "very energetic", "varying arousal"]
-      if @api_client.config.client_side_validation && opts[:'arousal'] && !allowable_values.include?(opts[:'arousal'])
-        fail ArgumentError, "invalid value for \"arousal\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very unpleasant", "unpleasant", "neutral pleasantness", "pleasant", "very pleasant", "varying pleasantness"]
-      if @api_client.config.client_side_validation && opts[:'pleasantness'] && !allowable_values.include?(opts[:'pleasantness'])
-        fail ArgumentError, "invalid value for \"pleasantness\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very unengaging", "unengaging", "neutral engagement", "engaging", "very engaging", "varying engagement"]
-      if @api_client.config.client_side_validation && opts[:'engagement'] && !allowable_values.include?(opts[:'engagement'])
-        fail ArgumentError, "invalid value for \"engagement\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["instrumental", "female vocals", "male vocals", "mixed vocals", "diverse gender vocals"]
-      if @api_client.config.client_side_validation && opts[:'vocals'] && !allowable_values.include?(opts[:'vocals'])
-        fail ArgumentError, "invalid value for \"vocals\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
-      if @api_client.config.client_side_validation && opts[:'dominant_instrument'] && !allowable_values.include?(opts[:'dominant_instrument'])
-        fail ArgumentError, "invalid value for \"dominant_instrument\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
-      if @api_client.config.client_side_validation && opts[:'secondary_instrument'] && !allowable_values.include?(opts[:'secondary_instrument'])
-        fail ArgumentError, "invalid value for \"secondary_instrument\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
-      if @api_client.config.client_side_validation && opts[:'tertiary_instrument'] && !allowable_values.include?(opts[:'tertiary_instrument'])
-        fail ArgumentError, "invalid value for \"tertiary_instrument\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very quiet", "quiet", "moderate", "loud", "very loud", "dynamic"]
-      if @api_client.config.client_side_validation && opts[:'energy'] && !allowable_values.include?(opts[:'energy'])
-        fail ArgumentError, "invalid value for \"energy\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["acoustic", "electric", "electronic", "mixed sound generation"]
-      if @api_client.config.client_side_validation && opts[:'sound_generation'] && !allowable_values.include?(opts[:'sound_generation'])
-        fail ArgumentError, "invalid value for \"sound_generation\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very slow", "slow", "mid-tempo", "fast", "very fast", "varying tempo"]
-      if @api_client.config.client_side_validation && opts[:'tempo'] && !allowable_values.include?(opts[:'tempo'])
-        fail ArgumentError, "invalid value for \"tempo\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["major key", "minor key", "neutral key"]
-      if @api_client.config.client_side_validation && opts[:'scale'] && !allowable_values.include?(opts[:'scale'])
-        fail ArgumentError, "invalid value for \"scale\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B", "unclear"]
-      if @api_client.config.client_side_validation && opts[:'key'] && !allowable_values.include?(opts[:'key'])
-        fail ArgumentError, "invalid value for \"key\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["common time", "triple meter", "complex time signature", "binary rhythm", "ternary rhythm"]
-      if @api_client.config.client_side_validation && opts[:'rhythm'] && !allowable_values.include?(opts[:'rhythm'])
-        fail ArgumentError, "invalid value for \"rhythm\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["aggressive", "amusing", "anxious", "calm", "devotional", "dreamy", "energetic", "enigmatic", "epic", "erotic", "positive", "sad", "scary", "wild"]
-      if @api_client.config.client_side_validation && opts[:'primary_sound_character'] && !allowable_values.include?(opts[:'primary_sound_character'])
-        fail ArgumentError, "invalid value for \"primary_sound_character\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very warm", "warm", "moderate timbre", "bright", "very bright"]
-      if @api_client.config.client_side_validation && opts[:'timbre'] && !allowable_values.include?(opts[:'timbre'])
-        fail ArgumentError, "invalid value for \"timbre\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very clear", "clear", "moderate roughness", "distorted", "very distorted"]
-      if @api_client.config.client_side_validation && opts[:'roughness'] && !allowable_values.include?(opts[:'roughness'])
-        fail ArgumentError, "invalid value for \"roughness\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["monotonous", "moderate melodiousness", "melodious", "atonal"]
-      if @api_client.config.client_side_validation && opts[:'tonality'] && !allowable_values.include?(opts[:'tonality'])
-        fail ArgumentError, "invalid value for \"tonality\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very dissonant", "dissonant", "moderate harmonies", "harmonious", "very harmonious"]
-      if @api_client.config.client_side_validation && opts[:'harmony'] && !allowable_values.include?(opts[:'harmony'])
-        fail ArgumentError, "invalid value for \"harmony\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very thin", "thin", "moderate texture", "full", "very full"]
-      if @api_client.config.client_side_validation && opts[:'texture'] && !allowable_values.include?(opts[:'texture'])
-        fail ArgumentError, "invalid value for \"texture\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very steady", "steady", "moderate rhythm feel", "groovy", "very groovy"]
-      if @api_client.config.client_side_validation && opts[:'groovyness'] && !allowable_values.include?(opts[:'groovyness'])
-        fail ArgumentError, "invalid value for \"groovyness\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["very compact", "compact", "moderate space", "wide", "very wide"]
-      if @api_client.config.client_side_validation && opts[:'space'] && !allowable_values.include?(opts[:'space'])
-        fail ArgumentError, "invalid value for \"space\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["low production quality", "medium production quality", "high production quality"]
-      if @api_client.config.client_side_validation && opts[:'production_rating'] && !allowable_values.include?(opts[:'production_rating'])
-        fail ArgumentError, "invalid value for \"production_rating\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["low performance quality", "medium performance quality", "high performance quality"]
-      if @api_client.config.client_side_validation && opts[:'performance_rating'] && !allowable_values.include?(opts[:'performance_rating'])
-        fail ArgumentError, "invalid value for \"performance_rating\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["low song quality", "medium song quality", "high song quality"]
-      if @api_client.config.client_side_validation && opts[:'song_rating'] && !allowable_values.include?(opts[:'song_rating'])
-        fail ArgumentError, "invalid value for \"song_rating\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["Generation Z", "Younger Generation Y", "Older Generation Y", "Generation X", "Younger Generation B", "Older Generation B"]
-      if @api_client.config.client_side_validation && opts[:'audience_age'] && !allowable_values.include?(opts[:'audience_age'])
-        fail ArgumentError, "invalid value for \"audience_age\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["Australia and New Zealand", "Central America and the Carribean", "Central and Southern Asia", "Eastern Asia", "Eastern Europe", "Northern Africa and Western Asia", "Northern America", "Oceania", "South America", "South-Eastern Asia", "Southern Europe", "Sub-Saharan Africa", "Western and Northern Europe"]
-      if @api_client.config.client_side_validation && opts[:'audience_region'] && !allowable_values.include?(opts[:'audience_region'])
-        fail ArgumentError, "invalid value for \"audience_region\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["male", "female"]
-      if @api_client.config.client_side_validation && opts[:'audience_gender'] && !allowable_values.include?(opts[:'audience_gender'])
-        fail ArgumentError, "invalid value for \"audience_gender\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["pre-1950s", "1950s", "1960s", "1970s", "1980s", "1990s", "2000s", "2010s", "2020s"]
-      if @api_client.config.client_side_validation && opts[:'origin_decade'] && !allowable_values.include?(opts[:'origin_decade'])
-        fail ArgumentError, "invalid value for \"origin_decade\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["curateable", "uncurateable"]
-      if @api_client.config.client_side_validation && opts[:'curateability'] && !allowable_values.include?(opts[:'curateability'])
-        fail ArgumentError, "invalid value for \"curateability\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["background", "sport", "focus", "christmas", "film", "summer", "adverts", "party", "relax", "karaoke"]
-      if @api_client.config.client_side_validation && opts[:'use_case'] && !allowable_values.include?(opts[:'use_case'])
-        fail ArgumentError, "invalid value for \"use_case\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["Spotify", "TikTok", "Unfitting", "YouTube"]
-      if @api_client.config.client_side_validation && opts[:'channel_suitability'] && !allowable_values.include?(opts[:'channel_suitability'])
-        fail ArgumentError, "invalid value for \"channel_suitability\", must be one of #{allowable_values}"
-      end
-      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] < 0
-        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling UserApi.save_playlist, must be greater than or equal to 0.'
-      end
-
-      if @api_client.config.client_side_validation && !opts[:'size'].nil? && opts[:'size'] < 1
-        fail ArgumentError, 'invalid value for "opts[:"size"]" when calling UserApi.save_playlist, must be greater than or equal to 1.'
-      end
-
-      # resource path
-      local_var_path = '/api/v1/user/savePlaylist'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-      query_params[:'ISRC'] = opts[:'isrc'] if !opts[:'isrc'].nil?
-      query_params[:'contributor'] = opts[:'contributor'] if !opts[:'contributor'].nil?
-      query_params[:'mainArtist'] = opts[:'main_artist'] if !opts[:'main_artist'].nil?
-      query_params[:'composer'] = opts[:'composer'] if !opts[:'composer'].nil?
-      query_params[:'title'] = opts[:'title'] if !opts[:'title'].nil?
-      query_params[:'partyAndTitle'] = opts[:'party_and_title'] if !opts[:'party_and_title'].nil?
-      query_params[:'language'] = opts[:'language'] if !opts[:'language'].nil?
-      query_params[:'genreNames'] = @api_client.build_collection_param(opts[:'genre_names'], :multi) if !opts[:'genre_names'].nil?
-      query_params[:'tagNames'] = @api_client.build_collection_param(opts[:'tag_names'], :multi) if !opts[:'tag_names'].nil?
-      query_params[:'releaseDate'] = opts[:'release_date'] if !opts[:'release_date'].nil?
-      query_params[:'primaryMoodCluster'] = opts[:'primary_mood_cluster'] if !opts[:'primary_mood_cluster'].nil?
-      query_params[:'secondaryMoodCluster'] = opts[:'secondary_mood_cluster'] if !opts[:'secondary_mood_cluster'].nil?
-      query_params[:'tertiaryMoodCluster'] = opts[:'tertiary_mood_cluster'] if !opts[:'tertiary_mood_cluster'].nil?
-      query_params[:'valence'] = opts[:'valence'] if !opts[:'valence'].nil?
-      query_params[:'arousal'] = opts[:'arousal'] if !opts[:'arousal'].nil?
-      query_params[:'pleasantness'] = opts[:'pleasantness'] if !opts[:'pleasantness'].nil?
-      query_params[:'engagement'] = opts[:'engagement'] if !opts[:'engagement'].nil?
-      query_params[:'vocals'] = opts[:'vocals'] if !opts[:'vocals'].nil?
-      query_params[:'dominantInstrument'] = opts[:'dominant_instrument'] if !opts[:'dominant_instrument'].nil?
-      query_params[:'secondaryInstrument'] = opts[:'secondary_instrument'] if !opts[:'secondary_instrument'].nil?
-      query_params[:'tertiaryInstrument'] = opts[:'tertiary_instrument'] if !opts[:'tertiary_instrument'].nil?
-      query_params[:'energy'] = opts[:'energy'] if !opts[:'energy'].nil?
-      query_params[:'soundGeneration'] = opts[:'sound_generation'] if !opts[:'sound_generation'].nil?
-      query_params[:'tempo'] = opts[:'tempo'] if !opts[:'tempo'].nil?
-      query_params[:'scale'] = opts[:'scale'] if !opts[:'scale'].nil?
-      query_params[:'key'] = opts[:'key'] if !opts[:'key'].nil?
-      query_params[:'rhythm'] = opts[:'rhythm'] if !opts[:'rhythm'].nil?
-      query_params[:'primarySoundCharacter'] = opts[:'primary_sound_character'] if !opts[:'primary_sound_character'].nil?
-      query_params[:'timbre'] = opts[:'timbre'] if !opts[:'timbre'].nil?
-      query_params[:'roughness'] = opts[:'roughness'] if !opts[:'roughness'].nil?
-      query_params[:'tonality'] = opts[:'tonality'] if !opts[:'tonality'].nil?
-      query_params[:'harmony'] = opts[:'harmony'] if !opts[:'harmony'].nil?
-      query_params[:'texture'] = opts[:'texture'] if !opts[:'texture'].nil?
-      query_params[:'groovyness'] = opts[:'groovyness'] if !opts[:'groovyness'].nil?
-      query_params[:'space'] = opts[:'space'] if !opts[:'space'].nil?
-      query_params[:'productionRating'] = opts[:'production_rating'] if !opts[:'production_rating'].nil?
-      query_params[:'performanceRating'] = opts[:'performance_rating'] if !opts[:'performance_rating'].nil?
-      query_params[:'songRating'] = opts[:'song_rating'] if !opts[:'song_rating'].nil?
-      query_params[:'audienceAge'] = opts[:'audience_age'] if !opts[:'audience_age'].nil?
-      query_params[:'audienceRegion'] = opts[:'audience_region'] if !opts[:'audience_region'].nil?
-      query_params[:'audienceGender'] = opts[:'audience_gender'] if !opts[:'audience_gender'].nil?
-      query_params[:'originDecade'] = opts[:'origin_decade'] if !opts[:'origin_decade'].nil?
-      query_params[:'curateability'] = opts[:'curateability'] if !opts[:'curateability'].nil?
-      query_params[:'useCase'] = opts[:'use_case'] if !opts[:'use_case'].nil?
-      query_params[:'channelSuitability'] = opts[:'channel_suitability'] if !opts[:'channel_suitability'].nil?
-      query_params[:'similarToRecording'] = opts[:'similar_to_recording'] if !opts[:'similar_to_recording'].nil?
-      query_params[:'createPlaylistWithName'] = opts[:'create_playlist_with_name'] if !opts[:'create_playlist_with_name'].nil?
-      query_params[:'songtradrTrackId'] = opts[:'songtradr_track_id'] if !opts[:'songtradr_track_id'].nil?
-      query_params[:'usageName'] = opts[:'usage_name'] if !opts[:'usage_name'].nil?
-      query_params[:'bpmMin'] = opts[:'bpm_min'] if !opts[:'bpm_min'].nil?
-      query_params[:'bpmMax'] = opts[:'bpm_max'] if !opts[:'bpm_max'].nil?
-      query_params[:'name'] = opts[:'name'] if !opts[:'name'].nil?
-      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
-      query_params[:'extension'] = opts[:'extension'] if !opts[:'extension'].nil?
-      query_params[:'uploadEndTime'] = opts[:'upload_end_time'] if !opts[:'upload_end_time'].nil?
-      query_params[:'minUploadEndTime'] = opts[:'min_upload_end_time'] if !opts[:'min_upload_end_time'].nil?
-      query_params[:'maxUploadEndTime'] = opts[:'max_upload_end_time'] if !opts[:'max_upload_end_time'].nil?
-      query_params[:'fingerprintStatus'] = opts[:'fingerprint_status'] if !opts[:'fingerprint_status'].nil?
-      query_params[:'inferenceStatus'] = opts[:'inference_status'] if !opts[:'inference_status'].nil?
-      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
-      query_params[:'size'] = opts[:'size'] if !opts[:'size'].nil?
-      query_params[:'sort'] = @api_client.build_collection_param(opts[:'sort'], :multi) if !opts[:'sort'].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] || 'FileListDTO'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
-
-      new_options = opts.merge(
-        :operation => :"UserApi.save_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: UserApi#save_playlist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Sign up a new user.
     # @param save_user_dto [SaveUserDTO] 
     # @param [Hash] opts the optional parameters
@@ -1408,6 +1077,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture 
     # @option opts [String] :groovyness 
     # @option opts [String] :space 
+    # @option opts [String] :loudness 
     # @option opts [String] :production_rating 
     # @option opts [String] :performance_rating 
     # @option opts [String] :song_rating 
@@ -1477,6 +1147,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture 
     # @option opts [String] :groovyness 
     # @option opts [String] :space 
+    # @option opts [String] :loudness 
     # @option opts [String] :production_rating 
     # @option opts [String] :performance_rating 
     # @option opts [String] :song_rating 
@@ -1544,15 +1215,15 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && opts[:'vocals'] && !allowable_values.include?(opts[:'vocals'])
         fail ArgumentError, "invalid value for \"vocals\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'dominant_instrument'] && !allowable_values.include?(opts[:'dominant_instrument'])
         fail ArgumentError, "invalid value for \"dominant_instrument\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'secondary_instrument'] && !allowable_values.include?(opts[:'secondary_instrument'])
         fail ArgumentError, "invalid value for \"secondary_instrument\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'tertiary_instrument'] && !allowable_values.include?(opts[:'tertiary_instrument'])
         fail ArgumentError, "invalid value for \"tertiary_instrument\", must be one of #{allowable_values}"
       end
@@ -1612,6 +1283,10 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && opts[:'space'] && !allowable_values.include?(opts[:'space'])
         fail ArgumentError, "invalid value for \"space\", must be one of #{allowable_values}"
       end
+      allowable_values = ["very low", "low", "moderate", "high", "very high"]
+      if @api_client.config.client_side_validation && opts[:'loudness'] && !allowable_values.include?(opts[:'loudness'])
+        fail ArgumentError, "invalid value for \"loudness\", must be one of #{allowable_values}"
+      end
       allowable_values = ["low production quality", "medium production quality", "high production quality"]
       if @api_client.config.client_side_validation && opts[:'production_rating'] && !allowable_values.include?(opts[:'production_rating'])
         fail ArgumentError, "invalid value for \"production_rating\", must be one of #{allowable_values}"
@@ -1700,6 +1375,7 @@ module SongtradrApiClientRuby
       query_params[:'texture'] = opts[:'texture'] if !opts[:'texture'].nil?
       query_params[:'groovyness'] = opts[:'groovyness'] if !opts[:'groovyness'].nil?
       query_params[:'space'] = opts[:'space'] if !opts[:'space'].nil?
+      query_params[:'loudness'] = opts[:'loudness'] if !opts[:'loudness'].nil?
       query_params[:'productionRating'] = opts[:'production_rating'] if !opts[:'production_rating'].nil?
       query_params[:'performanceRating'] = opts[:'performance_rating'] if !opts[:'performance_rating'].nil?
       query_params[:'songRating'] = opts[:'song_rating'] if !opts[:'song_rating'].nil?
@@ -1859,6 +1535,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture 
     # @option opts [String] :groovyness 
     # @option opts [String] :space 
+    # @option opts [String] :loudness 
     # @option opts [String] :production_rating 
     # @option opts [String] :performance_rating 
     # @option opts [String] :song_rating 
@@ -1924,6 +1601,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture 
     # @option opts [String] :groovyness 
     # @option opts [String] :space 
+    # @option opts [String] :loudness 
     # @option opts [String] :production_rating 
     # @option opts [String] :performance_rating 
     # @option opts [String] :song_rating 
@@ -1988,15 +1666,15 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && opts[:'vocals'] && !allowable_values.include?(opts[:'vocals'])
         fail ArgumentError, "invalid value for \"vocals\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'dominant_instrument'] && !allowable_values.include?(opts[:'dominant_instrument'])
         fail ArgumentError, "invalid value for \"dominant_instrument\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'secondary_instrument'] && !allowable_values.include?(opts[:'secondary_instrument'])
         fail ArgumentError, "invalid value for \"secondary_instrument\", must be one of #{allowable_values}"
       end
-      allowable_values = ["electric guitar", "piano", "electronics", "guitar", "strings", "synthesizer", "wind", "saxophone", "flute", "trumpet", "drum kit", "keys", "accordion", "violin", "harpsichord", "choir", "cello", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
+      allowable_values = ["piano", "electronics", "guitar", "strings", "synthesizer", "wind", "drum kit", "keys", "harpsichord", "choir", "electric bass", "organ", "brass", "percussion", "vocals", "double bass", "harp"]
       if @api_client.config.client_side_validation && opts[:'tertiary_instrument'] && !allowable_values.include?(opts[:'tertiary_instrument'])
         fail ArgumentError, "invalid value for \"tertiary_instrument\", must be one of #{allowable_values}"
       end
@@ -2056,6 +1734,10 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && opts[:'space'] && !allowable_values.include?(opts[:'space'])
         fail ArgumentError, "invalid value for \"space\", must be one of #{allowable_values}"
       end
+      allowable_values = ["very low", "low", "moderate", "high", "very high"]
+      if @api_client.config.client_side_validation && opts[:'loudness'] && !allowable_values.include?(opts[:'loudness'])
+        fail ArgumentError, "invalid value for \"loudness\", must be one of #{allowable_values}"
+      end
       allowable_values = ["low production quality", "medium production quality", "high production quality"]
       if @api_client.config.client_side_validation && opts[:'production_rating'] && !allowable_values.include?(opts[:'production_rating'])
         fail ArgumentError, "invalid value for \"production_rating\", must be one of #{allowable_values}"
@@ -2135,6 +1817,7 @@ module SongtradrApiClientRuby
       query_params[:'texture'] = opts[:'texture'] if !opts[:'texture'].nil?
       query_params[:'groovyness'] = opts[:'groovyness'] if !opts[:'groovyness'].nil?
       query_params[:'space'] = opts[:'space'] if !opts[:'space'].nil?
+      query_params[:'loudness'] = opts[:'loudness'] if !opts[:'loudness'].nil?
       query_params[:'productionRating'] = opts[:'production_rating'] if !opts[:'production_rating'].nil?
       query_params[:'performanceRating'] = opts[:'performance_rating'] if !opts[:'performance_rating'].nil?
       query_params[:'songRating'] = opts[:'song_rating'] if !opts[:'song_rating'].nil?