songtradr_api_client_ruby 1.13.4 → 1.13.6

data/docs/SaveFileRecordingDTO.md

@@ -114,6 +114,8 @@
 | **proprietary_id_gema** | **String** |  | [optional] |
 | **title** | **String** |  | [optional] |
 | **version_title** | **String** |  | [optional] |
+| **context_kind** | **String** |  | [optional] |
+| **context_value** | [**ContextValue**](ContextValue.md) |  | [optional] |
 
 ## Example
 
@@ -230,7 +232,9 @@ instance = SongtradrApiClientRuby::SaveFileRecordingDTO.new(
   iswc: null,
   proprietary_id_gema: null,
   title: null,
-  version_title: null
+  version_title: null,
+  context_kind: null,
+  context_value: null
 )
 ```
 

data/docs/Smile.md

@@ -0,0 +1,20 @@
+# SongtradrApiClientRuby::Smile
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **value** | **Boolean** |  | [optional] |
+| **confidence** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'songtradr_api_client_ruby'
+
+instance = SongtradrApiClientRuby::Smile.new(
+  value: null,
+  confidence: null
+)
+```
+

data/docs/Sunglasses.md

@@ -0,0 +1,20 @@
+# SongtradrApiClientRuby::Sunglasses
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **value** | **Boolean** |  | [optional] |
+| **confidence** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'songtradr_api_client_ruby'
+
+instance = SongtradrApiClientRuby::Sunglasses.new(
+  value: null,
+  confidence: null
+)
+```
+

data/docs/TagDTO.md

@@ -5,8 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **id** | **Integer** |  |  |
-| **name** | **String** |  |  |
 | **categories** | [**Array<CategoryMinimalDTO>**](CategoryMinimalDTO.md) |  | [optional] |
+| **name** | **String** |  |  |
 
 ## Example
 
@@ -15,8 +15,8 @@ require 'songtradr_api_client_ruby'
 
 instance = SongtradrApiClientRuby::TagDTO.new(
   id: null,
-  name: null,
-  categories: null
+  categories: null,
+  name: null
 )
 ```
 

data/docs/UserApi.md

@@ -8,7 +8,9 @@ All URIs are relative to *https://api.songtradr.com*
 | [**delete_user_file**](UserApi.md#delete_user_file) | **DELETE** /api/v1/user/file/{objectKey} | Delete file. |
 | [**edit_me**](UserApi.md#edit_me) | **POST** /api/v1/user/me | Edit details for a logged-in user |
 | [**forgot_password**](UserApi.md#forgot_password) | **POST** /api/v1/user/forgot-password | Send a password reset email |
+| [**init_video_upload**](UserApi.md#init_video_upload) | **POST** /api/v1/user/file/{name}/initVideoUpload | Recognise and upload video. Responds with an object with recognition result. |
 | [**initiate_user_file_upload**](UserApi.md#initiate_user_file_upload) | **POST** /api/v1/user/file/{name}/initUpload | Initialize a file upload. Responds with an URL where the file can be uploaded. |
+| [**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 |
 | [**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. |
@@ -295,6 +297,75 @@ end
 - **Accept**: application/hal+json, application/json
 
 
+## init_video_upload
+
+> <VideoRecognitionResponse> init_video_upload(name, url)
+
+Recognise and upload video. Responds with an object with recognition result.
+
+### Examples
+
+```ruby
+require 'time'
+require 'songtradr_api_client_ruby'
+# setup authorization
+SongtradrApiClientRuby.configure do |config|
+  # Configure Bearer authorization (JWT): bearer-jwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = SongtradrApiClientRuby::UserApi.new
+name = 'FileName.mp4' # String | The Name of the image that will be uploaded
+url = 'url_example' # String | 
+
+begin
+  # Recognise and upload video. Responds with an object with recognition result.
+  result = api_instance.init_video_upload(name, url)
+  p result
+rescue SongtradrApiClientRuby::ApiError => e
+  puts "Error when calling UserApi->init_video_upload: #{e}"
+end
+```
+
+#### Using the init_video_upload_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<VideoRecognitionResponse>, Integer, Hash)> init_video_upload_with_http_info(name, url)
+
+```ruby
+begin
+  # Recognise and upload video. Responds with an object with recognition result.
+  data, status_code, headers = api_instance.init_video_upload_with_http_info(name, url)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <VideoRecognitionResponse>
+rescue SongtradrApiClientRuby::ApiError => e
+  puts "Error when calling UserApi->init_video_upload_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | The Name of the image that will be uploaded |  |
+| **url** | **String** |  |  |
+
+### Return type
+
+[**VideoRecognitionResponse**](VideoRecognitionResponse.md)
+
+### Authorization
+
+[bearer-jwt](../README.md#bearer-jwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## initiate_user_file_upload
 
 > <InitPutRecordingAudioDTO> initiate_user_file_upload(name, folder, opts)
@@ -368,6 +439,75 @@ end
 - **Accept**: application/json
 
 
+## initiate_user_image_upload
+
+> <ImageRecognitionResponse> initiate_user_image_upload(name, url)
+
+Recognise and upload image. Responds with an object with recognition result.
+
+### Examples
+
+```ruby
+require 'time'
+require 'songtradr_api_client_ruby'
+# setup authorization
+SongtradrApiClientRuby.configure do |config|
+  # Configure Bearer authorization (JWT): bearer-jwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = SongtradrApiClientRuby::UserApi.new
+name = 'FileName.mp3' # String | The Name of the image that will be uploaded
+url = 'url_example' # String | 
+
+begin
+  # Recognise and upload image. Responds with an object with recognition result.
+  result = api_instance.initiate_user_image_upload(name, url)
+  p result
+rescue SongtradrApiClientRuby::ApiError => e
+  puts "Error when calling UserApi->initiate_user_image_upload: #{e}"
+end
+```
+
+#### Using the initiate_user_image_upload_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImageRecognitionResponse>, Integer, Hash)> initiate_user_image_upload_with_http_info(name, url)
+
+```ruby
+begin
+  # Recognise and upload image. Responds with an object with recognition result.
+  data, status_code, headers = api_instance.initiate_user_image_upload_with_http_info(name, url)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImageRecognitionResponse>
+rescue SongtradrApiClientRuby::ApiError => e
+  puts "Error when calling UserApi->initiate_user_image_upload_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | The Name of the image that will be uploaded |  |
+| **url** | **String** |  |  |
+
+### Return type
+
+[**ImageRecognitionResponse**](ImageRecognitionResponse.md)
+
+### Authorization
+
+[bearer-jwt](../README.md#bearer-jwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## login
 
 > <JwtTokenDTO> login(login_dto)

data/docs/VideoRecognitionResponse.md

@@ -0,0 +1,20 @@
+# SongtradrApiClientRuby::VideoRecognitionResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **labels** | [**Array<LabelDetection>**](LabelDetection.md) |  | [optional] |
+| **faces** | [**Array<FaceDetection>**](FaceDetection.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'songtradr_api_client_ruby'
+
+instance = SongtradrApiClientRuby::VideoRecognitionResponse.new(
+  labels: null,
+  faces: null
+)
+```
+

data/lib/songtradr_api_client_ruby/api/allowed_values_api.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT

data/lib/songtradr_api_client_ruby/api/party_api.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT

data/lib/songtradr_api_client_ruby/api/playlist_api.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT
@@ -158,6 +158,83 @@ module SongtradrApiClientRuby
       return data, status_code, headers
     end
 
+    # Curate playlist.
+    # @param method_name [String] Name of the curation task that should be executed
+    # @param curate_playlist_dto [CuratePlaylistDTO] 
+    # @param [Hash] opts the optional parameters
+    # @return [CuratePlaylistResponseDTO]
+    def curate_playlist(method_name, curate_playlist_dto, opts = {})
+      data, _status_code, _headers = curate_playlist_with_http_info(method_name, curate_playlist_dto, opts)
+      data
+    end
+
+    # Curate playlist.
+    # @param method_name [String] Name of the curation task that should be executed
+    # @param curate_playlist_dto [CuratePlaylistDTO] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CuratePlaylistResponseDTO, Integer, Hash)>] CuratePlaylistResponseDTO data, response status code and response headers
+    def curate_playlist_with_http_info(method_name, curate_playlist_dto, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlaylistApi.curate_playlist ...'
+      end
+      # verify the required parameter 'method_name' is set
+      if @api_client.config.client_side_validation && method_name.nil?
+        fail ArgumentError, "Missing the required parameter 'method_name' when calling PlaylistApi.curate_playlist"
+      end
+      # verify enum value
+      allowable_values = ["RECOMMEND", "REPLACE_SIMILAR", "REPLACE_DIFFERENT", "ORDER"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(method_name)
+        fail ArgumentError, "invalid value for \"method_name\", must be one of #{allowable_values}"
+      end
+      # verify the required parameter 'curate_playlist_dto' is set
+      if @api_client.config.client_side_validation && curate_playlist_dto.nil?
+        fail ArgumentError, "Missing the required parameter 'curate_playlist_dto' when calling PlaylistApi.curate_playlist"
+      end
+      # resource path
+      local_var_path = '/api/v1/playlist/{methodName}'.sub('{' + 'methodName' + '}', CGI.escape(method_name.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/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(curate_playlist_dto)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CuratePlaylistResponseDTO'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"PlaylistApi.curate_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#curate_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

data/lib/songtradr_api_client_ruby/api/recording_api.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT

data/lib/songtradr_api_client_ruby/api/user_api.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT
@@ -276,6 +276,74 @@ module SongtradrApiClientRuby
       return data, status_code, headers
     end
 
+    # Recognise and upload video. Responds with an object with recognition result.
+    # @param name [String] The Name of the image that will be uploaded
+    # @param url [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [VideoRecognitionResponse]
+    def init_video_upload(name, url, opts = {})
+      data, _status_code, _headers = init_video_upload_with_http_info(name, url, opts)
+      data
+    end
+
+    # Recognise and upload video. Responds with an object with recognition result.
+    # @param name [String] The Name of the image that will be uploaded
+    # @param url [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(VideoRecognitionResponse, Integer, Hash)>] VideoRecognitionResponse data, response status code and response headers
+    def init_video_upload_with_http_info(name, url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UserApi.init_video_upload ...'
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling UserApi.init_video_upload"
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling UserApi.init_video_upload"
+      end
+      # resource path
+      local_var_path = '/api/v1/user/file/{name}/initVideoUpload'.sub('{' + 'name' + '}', CGI.escape(name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+
+      # 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] || 'VideoRecognitionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"UserApi.init_video_upload",
+        :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#init_video_upload\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Initialize a file upload. Responds with an URL where the file can be uploaded.
     # @param name [String] The Name of the file that will be uploaded
     # @param folder [String] The Name of the folder that the file will be placed in
@@ -351,6 +419,74 @@ module SongtradrApiClientRuby
       return data, status_code, headers
     end
 
+    # Recognise and upload image. Responds with an object with recognition result.
+    # @param name [String] The Name of the image that will be uploaded
+    # @param url [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [ImageRecognitionResponse]
+    def initiate_user_image_upload(name, url, opts = {})
+      data, _status_code, _headers = initiate_user_image_upload_with_http_info(name, url, opts)
+      data
+    end
+
+    # Recognise and upload image. Responds with an object with recognition result.
+    # @param name [String] The Name of the image that will be uploaded
+    # @param url [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ImageRecognitionResponse, Integer, Hash)>] ImageRecognitionResponse data, response status code and response headers
+    def initiate_user_image_upload_with_http_info(name, url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UserApi.initiate_user_image_upload ...'
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling UserApi.initiate_user_image_upload"
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling UserApi.initiate_user_image_upload"
+      end
+      # resource path
+      local_var_path = '/api/v1/user/file/{name}/initImageUpload'.sub('{' + 'name' + '}', CGI.escape(name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+
+      # 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] || 'ImageRecognitionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer-jwt']
+
+      new_options = opts.merge(
+        :operation => :"UserApi.initiate_user_image_upload",
+        :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#initiate_user_image_upload\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Login to generate a bearer token.
     # @param login_dto [LoginDTO] 
     # @param [Hash] opts the optional parameters

data/lib/songtradr_api_client_ruby/api_client.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT
@@ -18,6 +18,7 @@ require 'time'
 require 'faraday'
 require 'faraday/multipart' if Gem::Version.new(Faraday::VERSION) >= Gem::Version.new('2.0')
 
+
 module SongtradrApiClientRuby
   class ApiClient
     # The Configuration object holding settings to be used in the API client.
@@ -258,7 +259,7 @@ module SongtradrApiClientRuby
       return nil if body.nil? || body.empty?
 
       # return response body directly for String return type
-      return body if return_type == 'String'
+      return body.to_s if return_type == 'String'
 
       # ensuring a default content type
       content_type = response.headers['Content-Type'] || 'application/json'

data/lib/songtradr_api_client_ruby/api_error.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT

data/lib/songtradr_api_client_ruby/configuration.rb

@@ -3,7 +3,7 @@
 
 #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.13.4
+The version of the OpenAPI document: 1.13.6
 Contact: info@songtradr.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 7.1.0-SNAPSHOT
@@ -378,5 +378,6 @@ module SongtradrApiClientRuby
         end
       end
     end
+
   end
 end