phrase 2.7.2 → 2.8.1

data/docs/WebhookDeliveriesApi.md

@@ -0,0 +1,206 @@
+# Phrase::WebhookDeliveriesApi
+
+All URIs are relative to *https://api.phrase.com/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**webhook_deliveries_list**](WebhookDeliveriesApi.md#webhook_deliveries_list) | **GET** /projects/{project_id}/webhooks/{webhook_id}/deliveries | List webhook deliveries
+[**webhook_deliveries_redeliver**](WebhookDeliveriesApi.md#webhook_deliveries_redeliver) | **POST** /projects/{project_id}/webhooks/{webhook_id}/deliveries/{id}/redeliver | Redeliver a single webhook delivery
+[**webhook_deliveries_show**](WebhookDeliveriesApi.md#webhook_deliveries_show) | **GET** /projects/{project_id}/webhooks/{webhook_id}/deliveries/{id} | Get a single webhook delivery
+
+
+
+## webhook_deliveries_list
+
+> Array<WebhookDelivery> webhook_deliveries_list(project_id, webhook_id, opts)
+
+List webhook deliveries
+
+List all webhook deliveries for the given webhook_id.
+
+### Example
+
+```ruby
+# load the gem
+require 'phrase'
+# setup authorization
+Phrase.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+
+  # Configure API key authorization: Token
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  config.api_key_prefix['Authorization'] = 'token'
+end
+
+api_instance = Phrase::WebhookDeliveriesApi.new
+project_id = 'project_id_example' # String | Project ID
+webhook_id = 'webhook_id_example' # String | Webhook ID
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example', # String | Two-Factor-Authentication token (optional)
+  response_status_codes: 'response_status_codes_example' # String | List of Response Status Codes
+}
+
+begin
+  #List webhook deliveries
+  result = api_instance.webhook_deliveries_list(project_id, webhook_id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling WebhookDeliveriesApi->webhook_deliveries_list: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **project_id** | **String**| Project ID | 
+ **webhook_id** | **String**| Webhook ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+ **response_status_codes** | **String**| List of Response Status Codes | [optional] 
+
+### Return type
+
+Response<([**Array&lt;WebhookDelivery&gt;**](WebhookDelivery.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## webhook_deliveries_redeliver
+
+> WebhookDelivery webhook_deliveries_redeliver(project_id, webhook_id, id, opts)
+
+Redeliver a single webhook delivery
+
+Trigger an individual webhook delivery to be redelivered.
+
+### Example
+
+```ruby
+# load the gem
+require 'phrase'
+# setup authorization
+Phrase.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+
+  # Configure API key authorization: Token
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  config.api_key_prefix['Authorization'] = 'token'
+end
+
+api_instance = Phrase::WebhookDeliveriesApi.new
+project_id = 'project_id_example' # String | Project ID
+webhook_id = 'webhook_id_example' # String | Webhook ID
+id = 'id_example' # String | ID
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example' # String | Two-Factor-Authentication token (optional)
+}
+
+begin
+  #Redeliver a single webhook delivery
+  result = api_instance.webhook_deliveries_redeliver(project_id, webhook_id, id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling WebhookDeliveriesApi->webhook_deliveries_redeliver: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **project_id** | **String**| Project ID | 
+ **webhook_id** | **String**| Webhook ID | 
+ **id** | **String**| ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+
+### Return type
+
+Response<([**WebhookDelivery**](WebhookDelivery.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## webhook_deliveries_show
+
+> WebhookDelivery webhook_deliveries_show(project_id, webhook_id, id, opts)
+
+Get a single webhook delivery
+
+Get all information about a single webhook delivery for the given ID.
+
+### Example
+
+```ruby
+# load the gem
+require 'phrase'
+# setup authorization
+Phrase.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+
+  # Configure API key authorization: Token
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  config.api_key_prefix['Authorization'] = 'token'
+end
+
+api_instance = Phrase::WebhookDeliveriesApi.new
+project_id = 'project_id_example' # String | Project ID
+webhook_id = 'webhook_id_example' # String | Webhook ID
+id = 'id_example' # String | ID
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example' # String | Two-Factor-Authentication token (optional)
+}
+
+begin
+  #Get a single webhook delivery
+  result = api_instance.webhook_deliveries_show(project_id, webhook_id, id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling WebhookDeliveriesApi->webhook_deliveries_show: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **project_id** | **String**| Project ID | 
+ **webhook_id** | **String**| Webhook ID | 
+ **id** | **String**| ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+
+### Return type
+
+Response<([**WebhookDelivery**](WebhookDelivery.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/WebhookDelivery.md

@@ -0,0 +1,29 @@
+# Phrase::WebhookDelivery
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** |  | [optional] 
+**webhook_id** | **String** |  | [optional] 
+**response_status_code** | **Integer** |  | [optional] 
+**delivered_at** | **DateTime** |  | [optional] 
+**duration_ms** | **Integer** |  | [optional] 
+**created_at** | **DateTime** |  | [optional] 
+**updated_at** | **DateTime** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::WebhookDelivery.new(id: null,
+                                 webhook_id: null,
+                                 response_status_code: null,
+                                 delivered_at: null,
+                                 duration_ms: null,
+                                 created_at: null,
+                                 updated_at: null)
+```
+
+

data/lib/phrase/api/bitbucket_sync_api.rb

@@ -7,8 +7,8 @@ module Phrase
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Export from Phrase to Bitbucket
-    # Export translations from Phrase to Bitbucket according to the .phraseapp.yml file within the Bitbucket Repository.
+    # Export from Phrase Strings to Bitbucket
+    # Export translations from Phrase Strings to Bitbucket according to the .phraseapp.yml file within the Bitbucket Repository.
     # @param id [String] ID
     # @param bitbucket_sync_export_parameters [BitbucketSyncExportParameters] 
     # @param [Hash] opts the optional parameters
@@ -19,8 +19,8 @@ module Phrase
       data
     end
 
-    # Export from Phrase to Bitbucket
-    # Export translations from Phrase to Bitbucket according to the .phraseapp.yml file within the Bitbucket Repository.
+    # Export from Phrase Strings to Bitbucket
+    # Export translations from Phrase Strings to Bitbucket according to the .phraseapp.yml file within the Bitbucket Repository.
     # @param id [String] ID
     # @param bitbucket_sync_export_parameters [BitbucketSyncExportParameters] 
     # @param [Hash] opts the optional parameters
@@ -81,8 +81,8 @@ module Phrase
       return response, status_code, headers
     end
 
-    # Import to Phrase from Bitbucket
-    # Import translations from Bitbucket to Phrase according to the .phraseapp.yml file within the Bitbucket repository.
+    # Import to Phrase Strings from Bitbucket
+    # Import translations from Bitbucket to Phrase Strings according to the .phraseapp.yml file within the Bitbucket repository.
     # @param id [String] ID
     # @param bitbucket_sync_import_parameters [BitbucketSyncImportParameters] 
     # @param [Hash] opts the optional parameters
@@ -93,8 +93,8 @@ module Phrase
       data
     end
 
-    # Import to Phrase from Bitbucket
-    # Import translations from Bitbucket to Phrase according to the .phraseapp.yml file within the Bitbucket repository.
+    # Import to Phrase Strings from Bitbucket
+    # Import translations from Bitbucket to Phrase Strings according to the .phraseapp.yml file within the Bitbucket repository.
     # @param id [String] ID
     # @param bitbucket_sync_import_parameters [BitbucketSyncImportParameters] 
     # @param [Hash] opts the optional parameters
@@ -154,7 +154,7 @@ module Phrase
     end
 
     # List Bitbucket syncs
-    # List all Bitbucket repositories for which synchronisation with Phrase is activated.
+    # List all Bitbucket repositories for which synchronisation with Phrase Strings is activated.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the project should be created in. Required if the requesting user is a member of multiple accounts.
@@ -165,7 +165,7 @@ module Phrase
     end
 
     # List Bitbucket syncs
-    # List all Bitbucket repositories for which synchronisation with Phrase is activated.
+    # List all Bitbucket repositories for which synchronisation with Phrase Strings is activated.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the project should be created in. Required if the requesting user is a member of multiple accounts.

data/lib/phrase/api/git_hub_sync_api.rb

@@ -7,8 +7,8 @@ module Phrase
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Export from Phrase to GitHub
-    # Export translations from Phrase to GitHub according to the .phraseapp.yml file within the GitHub repository.
+    # Export from Phrase Strings to GitHub
+    # Export translations from Phrase Strings to GitHub according to the .phraseapp.yml file within the GitHub repository.
     # @param github_sync_export_parameters [GithubSyncExportParameters] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
@@ -18,8 +18,8 @@ module Phrase
       data
     end
 
-    # Export from Phrase to GitHub
-    # Export translations from Phrase to GitHub according to the .phraseapp.yml file within the GitHub repository.
+    # Export from Phrase Strings to GitHub
+    # Export translations from Phrase Strings to GitHub according to the .phraseapp.yml file within the GitHub repository.
     # @param github_sync_export_parameters [GithubSyncExportParameters] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
@@ -75,8 +75,8 @@ module Phrase
       return response, status_code, headers
     end
 
-    # Import to Phrase from GitHub
-    # Import files to Phrase from your connected GitHub repository.
+    # Import to Phrase Strings from GitHub
+    # Import files to Phrase Strings from your connected GitHub repository.
     # @param github_sync_import_parameters [GithubSyncImportParameters] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
@@ -86,8 +86,8 @@ module Phrase
       data
     end
 
-    # Import to Phrase from GitHub
-    # Import files to Phrase from your connected GitHub repository.
+    # Import to Phrase Strings from GitHub
+    # Import files to Phrase Strings from your connected GitHub repository.
     # @param github_sync_import_parameters [GithubSyncImportParameters] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)

data/lib/phrase/api/git_lab_sync_api.rb

@@ -74,8 +74,8 @@ module Phrase
       return response, status_code, headers
     end
 
-    # Export from Phrase to GitLab
-    # Export translations from Phrase to GitLab according to the .phraseapp.yml file within the GitLab repository.
+    # Export from Phrase Strings to GitLab
+    # Export translations from Phrase Strings to GitLab according to the .phraseapp.yml file within the GitLab repository.
     # @param gitlab_sync_id [String] Gitlab Sync ID
     # @param gitlab_sync_export_parameters [GitlabSyncExportParameters] 
     # @param [Hash] opts the optional parameters
@@ -86,8 +86,8 @@ module Phrase
       data
     end
 
-    # Export from Phrase to GitLab
-    # Export translations from Phrase to GitLab according to the .phraseapp.yml file within the GitLab repository.
+    # Export from Phrase Strings to GitLab
+    # Export translations from Phrase Strings to GitLab according to the .phraseapp.yml file within the GitLab repository.
     # @param gitlab_sync_id [String] Gitlab Sync ID
     # @param gitlab_sync_export_parameters [GitlabSyncExportParameters] 
     # @param [Hash] opts the optional parameters
@@ -224,7 +224,7 @@ module Phrase
     end
 
     # Import from GitLab to Phrase
-    # Import translations from GitLab to Phrase according to the .phraseapp.yml file within the GitLab repository.
+    # Import translations from GitLab to Phrase Strings according to the .phraseapp.yml file within the GitLab repository.
     # @param gitlab_sync_id [String] Gitlab Sync ID
     # @param gitlab_sync_import_parameters [GitlabSyncImportParameters] 
     # @param [Hash] opts the optional parameters
@@ -236,7 +236,7 @@ module Phrase
     end
 
     # Import from GitLab to Phrase
-    # Import translations from GitLab to Phrase according to the .phraseapp.yml file within the GitLab repository.
+    # Import translations from GitLab to Phrase Strings according to the .phraseapp.yml file within the GitLab repository.
     # @param gitlab_sync_id [String] Gitlab Sync ID
     # @param gitlab_sync_import_parameters [GitlabSyncImportParameters] 
     # @param [Hash] opts the optional parameters
@@ -298,7 +298,7 @@ module Phrase
     end
 
     # List GitLab syncs
-    # List all GitLab Sync Settings for which synchronisation with Phrase and GitLab is activated.
+    # List all GitLab Sync Settings for which synchronisation with Phrase Strings and GitLab is activated.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the GitLab Sync should be created in. Required if the requesting user is a member of multiple accounts.
@@ -309,7 +309,7 @@ module Phrase
     end
 
     # List GitLab syncs
-    # List all GitLab Sync Settings for which synchronisation with Phrase and GitLab is activated.
+    # List all GitLab Sync Settings for which synchronisation with Phrase Strings and GitLab is activated.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the GitLab Sync should be created in. Required if the requesting user is a member of multiple accounts.
@@ -435,7 +435,7 @@ module Phrase
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the GitLab Sync should be created in. Required if the requesting user is a member of multiple accounts.
-    # @option opts [String] :phrase_project_code Code of the related Phrase Project.
+    # @option opts [String] :phrase_project_code Code of the related Phrase Strings Project.
     # @option opts [Integer] :gitlab_project_id ID of the related GitLab Project.
     # @option opts [String] :gitlab_branch_name Name of the GitLab Branch.
     # @return [GitlabSync]
@@ -450,7 +450,7 @@ module Phrase
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :account_id Account ID to specify the actual account the GitLab Sync should be created in. Required if the requesting user is a member of multiple accounts.
-    # @option opts [String] :phrase_project_code Code of the related Phrase Project.
+    # @option opts [String] :phrase_project_code Code of the related Phrase Strings Project.
     # @option opts [Integer] :gitlab_project_id ID of the related GitLab Project.
     # @option opts [String] :gitlab_branch_name Name of the GitLab Branch.
     # @return [Array<(Response<(GitlabSync)>, Integer, Hash)>] Response<(GitlabSync)> data, response status code and response headers

data/lib/phrase/api/locales_api.rb

@@ -233,7 +233,7 @@ module Phrase
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :branch specify the branch to use
-    # @option opts [String] :file_format File format name. See the <a href=\"https://help.phrase.com/help/supported-platforms-and-formats\">format guide</a> for all supported file formats.
+    # @option opts [String] :file_format File format name. See the <a href=\"https://support.phrase.com/hc/en-us/articles/5784070560412\">format guide</a> for all supported file formats.
     # @option opts [String] :tags Limit results to keys tagged with a list of comma separated tag names.
     # @option opts [String] :tag Limit download to tagged keys. This parameter is deprecated. Please use the \"tags\" parameter instead
     # @option opts [Boolean] :include_empty_translations Indicates whether keys without translations should be included in the output as well.
@@ -241,7 +241,7 @@ module Phrase
     # @option opts [Boolean] :include_translated_keys Include translated keys in the locale file. Use in combination with include_empty_translations to obtain only untranslated keys.
     # @option opts [Boolean] :keep_notranslate_tags Indicates whether [NOTRANSLATE] tags should be kept.
     # @option opts [Boolean] :convert_emoji This option is obsolete. Projects that were created on or after Nov 29th 2019 or that did not contain emoji by then will not require this flag any longer since emoji are now supported natively.
-    # @option opts [Object] :format_options Additional formatting and render options. See the <a href=\"https://help.phrase.com/help/supported-platforms-and-formats\">format guide</a> for a list of options available for each format. Specify format options like this: <code>...&format_options[foo]=bar</code>
+    # @option opts [Object] :format_options Additional formatting and render options. See the <a href=\"https://support.phrase.com/hc/en-us/articles/5784070560412\">format guide</a> for a list of options available for each format. Specify format options like this: <code>...&format_options[foo]=bar</code>
     # @option opts [String] :encoding Enforces a specific encoding on the file contents. Valid options are \"UTF-8\", \"UTF-16\" and \"ISO-8859-1\".
     # @option opts [Boolean] :skip_unverified_translations Indicates whether the locale file should skip all unverified translations. This parameter is deprecated and should be replaced with <code>include_unverified_translations</code>.
     # @option opts [Boolean] :include_unverified_translations if set to false unverified translations are excluded
@@ -261,7 +261,7 @@ module Phrase
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :branch specify the branch to use
-    # @option opts [String] :file_format File format name. See the <a href=\"https://help.phrase.com/help/supported-platforms-and-formats\">format guide</a> for all supported file formats.
+    # @option opts [String] :file_format File format name. See the <a href=\"https://support.phrase.com/hc/en-us/articles/5784070560412\">format guide</a> for all supported file formats.
     # @option opts [String] :tags Limit results to keys tagged with a list of comma separated tag names.
     # @option opts [String] :tag Limit download to tagged keys. This parameter is deprecated. Please use the \"tags\" parameter instead
     # @option opts [Boolean] :include_empty_translations Indicates whether keys without translations should be included in the output as well.
@@ -269,7 +269,7 @@ module Phrase
     # @option opts [Boolean] :include_translated_keys Include translated keys in the locale file. Use in combination with include_empty_translations to obtain only untranslated keys.
     # @option opts [Boolean] :keep_notranslate_tags Indicates whether [NOTRANSLATE] tags should be kept.
     # @option opts [Boolean] :convert_emoji This option is obsolete. Projects that were created on or after Nov 29th 2019 or that did not contain emoji by then will not require this flag any longer since emoji are now supported natively.
-    # @option opts [Object] :format_options Additional formatting and render options. See the <a href=\"https://help.phrase.com/help/supported-platforms-and-formats\">format guide</a> for a list of options available for each format. Specify format options like this: <code>...&format_options[foo]=bar</code>
+    # @option opts [Object] :format_options Additional formatting and render options. See the <a href=\"https://support.phrase.com/hc/en-us/articles/5784070560412\">format guide</a> for a list of options available for each format. Specify format options like this: <code>...&format_options[foo]=bar</code>
     # @option opts [String] :encoding Enforces a specific encoding on the file contents. Valid options are \"UTF-8\", \"UTF-16\" and \"ISO-8859-1\".
     # @option opts [Boolean] :skip_unverified_translations Indicates whether the locale file should skip all unverified translations. This parameter is deprecated and should be replaced with <code>include_unverified_translations</code>.
     # @option opts [Boolean] :include_unverified_translations if set to false unverified translations are excluded

data/lib/phrase/api/teams_api.rb

@@ -113,7 +113,7 @@ module Phrase
         fail ArgumentError, "Missing the required parameter 'id' when calling TeamsApi.team_delete"
       end
       # resource path
-      local_var_path = '/accounts/{account_id}/teams/{team_id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+      local_var_path = '/accounts/{account_id}/teams/{id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -183,7 +183,7 @@ module Phrase
         fail ArgumentError, "Missing the required parameter 'id' when calling TeamsApi.team_show"
       end
       # resource path
-      local_var_path = '/accounts/{account_id}/teams/{team_id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+      local_var_path = '/accounts/{account_id}/teams/{id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -261,7 +261,7 @@ module Phrase
         fail ArgumentError, "Missing the required parameter 'team_update_parameters' when calling TeamsApi.team_update"
       end
       # resource path
-      local_var_path = '/accounts/{account_id}/teams/{team_id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+      local_var_path = '/accounts/{account_id}/teams/{id}'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}