songtradr_api_client_ruby 1.17.0 → 1.18.0

data/docs/UserApi.md

@@ -12,9 +12,9 @@ All URIs are relative to *https://api.songtradr.com*
 | [**initiate_user_image_upload**](UserApi.md#initiate_user_image_upload) | **POST** /api/v1/user/file/{name}/initImageUpload | Recognise and upload image. Responds with an object with recognition result. |
 | [**login**](UserApi.md#login) | **POST** /api/v1/user/login | Login to generate a bearer token. |
 | [**me**](UserApi.md#me) | **GET** /api/v1/user/me | Details for a logged-in user |
+| [**prompt_search_user_files**](UserApi.md#prompt_search_user_files) | **GET** /api/v1/user/promptSearch | Files for query. |
 | [**recordings_by_folder_with_taggrams**](UserApi.md#recordings_by_folder_with_taggrams) | **GET** /api/v1/user/folder/{folderName}/taggrams | Timeseries of AI generated moods, musical features and more for recordings in your folder. |
 | [**recordings_by_folder_with_tagstrengths**](UserApi.md#recordings_by_folder_with_tagstrengths) | **GET** /api/v1/user/folder/{folderName}/tagstrengths | Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder. |
-| [**save_playlist**](UserApi.md#save_playlist) | **POST** /api/v1/user/savePlaylist | List, search and create playlist of your own files. |
 | [**sign_up**](UserApi.md#sign_up) | **POST** /api/v1/user/sign-up | Sign up a new user. |
 | [**token**](UserApi.md#token) | **POST** /api/v1/user/token | Generates a new JWT token for the given refresh token |
 | [**update_password**](UserApi.md#update_password) | **POST** /api/v1/user/update-password | Update password by using the password reset token |
@@ -567,11 +567,11 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## recordings_by_folder_with_taggrams
+## prompt_search_user_files
 
-> <Array<RecordingMinimalWithTaggramsDTO>> recordings_by_folder_with_taggrams(folder_name, opts)
+> <FileListDTO> prompt_search_user_files(query)
 
-Timeseries of AI generated moods, musical features and more for recordings in your folder.
+Files for query.
 
 ### Examples
 
@@ -585,43 +585,32 @@ SongtradrApiClientRuby.configure do |config|
 end
 
 api_instance = SongtradrApiClientRuby::UserApi.new
-folder_name = 'Default' # String | Folder name
-opts = {
-  category_name: 'instrument', # String | Show only taggrams for one category.
-  tag_name: 'energetic', # String | Show only taggrams for one tag.
-  genre_name: 'Ska', # String | Show only taggrams for one genre.
-  from_timestamp: 16.0, # Float | Show only taggrams data starting from from this timestamp in seconds.
-  to_timestamp: 32.0, # Float | Show only taggrams data before this timestamp in seconds.
-  fill_with_zero: true, # Boolean | If set to true, empty timeseries are filled with timeseries of 0.0 values.
-  page: 56, # Integer | Zero-based page index (0..N)
-  size: 56, # Integer | The size of the page to be returned
-  sort: ['inner_example'] # Array<String> | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
-}
+query = 'funk, guitar, drums' # String | Query.
 
 begin
-  # Timeseries of AI generated moods, musical features and more for recordings in your folder.
-  result = api_instance.recordings_by_folder_with_taggrams(folder_name, opts)
+  # Files for query.
+  result = api_instance.prompt_search_user_files(query)
   p result
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->recordings_by_folder_with_taggrams: #{e}"
+  puts "Error when calling UserApi->prompt_search_user_files: #{e}"
 end
 ```
 
-#### Using the recordings_by_folder_with_taggrams_with_http_info variant
+#### Using the prompt_search_user_files_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Array<RecordingMinimalWithTaggramsDTO>>, Integer, Hash)> recordings_by_folder_with_taggrams_with_http_info(folder_name, opts)
+> <Array(<FileListDTO>, Integer, Hash)> prompt_search_user_files_with_http_info(query)
 
 ```ruby
 begin
-  # Timeseries of AI generated moods, musical features and more for recordings in your folder.
-  data, status_code, headers = api_instance.recordings_by_folder_with_taggrams_with_http_info(folder_name, opts)
+  # Files for query.
+  data, status_code, headers = api_instance.prompt_search_user_files_with_http_info(query)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Array<RecordingMinimalWithTaggramsDTO>>
+  p data # => <FileListDTO>
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->recordings_by_folder_with_taggrams_with_http_info: #{e}"
+  puts "Error when calling UserApi->prompt_search_user_files_with_http_info: #{e}"
 end
 ```
 
@@ -629,20 +618,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **folder_name** | **String** | Folder name |  |
-| **category_name** | **String** | Show only taggrams for one category. | [optional] |
-| **tag_name** | **String** | Show only taggrams for one tag. | [optional] |
-| **genre_name** | **String** | Show only taggrams for one genre. | [optional] |
-| **from_timestamp** | **Float** | Show only taggrams data starting from from this timestamp in seconds. | [optional] |
-| **to_timestamp** | **Float** | Show only taggrams data before this timestamp in seconds. | [optional] |
-| **fill_with_zero** | **Boolean** | If set to true, empty timeseries are filled with timeseries of 0.0 values. | [optional] |
-| **page** | **Integer** | Zero-based page index (0..N) | [optional][default to 0] |
-| **size** | **Integer** | The size of the page to be returned | [optional][default to 20] |
-| **sort** | [**Array&lt;String&gt;**](String.md) | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. | [optional] |
+| **query** | **String** | Query. |  |
 
 ### Return type
 
-[**Array&lt;RecordingMinimalWithTaggramsDTO&gt;**](RecordingMinimalWithTaggramsDTO.md)
+[**FileListDTO**](FileListDTO.md)
 
 ### Authorization
 
@@ -654,11 +634,11 @@ end
 - **Accept**: application/json
 
 
-## recordings_by_folder_with_tagstrengths
+## recordings_by_folder_with_taggrams
 
-> <Array<RecordingMinimalWithTagstrengthsDTO>> recordings_by_folder_with_tagstrengths(folder_name, opts)
+> <Array<RecordingMinimalWithTaggramsDTO>> recordings_by_folder_with_taggrams(folder_name, opts)
 
-Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
+Timeseries of AI generated moods, musical features and more for recordings in your folder.
 
 ### Examples
 
@@ -677,35 +657,38 @@ opts = {
   category_name: 'instrument', # String | Show only taggrams for one category.
   tag_name: 'energetic', # String | Show only taggrams for one tag.
   genre_name: 'Ska', # String | Show only taggrams for one genre.
+  from_timestamp: 16.0, # Float | Show only taggrams data starting from from this timestamp in seconds.
+  to_timestamp: 32.0, # Float | Show only taggrams data before this timestamp in seconds.
+  fill_with_zero: true, # Boolean | If set to true, empty timeseries are filled with timeseries of 0.0 values.
   page: 56, # Integer | Zero-based page index (0..N)
   size: 56, # Integer | The size of the page to be returned
   sort: ['inner_example'] # Array<String> | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
 }
 
 begin
-  # Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
-  result = api_instance.recordings_by_folder_with_tagstrengths(folder_name, opts)
+  # Timeseries of AI generated moods, musical features and more for recordings in your folder.
+  result = api_instance.recordings_by_folder_with_taggrams(folder_name, opts)
   p result
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->recordings_by_folder_with_tagstrengths: #{e}"
+  puts "Error when calling UserApi->recordings_by_folder_with_taggrams: #{e}"
 end
 ```
 
-#### Using the recordings_by_folder_with_tagstrengths_with_http_info variant
+#### Using the recordings_by_folder_with_taggrams_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Array<RecordingMinimalWithTagstrengthsDTO>>, Integer, Hash)> recordings_by_folder_with_tagstrengths_with_http_info(folder_name, opts)
+> <Array(<Array<RecordingMinimalWithTaggramsDTO>>, Integer, Hash)> recordings_by_folder_with_taggrams_with_http_info(folder_name, opts)
 
 ```ruby
 begin
-  # Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
-  data, status_code, headers = api_instance.recordings_by_folder_with_tagstrengths_with_http_info(folder_name, opts)
+  # Timeseries of AI generated moods, musical features and more for recordings in your folder.
+  data, status_code, headers = api_instance.recordings_by_folder_with_taggrams_with_http_info(folder_name, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Array<RecordingMinimalWithTagstrengthsDTO>>
+  p data # => <Array<RecordingMinimalWithTaggramsDTO>>
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->recordings_by_folder_with_tagstrengths_with_http_info: #{e}"
+  puts "Error when calling UserApi->recordings_by_folder_with_taggrams_with_http_info: #{e}"
 end
 ```
 
@@ -717,13 +700,16 @@ end
 | **category_name** | **String** | Show only taggrams for one category. | [optional] |
 | **tag_name** | **String** | Show only taggrams for one tag. | [optional] |
 | **genre_name** | **String** | Show only taggrams for one genre. | [optional] |
+| **from_timestamp** | **Float** | Show only taggrams data starting from from this timestamp in seconds. | [optional] |
+| **to_timestamp** | **Float** | Show only taggrams data before this timestamp in seconds. | [optional] |
+| **fill_with_zero** | **Boolean** | If set to true, empty timeseries are filled with timeseries of 0.0 values. | [optional] |
 | **page** | **Integer** | Zero-based page index (0..N) | [optional][default to 0] |
 | **size** | **Integer** | The size of the page to be returned | [optional][default to 20] |
 | **sort** | [**Array&lt;String&gt;**](String.md) | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. | [optional] |
 
 ### Return type
 
-[**Array&lt;RecordingMinimalWithTagstrengthsDTO&gt;**](RecordingMinimalWithTagstrengthsDTO.md)
+[**Array&lt;RecordingMinimalWithTaggramsDTO&gt;**](RecordingMinimalWithTaggramsDTO.md)
 
 ### Authorization
 
@@ -735,11 +721,11 @@ end
 - **Accept**: application/json
 
 
-## save_playlist
+## recordings_by_folder_with_tagstrengths
 
-> <FileListDTO> save_playlist(opts)
+> <Array<RecordingMinimalWithTagstrengthsDTO>> recordings_by_folder_with_tagstrengths(folder_name, opts)
 
-List, search and create playlist of your own files.
+Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
 
 ### Examples
 
@@ -753,95 +739,40 @@ SongtradrApiClientRuby.configure do |config|
 end
 
 api_instance = SongtradrApiClientRuby::UserApi.new
+folder_name = 'Default' # String | Folder name
 opts = {
-  isrc: 'USUM71703692', # String | Search for a ISRC
-  contributor: 'Rick Rubin', # String | Search for a name that was involved as any contributor.
-  main_artist: 'The Beatles', # String | Search for a main artist.
-  composer: 'John Cale', # String | Search for a composer.
-  title: 'Highway To Hell', # String | Search for a title.
-  party_and_title: 'The Beatles yesterday', # String | Search for party and title.
-  language: 'en', # String | Search for a language of the lyrics.
-  genre_names: ['inner_example'], # Array<String> | 
-  tag_names: ['inner_example'], # Array<String> | 
-  release_date: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  primary_mood_cluster: 'aggressive', # String | 
-  secondary_mood_cluster: 'aggressive', # String | 
-  tertiary_mood_cluster: 'aggressive', # String | 
-  valence: 'very sad', # String | 
-  arousal: 'very calm', # String | 
-  pleasantness: 'very unpleasant', # String | 
-  engagement: 'very unengaging', # String | 
-  vocals: 'instrumental', # String | 
-  dominant_instrument: 'electric guitar', # String | 
-  secondary_instrument: 'electric guitar', # String | 
-  tertiary_instrument: 'electric guitar', # String | 
-  energy: 'very quiet', # String | 
-  sound_generation: 'acoustic', # String | 
-  tempo: 'very slow', # String | 
-  scale: 'major key', # String | 
-  key: 'C', # String | 
-  rhythm: 'common time', # String | 
-  primary_sound_character: 'aggressive', # String | 
-  timbre: 'very warm', # String | 
-  roughness: 'very clear', # String | 
-  tonality: 'monotonous', # String | 
-  harmony: 'very dissonant', # String | 
-  texture: 'very thin', # String | 
-  groovyness: 'very steady', # String | 
-  space: 'very compact', # String | 
-  production_rating: 'low production quality', # String | 
-  performance_rating: 'low performance quality', # String | 
-  song_rating: 'low song quality', # String | 
-  audience_age: 'Generation Z', # String | 
-  audience_region: 'Australia and New Zealand', # String | 
-  audience_gender: 'male', # String | 
-  origin_decade: 'pre-1950s', # String | 
-  curateability: 'curateable', # String | 
-  use_case: 'background', # String | 
-  channel_suitability: 'Spotify', # String | 
-  similar_to_recording: 'similar_to_recording_example', # String | 
-  create_playlist_with_name: 'PlaylistName', # String | 
-  songtradr_track_id: 'songtradr_track_id_example', # String | 
-  usage_name: 'usage_name_example', # String | 
-  bpm_min: 50, # Integer | Search for a minimal bpm.
-  bpm_max: 210, # Integer | Search for a maximal bpm.
-  name: 'Groove.mp3', # String | Search for a file name.
-  folder: 'defaultFolder', # String | Search for a folder.
-  extension: '.mp3', # String | Search for a file extension.
-  upload_end_time: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  min_upload_end_time: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  max_upload_end_time: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  fingerprint_status: 'done', # String | Search for a fingerprint status.
-  inference_status: 'done', # String | Search for a inference status.
+  category_name: 'instrument', # String | Show only taggrams for one category.
+  tag_name: 'energetic', # String | Show only taggrams for one tag.
+  genre_name: 'Ska', # String | Show only taggrams for one genre.
   page: 56, # Integer | Zero-based page index (0..N)
   size: 56, # Integer | The size of the page to be returned
   sort: ['inner_example'] # Array<String> | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
 }
 
 begin
-  # List, search and create playlist of your own files.
-  result = api_instance.save_playlist(opts)
+  # Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
+  result = api_instance.recordings_by_folder_with_tagstrengths(folder_name, opts)
   p result
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->save_playlist: #{e}"
+  puts "Error when calling UserApi->recordings_by_folder_with_tagstrengths: #{e}"
 end
 ```
 
-#### Using the save_playlist_with_http_info variant
+#### Using the recordings_by_folder_with_tagstrengths_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<FileListDTO>, Integer, Hash)> save_playlist_with_http_info(opts)
+> <Array(<Array<RecordingMinimalWithTagstrengthsDTO>>, Integer, Hash)> recordings_by_folder_with_tagstrengths_with_http_info(folder_name, opts)
 
 ```ruby
 begin
-  # List, search and create playlist of your own files.
-  data, status_code, headers = api_instance.save_playlist_with_http_info(opts)
+  # Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder.
+  data, status_code, headers = api_instance.recordings_by_folder_with_tagstrengths_with_http_info(folder_name, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <FileListDTO>
+  p data # => <Array<RecordingMinimalWithTagstrengthsDTO>>
 rescue SongtradrApiClientRuby::ApiError => e
-  puts "Error when calling UserApi->save_playlist_with_http_info: #{e}"
+  puts "Error when calling UserApi->recordings_by_folder_with_tagstrengths_with_http_info: #{e}"
 end
 ```
 
@@ -849,72 +780,17 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **isrc** | **String** | Search for a ISRC | [optional] |
-| **contributor** | **String** | Search for a name that was involved as any contributor. | [optional] |
-| **main_artist** | **String** | Search for a main artist. | [optional] |
-| **composer** | **String** | Search for a composer. | [optional] |
-| **title** | **String** | Search for a title. | [optional] |
-| **party_and_title** | **String** | Search for party and title. | [optional] |
-| **language** | **String** | Search for a language of the lyrics. | [optional] |
-| **genre_names** | [**Array&lt;String&gt;**](String.md) |  | [optional] |
-| **tag_names** | [**Array&lt;String&gt;**](String.md) |  | [optional] |
-| **release_date** | **Time** |  | [optional] |
-| **primary_mood_cluster** | **String** |  | [optional] |
-| **secondary_mood_cluster** | **String** |  | [optional] |
-| **tertiary_mood_cluster** | **String** |  | [optional] |
-| **valence** | **String** |  | [optional] |
-| **arousal** | **String** |  | [optional] |
-| **pleasantness** | **String** |  | [optional] |
-| **engagement** | **String** |  | [optional] |
-| **vocals** | **String** |  | [optional] |
-| **dominant_instrument** | **String** |  | [optional] |
-| **secondary_instrument** | **String** |  | [optional] |
-| **tertiary_instrument** | **String** |  | [optional] |
-| **energy** | **String** |  | [optional] |
-| **sound_generation** | **String** |  | [optional] |
-| **tempo** | **String** |  | [optional] |
-| **scale** | **String** |  | [optional] |
-| **key** | **String** |  | [optional] |
-| **rhythm** | **String** |  | [optional] |
-| **primary_sound_character** | **String** |  | [optional] |
-| **timbre** | **String** |  | [optional] |
-| **roughness** | **String** |  | [optional] |
-| **tonality** | **String** |  | [optional] |
-| **harmony** | **String** |  | [optional] |
-| **texture** | **String** |  | [optional] |
-| **groovyness** | **String** |  | [optional] |
-| **space** | **String** |  | [optional] |
-| **production_rating** | **String** |  | [optional] |
-| **performance_rating** | **String** |  | [optional] |
-| **song_rating** | **String** |  | [optional] |
-| **audience_age** | **String** |  | [optional] |
-| **audience_region** | **String** |  | [optional] |
-| **audience_gender** | **String** |  | [optional] |
-| **origin_decade** | **String** |  | [optional] |
-| **curateability** | **String** |  | [optional] |
-| **use_case** | **String** |  | [optional] |
-| **channel_suitability** | **String** |  | [optional] |
-| **similar_to_recording** | **String** |  | [optional] |
-| **create_playlist_with_name** | **String** |  | [optional] |
-| **songtradr_track_id** | **String** |  | [optional] |
-| **usage_name** | **String** |  | [optional] |
-| **bpm_min** | **Integer** | Search for a minimal bpm. | [optional] |
-| **bpm_max** | **Integer** | Search for a maximal bpm. | [optional] |
-| **name** | **String** | Search for a file name. | [optional] |
-| **folder** | **String** | Search for a folder. | [optional] |
-| **extension** | **String** | Search for a file extension. | [optional] |
-| **upload_end_time** | **Time** |  | [optional] |
-| **min_upload_end_time** | **Time** |  | [optional] |
-| **max_upload_end_time** | **Time** |  | [optional] |
-| **fingerprint_status** | **String** | Search for a fingerprint status. | [optional] |
-| **inference_status** | **String** | Search for a inference status. | [optional] |
+| **folder_name** | **String** | Folder name |  |
+| **category_name** | **String** | Show only taggrams for one category. | [optional] |
+| **tag_name** | **String** | Show only taggrams for one tag. | [optional] |
+| **genre_name** | **String** | Show only taggrams for one genre. | [optional] |
 | **page** | **Integer** | Zero-based page index (0..N) | [optional][default to 0] |
-| **size** | **Integer** | The size of the page to be returned | [optional][default to 100] |
+| **size** | **Integer** | The size of the page to be returned | [optional][default to 20] |
 | **sort** | [**Array&lt;String&gt;**](String.md) | Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. | [optional] |
 
 ### Return type
 
-[**FileListDTO**](FileListDTO.md)
+[**Array&lt;RecordingMinimalWithTagstrengthsDTO&gt;**](RecordingMinimalWithTagstrengthsDTO.md)
 
 ### Authorization
 
@@ -1231,9 +1107,9 @@ opts = {
   pleasantness: 'very unpleasant', # String | 
   engagement: 'very unengaging', # String | 
   vocals: 'instrumental', # String | 
-  dominant_instrument: 'electric guitar', # String | 
-  secondary_instrument: 'electric guitar', # String | 
-  tertiary_instrument: 'electric guitar', # String | 
+  dominant_instrument: 'piano', # String | 
+  secondary_instrument: 'piano', # String | 
+  tertiary_instrument: 'piano', # String | 
   energy: 'very quiet', # String | 
   sound_generation: 'acoustic', # String | 
   tempo: 'very slow', # String | 
@@ -1248,6 +1124,7 @@ opts = {
   texture: 'very thin', # String | 
   groovyness: 'very steady', # String | 
   space: 'very compact', # String | 
+  loudness: 'very low', # String | 
   production_rating: 'low production quality', # String | 
   performance_rating: 'low performance quality', # String | 
   song_rating: 'low song quality', # String | 
@@ -1342,6 +1219,7 @@ end
 | **texture** | **String** |  | [optional] |
 | **groovyness** | **String** |  | [optional] |
 | **space** | **String** |  | [optional] |
+| **loudness** | **String** |  | [optional] |
 | **production_rating** | **String** |  | [optional] |
 | **performance_rating** | **String** |  | [optional] |
 | **song_rating** | **String** |  | [optional] |
@@ -1486,9 +1364,9 @@ opts = {
   pleasantness: 'very unpleasant', # String | 
   engagement: 'very unengaging', # String | 
   vocals: 'instrumental', # String | 
-  dominant_instrument: 'electric guitar', # String | 
-  secondary_instrument: 'electric guitar', # String | 
-  tertiary_instrument: 'electric guitar', # String | 
+  dominant_instrument: 'piano', # String | 
+  secondary_instrument: 'piano', # String | 
+  tertiary_instrument: 'piano', # String | 
   energy: 'very quiet', # String | 
   sound_generation: 'acoustic', # String | 
   tempo: 'very slow', # String | 
@@ -1503,6 +1381,7 @@ opts = {
   texture: 'very thin', # String | 
   groovyness: 'very steady', # String | 
   space: 'very compact', # String | 
+  loudness: 'very low', # String | 
   production_rating: 'low production quality', # String | 
   performance_rating: 'low performance quality', # String | 
   song_rating: 'low song quality', # String | 
@@ -1593,6 +1472,7 @@ end
 | **texture** | **String** |  | [optional] |
 | **groovyness** | **String** |  | [optional] |
 | **space** | **String** |  | [optional] |
+| **loudness** | **String** |  | [optional] |
 | **production_rating** | **String** |  | [optional] |
 | **performance_rating** | **String** |  | [optional] |
 | **song_rating** | **String** |  | [optional] |

data/docs/UserDTO.md

@@ -33,6 +33,7 @@
 | **reduced_musical_features** | **Boolean** |  |  |
 | **confirmed** | **Boolean** |  |  |
 | **language** | **String** |  |  |
+| **recording_endpoints_allowed** | **Boolean** |  |  |
 | **admin** | **Boolean** |  | [optional] |
 
 ## Example
@@ -70,6 +71,7 @@ instance = SongtradrApiClientRuby::UserDTO.new(
   reduced_musical_features: null,
   confirmed: null,
   language: null,
+  recording_endpoints_allowed: null,
   admin: null
 )
 ```

data/lib/songtradr_api_client_ruby/api/allowed_values_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
 

data/lib/songtradr_api_client_ruby/api/recording_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
 
@@ -19,6 +19,68 @@ module SongtradrApiClientRuby
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Recordings for query.
+    # @param query [String] Query.
+    # @param [Hash] opts the optional parameters
+    # @return [RecordingListDTO]
+    def prompt_search_recordings(query, opts = {})
+      data, _status_code, _headers = prompt_search_recordings_with_http_info(query, opts)
+      data
+    end
+
+    # Recordings for query.
+    # @param query [String] Query.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RecordingListDTO, Integer, Hash)>] RecordingListDTO data, response status code and response headers
+    def prompt_search_recordings_with_http_info(query, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RecordingApi.prompt_search_recordings ...'
+      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 RecordingApi.prompt_search_recordings"
+      end
+      # resource path
+      local_var_path = '/api/v1/public/recording/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] || 'RecordingListDTO'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"RecordingApi.prompt_search_recordings",
+        :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: RecordingApi#prompt_search_recordings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # AI generated moods, musical features and more for recordings.
     # @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
     # @param [Hash] opts the optional parameters
@@ -180,7 +242,7 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && ids.nil?
         fail ArgumentError, "Missing the required parameter 'ids' when calling RecordingApi.recordings_by_ids_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
@@ -257,7 +319,7 @@ module SongtradrApiClientRuby
       if @api_client.config.client_side_validation && ids.nil?
         fail ArgumentError, "Missing the required parameter 'ids' when calling RecordingApi.recordings_by_ids_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
@@ -405,6 +467,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture Search for texture.
     # @option opts [String] :groovyness Search for groovyness.
     # @option opts [String] :space Search for space.
+    # @option opts [String] :loudness Search for loudness.
     # @option opts [String] :origin_decade Search for origin decade.
     # @option opts [String] :curateability Search for curateability.
     # @option opts [String] :use_case Search for use case.
@@ -453,6 +516,7 @@ module SongtradrApiClientRuby
     # @option opts [String] :texture Search for texture.
     # @option opts [String] :groovyness Search for groovyness.
     # @option opts [String] :space Search for space.
+    # @option opts [String] :loudness Search for loudness.
     # @option opts [String] :origin_decade Search for origin decade.
     # @option opts [String] :curateability Search for curateability.
     # @option opts [String] :use_case Search for use case.
@@ -497,7 +561,7 @@ 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
@@ -557,6 +621,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 = ["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}"
@@ -615,6 +683,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[:'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?