phrase 4.14.0 → 4.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eafb6674f53665915555e2352445b2c1b81a981cc7d472ac7684855ca5061cc
-  data.tar.gz: 6b630a9fcb6f2376c7bec8c179754b60b1d2c9109e18010714a35a00fef6067c
+  metadata.gz: 5987ebb038c9e36ae7593f16926052cbdb94e3914c82bec4834aecb655919983
+  data.tar.gz: 93bf790d7884ad21c172442aa387d6019cd818e98e6061d0b960300535fb2df8
 SHA512:
-  metadata.gz: 771899ee1169536d3e35957c20cd8b4ce58dd81552ee1a979a02f2b5d10215ed4a5f53b25f6f06e67f9b4b2b95554b0e8545f9e8fb4d937c31e5f2865aa027fd
-  data.tar.gz: d75c3aa7238687236f7e1d917676dbac4e82a6381a17802d16e6ff0fea2b87ac27e909a8818ad3c3c0afcccf3dd2576c5a3a6866ee093018cbd2359157629d64
+  metadata.gz: 89b80fed14629efae28d5109e286e2eb03188ea0f40522fcc729d1fc048f74f7a1fdaa8ffd4bf1e17aec6c815b8625cd23e71cd0d9e49c6342191271456873b0
+  data.tar.gz: aa62cc3f88f081efb61e765eb96caade67c7329235ddf395fbab029702972978e86cb467235dd49ebffd89ca9fdc0202f69b878a7e16d77abe9894800f4675c0

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [4.15.0](https://github.com/phrase/openapi/compare/ruby-v4.14.1...ruby-v4.15.0) (2025-12-11)
+
+
+### Features
+
+* **API:** Add create comparison endpoint for branches [SCD-549] ([#966](https://github.com/phrase/openapi/issues/966)) ([4099e32](https://github.com/phrase/openapi/commit/4099e32d42744f9d73346077ef30b0f4bd5c849e))
+* **API:** add manual triggering of automations #SCM-953 ([#968](https://github.com/phrase/openapi/issues/968)) ([ebe1c68](https://github.com/phrase/openapi/commit/ebe1c68e472d87ea6c6cd2f76bb421406c30a274))
+* **API:** add use_locale_fallback option to download #SCD-620 ([#976](https://github.com/phrase/openapi/issues/976)) ([9266c68](https://github.com/phrase/openapi/commit/9266c680d8717bb736aed83625858f0b3419da54))
+
+## [4.14.1](https://github.com/phrase/openapi/compare/ruby-v4.14.0...ruby-v4.14.1) (2025-11-10)
+
+
+### Bug Fixes
+
+* **API:** Add omit_translation_keys to Jobs#show endpoint ([#957](https://github.com/phrase/openapi/issues/957)) ([23ece66](https://github.com/phrase/openapi/commit/23ece66b05fc748a4598ce876cb2954ed1a385cc))
+
 ## [4.14.0](https://github.com/phrase/openapi/compare/ruby-v4.13.0...ruby-v4.14.0) (2025-10-27)
 
 

data/README.md

@@ -7,7 +7,7 @@ Phrase Strings is a translation management platform for software projects. You c
 ## This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 2.0.0
-- Package version: 4.14.0
+- Package version: 4.15.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 For more information, please visit [https://developers.phrase.com/api/](https://developers.phrase.com/api/)
 
@@ -56,10 +56,10 @@ gem build phrase.gemspec
 Then install the gem locally:
 
 ```shell
-gem install ./phrase-4.14.0.gem
+gem install ./phrase-4.15.0.gem
 ```
 
-(for development, run `gem install --dev ./phrase-4.14.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./phrase-4.15.0.gem` to install the development dependencies)
 
 ## Getting Started
 
@@ -142,6 +142,7 @@ Class | Method | HTTP request | Description
 *Phrase::AutomationsApi* | [**automation_deactivate**](docs/AutomationsApi.md#automation_deactivate) | **POST** /accounts/{account_id}/automations/{automation_id}/deactivate | Deactivate an automation
 *Phrase::AutomationsApi* | [**automation_delete**](docs/AutomationsApi.md#automation_delete) | **DELETE** /accounts/{account_id}/automations/{automation_id} | Destroy automation
 *Phrase::AutomationsApi* | [**automation_show**](docs/AutomationsApi.md#automation_show) | **GET** /accounts/{account_id}/automations/{automation_id} | Get a single automation
+*Phrase::AutomationsApi* | [**automation_trigger**](docs/AutomationsApi.md#automation_trigger) | **POST** /accounts/{account_id}/automations/{automation_id}/trigger | Trigger an automation
 *Phrase::AutomationsApi* | [**automation_update**](docs/AutomationsApi.md#automation_update) | **PATCH** /accounts/{account_id}/automations/{automation_id} | Update an automation
 *Phrase::AutomationsApi* | [**automations_list**](docs/AutomationsApi.md#automations_list) | **GET** /accounts/{account_id}/automations | List automations
 *Phrase::BlacklistedKeysApi* | [**blacklisted_key_create**](docs/BlacklistedKeysApi.md#blacklisted_key_create) | **POST** /projects/{project_id}/blacklisted_keys | Create a blocked key
@@ -150,6 +151,7 @@ Class | Method | HTTP request | Description
 *Phrase::BlacklistedKeysApi* | [**blacklisted_key_update**](docs/BlacklistedKeysApi.md#blacklisted_key_update) | **PATCH** /projects/{project_id}/blacklisted_keys/{id} | Update a blocked key
 *Phrase::BlacklistedKeysApi* | [**blacklisted_keys_list**](docs/BlacklistedKeysApi.md#blacklisted_keys_list) | **GET** /projects/{project_id}/blacklisted_keys | List blocked keys
 *Phrase::BranchesApi* | [**branch_compare**](docs/BranchesApi.md#branch_compare) | **GET** /projects/{project_id}/branches/{name}/compare | Compare branches
+*Phrase::BranchesApi* | [**branch_comparison_create**](docs/BranchesApi.md#branch_comparison_create) | **POST** /projects/{project_id}/branches/{name}/compare | Create comparison (async.)
 *Phrase::BranchesApi* | [**branch_create**](docs/BranchesApi.md#branch_create) | **POST** /projects/{project_id}/branches | Create a branch
 *Phrase::BranchesApi* | [**branch_delete**](docs/BranchesApi.md#branch_delete) | **DELETE** /projects/{project_id}/branches/{name} | Delete a branch
 *Phrase::BranchesApi* | [**branch_merge**](docs/BranchesApi.md#branch_merge) | **PATCH** /projects/{project_id}/branches/{name}/merge | Merge a branch
@@ -433,6 +435,7 @@ Class | Method | HTTP request | Description
  - [Phrase::BlacklistedKeyCreateParameters](docs/BlacklistedKeyCreateParameters.md)
  - [Phrase::BlacklistedKeyUpdateParameters](docs/BlacklistedKeyUpdateParameters.md)
  - [Phrase::Branch](docs/Branch.md)
+ - [Phrase::BranchCreateComparisonParameters](docs/BranchCreateComparisonParameters.md)
  - [Phrase::BranchCreateParameters](docs/BranchCreateParameters.md)
  - [Phrase::BranchMergeParameters](docs/BranchMergeParameters.md)
  - [Phrase::BranchName](docs/BranchName.md)

data/docs/AutomationsApi.md

@@ -9,6 +9,7 @@ Method | HTTP request | Description
 [**automation_deactivate**](AutomationsApi.md#automation_deactivate) | **POST** /accounts/{account_id}/automations/{automation_id}/deactivate | Deactivate an automation
 [**automation_delete**](AutomationsApi.md#automation_delete) | **DELETE** /accounts/{account_id}/automations/{automation_id} | Destroy automation
 [**automation_show**](AutomationsApi.md#automation_show) | **GET** /accounts/{account_id}/automations/{automation_id} | Get a single automation
+[**automation_trigger**](AutomationsApi.md#automation_trigger) | **POST** /accounts/{account_id}/automations/{automation_id}/trigger | Trigger an automation
 [**automation_update**](AutomationsApi.md#automation_update) | **PATCH** /accounts/{account_id}/automations/{automation_id} | Update an automation
 [**automations_list**](AutomationsApi.md#automations_list) | **GET** /accounts/{account_id}/automations | List automations
 
@@ -328,6 +329,68 @@ Response<([**Automation**](Automation.md))>
 - **Accept**: application/json
 
 
+## automation_trigger
+
+> automation_trigger(account_id, id, opts)
+
+Trigger an automation
+
+Trigger an automation. 
+
+### 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::AutomationsApi.new
+account_id = 'account_id_example' # String | Account ID
+id = 'id_example' # String | ID
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example' # String | Two-Factor-Authentication token (optional)
+}
+
+begin
+  #Trigger an automation
+  api_instance.automation_trigger(account_id, id, opts)
+rescue Phrase::ApiError => e
+  puts "Exception when calling AutomationsApi->automation_trigger: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **account_id** | **String**| Account ID | 
+ **id** | **String**| ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+
+### Return type
+
+Response<(nil (empty response body))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+
 ## automation_update
 
 > Automation automation_update(account_id, id, automations_create_parameters1, opts)

data/docs/BranchCreateComparisonParameters.md

@@ -0,0 +1,17 @@
+# Phrase::BranchCreateComparisonParameters
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**direction** | **String** | direction of comparison, possible values are sync or merge (only for v2 branches) | [optional] [default to 'merge']
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::BranchCreateComparisonParameters.new(direction: merge)
+```
+
+

data/docs/BranchesApi.md

@@ -5,6 +5,7 @@ All URIs are relative to *https://api.phrase.com/v2*
 Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**branch_compare**](BranchesApi.md#branch_compare) | **GET** /projects/{project_id}/branches/{name}/compare | Compare branches
+[**branch_comparison_create**](BranchesApi.md#branch_comparison_create) | **POST** /projects/{project_id}/branches/{name}/compare | Create comparison (async.)
 [**branch_create**](BranchesApi.md#branch_create) | **POST** /projects/{project_id}/branches | Create a branch
 [**branch_delete**](BranchesApi.md#branch_delete) | **DELETE** /projects/{project_id}/branches/{name} | Delete a branch
 [**branch_merge**](BranchesApi.md#branch_merge) | **PATCH** /projects/{project_id}/branches/{name}/merge | Merge a branch
@@ -21,7 +22,7 @@ Method | HTTP request | Description
 
 Compare branches
 
-Compare branch with main branch.   *Note: Comparing a branch may take several minutes depending on the project size.* 
+Compare branch with main branch.  *Note: Comparing a branch may take several minutes depending on the project size. Consider using the `POST /compare` endpoint for creating comparison asynchronously.* 
 
 ### Example
 
@@ -77,6 +78,70 @@ Response<(nil (empty response body))>
 - **Accept**: Not defined
 
 
+## branch_comparison_create
+
+> branch_comparison_create(project_id, name, branch_create_comparison_parameters, opts)
+
+Create comparison (async.)
+
+Create a branch comparison asynchronously. 
+
+### 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::BranchesApi.new
+project_id = 'project_id_example' # String | Project ID
+name = 'name_example' # String | name
+branch_create_comparison_parameters = Phrase::BranchCreateComparisonParameters.new # BranchCreateComparisonParameters | 
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example' # String | Two-Factor-Authentication token (optional)
+}
+
+begin
+  #Create comparison (async.)
+  api_instance.branch_comparison_create(project_id, name, branch_create_comparison_parameters, opts)
+rescue Phrase::ApiError => e
+  puts "Exception when calling BranchesApi->branch_comparison_create: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **project_id** | **String**| Project ID | 
+ **name** | **String**| name | 
+ **branch_create_comparison_parameters** | [**BranchCreateComparisonParameters**](BranchCreateComparisonParameters.md)|  | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+
+### Return type
+
+Response<(nil (empty response body))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: Not defined
+
+
 ## branch_create
 
 > Branch branch_create(project_id, branch_create_parameters, opts)
@@ -335,7 +400,7 @@ Response<([**Branch**](Branch.md))>
 
 Sync a branch
 
-Sync an existing branch.  *Note: Only available for branches created with new branching. New branching is currently in private beta* 
+Sync an existing branch.  *Note: Only available for branches created with new branching.* 
 
 ### Example
 

data/docs/JobsApi.md

@@ -500,7 +500,8 @@ id = 'id_example' # String | ID
 opts = {
   x_phrase_app_otp: 'x_phrase_app_otp_example', # String | Two-Factor-Authentication token (optional)
   branch: 'my-feature-branch', # String | Branch to use
-  include_annotations: true # Boolean | Include job-locale annotations in the response
+  include_annotations: true, # Boolean | Include job-locale annotations in the response
+  omit_translation_keys: true # Boolean | Omit translation keys in the response to reduce payload size for bigger jobs
 }
 
 begin
@@ -522,6 +523,7 @@ Name | Type | Description  | Notes
  **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
  **branch** | **String**| Branch to use | [optional] 
  **include_annotations** | **Boolean**| Include job-locale annotations in the response | [optional] [default to false]
+ **omit_translation_keys** | **Boolean**| Omit translation keys in the response to reduce payload size for bigger jobs | [optional] [default to false]
 
 ### Return type
 

data/docs/KeyCreateParameters.md

@@ -38,7 +38,7 @@ instance = Phrase::KeyCreateParameters.new(branch: my-feature-branch,
                                  data_type: number,
                                  tags: awesome-feature,needs-proofreading,
                                  max_characters_allowed: 140,
-                                 screenshot: [B@1df2b230,
+                                 screenshot: [B@4116167e,
                                  remove_screenshot: null,
                                  unformatted: null,
                                  default_translation_content: Default translation content,

data/docs/KeyUpdateParameters.md

@@ -36,7 +36,7 @@ instance = Phrase::KeyUpdateParameters.new(branch: my-feature-branch,
                                  data_type: number,
                                  tags: awesome-feature,needs-proofreading,
                                  max_characters_allowed: 140,
-                                 screenshot: [B@37d85eec,
+                                 screenshot: [B@74e2de39,
                                  remove_screenshot: null,
                                  unformatted: null,
                                  xml_space_preserve: null,

data/docs/KeysExcludeParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
 **q** | **String** | Specify a query to do broad search for keys by name (including wildcards).  The following qualifiers are also supported in the search term: - `ids:key_id,...` for queries on a comma-separated list of ids - `name:key_name` for text queries on exact key names - spaces, commas, and colons need to be escaped with double backslashes - `tags:tag_name` to filter for keys with certain tags - `translated:{true|false}` for translation status (also requires `locale_id` to be specified) - `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries - `unmentioned_in_upload:upload_id,...` to filter keys unmentioned within upload. When multiple upload IDs provided, matches only keys not mentioned in **all** uploads  Find more examples [here](/en/api/strings/usage-examples).      | [optional] 
-**target_locale_id** | **String** | Locale used to exlcude or include keys. | [optional] 
+**target_locale_id** | **String** | Exclude translations in locale | [optional] 
 **tags** | **String** | Tag or comma-separated list of tags to add to the matching collection of keys | [optional] 
 
 ## Code Sample

data/docs/KeysIncludeParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
 **q** | **String** | Specify a query to do broad search for keys by name (including wildcards).  The following qualifiers are also supported in the search term:  * `ids:key_id,...` for queries on a comma-separated list of ids * `name:key_name` for text queries on exact key names - spaces, commas, and colons need to be escaped with double backslashes * `tags:tag_name` to filter for keys with certain tags * `translated:{true|false}` for translation status (also requires `locale_id` to be specified) * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `unmentioned_in_upload:upload_id,...` to filter keys unmentioned within upload. When multiple upload IDs provided, matches only keys not mentioned in **all** uploads  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
-**target_locale_id** | **String** | Locale used to exlcude or include keys. | [optional] 
+**target_locale_id** | **String** | Include translations in locale | [optional] 
 **tags** | **String** | Tag or comma-separated list of tags to add to the matching collection of keys | [optional] 
 
 ## Code Sample

data/docs/LocaleDownloadCreateParameters.md

@@ -16,7 +16,8 @@ Name | Type | Description | Notes
 **include_unverified_translations** | **Boolean** | if set to false unverified translations are excluded | [optional] 
 **use_last_reviewed_version** | **Boolean** | If set to true the last reviewed version of a translation is used. This is only available if the review workflow is enabled for the project. | [optional] 
 **locale_ids** | **Array<String>** | Locale IDs or locale names | [optional] 
-**fallback_locale_id** | **String** | If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`. | [optional] 
+**fallback_locale_id** | **String** | If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.  | [optional] 
+**use_locale_fallback** | **Boolean** | If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.  | [optional] 
 **source_locale_id** | **String** | Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job. | [optional] 
 **custom_metadata_filters** | **Object** | Custom metadata filters. Provide the name of the metadata field and the value to filter by. Only keys with matching metadata will be included in the download.  | [optional] 
 **updated_since** | **String** | Only include translations and keys that have been updated since the given date. The date must be in ISO 8601 format (e.g., `2023-01-01T00:00:00Z`).  | [optional] 
@@ -39,6 +40,7 @@ instance = Phrase::LocaleDownloadCreateParameters.new(file_format: yml,
                                  use_last_reviewed_version: null,
                                  locale_ids: ["de","en"],
                                  fallback_locale_id: abcd1234abcd1234abcd1234abcd1234,
+                                 use_locale_fallback: false,
                                  source_locale_id: abcd1234abcd1234abcd1234abcd1234,
                                  custom_metadata_filters: null,
                                  updated_since: 2023-01-01T00:00:00Z)

data/docs/LocalesApi.md

@@ -251,7 +251,8 @@ opts = {
   skip_unverified_translations: true, # Boolean | Indicates whether the locale file should skip all unverified translations. This parameter is deprecated and should be replaced with `include_unverified_translations`.
   include_unverified_translations: true, # Boolean | if set to false unverified translations are excluded
   use_last_reviewed_version: true, # Boolean | If set to true the last reviewed version of a translation is used. This is only available if the review workflow is enabled for the project.
-  fallback_locale_id: 'fallback_locale_id_example', # String | If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.
+  fallback_locale_id: 'fallback_locale_id_example', # String | If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`. 
+  use_locale_fallback: true, # Boolean | If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`. 
   source_locale_id: 'source_locale_id_example', # String | Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.
   translation_key_prefix: 'prefix_', # String | Download all translation keys, and remove the specified prefix where possible. Warning: this may create duplicate key names if other keys share the same name after the prefix is removed.
   filter_by_prefix: true, # Boolean | Only download translation keys containing the specified prefix, and remove the prefix from the generated file.
@@ -293,7 +294,8 @@ Name | Type | Description  | Notes
  **skip_unverified_translations** | **Boolean**| Indicates whether the locale file should skip all unverified translations. This parameter is deprecated and should be replaced with `include_unverified_translations`. | [optional] 
  **include_unverified_translations** | **Boolean**| if set to false unverified translations are excluded | [optional] 
  **use_last_reviewed_version** | **Boolean**| If set to true the last reviewed version of a translation is used. This is only available if the review workflow is enabled for the project. | [optional] 
- **fallback_locale_id** | **String**| If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`. | [optional] 
+ **fallback_locale_id** | **String**| If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.  | [optional] 
+ **use_locale_fallback** | **Boolean**| If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.  | [optional] 
  **source_locale_id** | **String**| Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job. | [optional] 
  **translation_key_prefix** | **String**| Download all translation keys, and remove the specified prefix where possible. Warning: this may create duplicate key names if other keys share the same name after the prefix is removed. | [optional] 
  **filter_by_prefix** | **Boolean**| Only download translation keys containing the specified prefix, and remove the prefix from the generated file. | [optional] 

data/docs/ProjectCreateParameters.md

@@ -37,7 +37,7 @@ instance = Phrase::ProjectCreateParameters.new(name: My Android Project,
                                  main_format: yml,
                                  media: Python,
                                  shares_translation_memory: true,
-                                 project_image: [B@e80fc9d,
+                                 project_image: [B@767c34a0,
                                  remove_project_image: null,
                                  account_id: abcd1234,
                                  point_of_contact: abcd1234,

data/docs/ProjectUpdateParameters.md

@@ -39,7 +39,7 @@ instance = Phrase::ProjectUpdateParameters.new(account_id: abcd1234,
                                  main_format: yml,
                                  media: Python,
                                  shares_translation_memory: true,
-                                 project_image: [B@4abc179d,
+                                 project_image: [B@404ea1e4,
                                  remove_project_image: false,
                                  workflow: review,
                                  machine_translation_enabled: true,

data/docs/ScreenshotUpdateParameters.md

@@ -17,7 +17,7 @@ require 'Phrase'
 instance = Phrase::ScreenshotUpdateParameters.new(branch: my-feature-branch,
                                  name: A screenshot name,
                                  description: A screenshot description,
-                                 filename: [B@141fc03a)
+                                 filename: [B@56d8f131)
 ```
 
 

data/docs/UploadSummary.md

@@ -7,7 +7,7 @@ Name | Type | Description | Notes
 **locales_created** | **Integer** |  | [optional] 
 **translation_keys_created** | **Integer** |  | [optional] 
 **translation_keys_updated** | **Integer** |  | [optional] 
-**translation_keys_unmentioned** | **Integer** |  | [optional] 
+**translation_keys_unmentioned** | **Integer** | The number of translation keys in the project that were not mentioned in the upload.  Note: this field is not calculated (and shows 0) if the upload contains more than 10,000 keys.  | [optional] 
 **translations_created** | **Integer** |  | [optional] 
 **translations_updated** | **Integer** |  | [optional] 
 **tags_created** | **Integer** |  | [optional] 

data/docs/UploadsApi.md

@@ -16,7 +16,7 @@ Method | HTTP request | Description
 
 Upload a new file
 
-Upload a new language file. Creates necessary resources in your project.
+Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
 
 ### Example
 

data/lib/phrase/api/automations_api.rb

@@ -367,6 +367,76 @@ module Phrase
       return response, status_code, headers
     end
 
+    # Trigger an automation
+    # Trigger an automation. 
+    # @param account_id [String] Account ID
+    # @param id [String] ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+    # @return [nil]
+    def automation_trigger(account_id, id, opts = {})
+      data, _status_code, _headers = automation_trigger_with_http_info(account_id, id, opts)
+      data
+    end
+
+    # Trigger an automation
+    # Trigger an automation. 
+    # @param account_id [String] Account ID
+    # @param id [String] ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+    # @return [Array<(Response, Integer, Hash)>] Response<(nil, response status code and response headers
+    def automation_trigger_with_http_info(account_id, id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AutomationsApi.automation_trigger ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AutomationsApi.automation_trigger"
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AutomationsApi.automation_trigger"
+      end
+      # resource path
+      local_var_path = '/accounts/{account_id}/automations/{automation_id}/trigger'.sub('{' + 'account_id' + '}', CGI.escape(account_id.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params[:'X-PhraseApp-OTP'] = opts[:'x_phrase_app_otp'] if !opts[:'x_phrase_app_otp'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['Basic', 'Token']
+
+      new_options = opts.merge(
+        :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: AutomationsApi#automation_trigger\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      response = ::Phrase::Response.new(data, headers)
+      return response, status_code, headers
+    end
+
     # Update an automation
     # Update an existing automation.  For feature availability, see [Jobs (Strings)](https://support.phrase.com/hc/en-us/articles/5784100517788-Jobs-Strings). 
     # @param account_id [String] Account ID

data/lib/phrase/api/branches_api.rb

@@ -8,7 +8,7 @@ module Phrase
       @api_client = api_client
     end
     # Compare branches
-    # Compare branch with main branch.   *Note: Comparing a branch may take several minutes depending on the project size.* 
+    # Compare branch with main branch.  *Note: Comparing a branch may take several minutes depending on the project size. Consider using the `POST /compare` endpoint for creating comparison asynchronously.* 
     # @param project_id [String] Project ID
     # @param name [String] name
     # @param [Hash] opts the optional parameters
@@ -20,7 +20,7 @@ module Phrase
     end
 
     # Compare branches
-    # Compare branch with main branch.   *Note: Comparing a branch may take several minutes depending on the project size.* 
+    # Compare branch with main branch.  *Note: Comparing a branch may take several minutes depending on the project size. Consider using the `POST /compare` endpoint for creating comparison asynchronously.* 
     # @param project_id [String] Project ID
     # @param name [String] name
     # @param [Hash] opts the optional parameters
@@ -77,6 +77,84 @@ module Phrase
       return response, status_code, headers
     end
 
+    # Create comparison (async.)
+    # Create a branch comparison asynchronously. 
+    # @param project_id [String] Project ID
+    # @param name [String] name
+    # @param branch_create_comparison_parameters [BranchCreateComparisonParameters] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+    # @return [nil]
+    def branch_comparison_create(project_id, name, branch_create_comparison_parameters, opts = {})
+      data, _status_code, _headers = branch_comparison_create_with_http_info(project_id, name, branch_create_comparison_parameters, opts)
+      data
+    end
+
+    # Create comparison (async.)
+    # Create a branch comparison asynchronously. 
+    # @param project_id [String] Project ID
+    # @param name [String] name
+    # @param branch_create_comparison_parameters [BranchCreateComparisonParameters] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+    # @return [Array<(Response, Integer, Hash)>] Response<(nil, response status code and response headers
+    def branch_comparison_create_with_http_info(project_id, name, branch_create_comparison_parameters, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BranchesApi.branch_comparison_create ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BranchesApi.branch_comparison_create"
+      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 BranchesApi.branch_comparison_create"
+      end
+      # verify the required parameter 'branch_create_comparison_parameters' is set
+      if @api_client.config.client_side_validation && branch_create_comparison_parameters.nil?
+        fail ArgumentError, "Missing the required parameter 'branch_create_comparison_parameters' when calling BranchesApi.branch_comparison_create"
+      end
+      # resource path
+      local_var_path = '/projects/{project_id}/branches/{name}/compare'.sub('{' + 'project_id' + '}', CGI.escape(project_id.to_s)).sub('{' + 'name' + '}', CGI.escape(name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      header_params[:'X-PhraseApp-OTP'] = opts[:'x_phrase_app_otp'] if !opts[:'x_phrase_app_otp'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] || @api_client.object_to_http_body(branch_create_comparison_parameters) 
+
+      # return_type
+      return_type = opts[:return_type] 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['Basic', 'Token']
+
+      new_options = opts.merge(
+        :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: BranchesApi#branch_comparison_create\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      response = ::Phrase::Response.new(data, headers)
+      return response, status_code, headers
+    end
+
     # Create a branch
     # Create a new branch.  *Note: Creating a new branch may take several minutes depending on the project size.* 
     # @param project_id [String] Project ID
@@ -372,7 +450,7 @@ module Phrase
     end
 
     # Sync a branch
-    # Sync an existing branch.  *Note: Only available for branches created with new branching. New branching is currently in private beta* 
+    # Sync an existing branch.  *Note: Only available for branches created with new branching.* 
     # @param project_id [String] Project ID
     # @param name [String] name
     # @param branch_sync_parameters [BranchSyncParameters] 
@@ -385,7 +463,7 @@ module Phrase
     end
 
     # Sync a branch
-    # Sync an existing branch.  *Note: Only available for branches created with new branching. New branching is currently in private beta* 
+    # Sync an existing branch.  *Note: Only available for branches created with new branching.* 
     # @param project_id [String] Project ID
     # @param name [String] name
     # @param branch_sync_parameters [BranchSyncParameters] 

data/lib/phrase/api/jobs_api.rb

@@ -553,6 +553,7 @@ module Phrase
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :branch Branch to use
     # @option opts [Boolean] :include_annotations Include job-locale annotations in the response (default to false)
+    # @option opts [Boolean] :omit_translation_keys Omit translation keys in the response to reduce payload size for bigger jobs (default to false)
     # @return [JobDetails]
     def job_show(project_id, id, opts = {})
       data, _status_code, _headers = job_show_with_http_info(project_id, id, opts)
@@ -567,6 +568,7 @@ module Phrase
     # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
     # @option opts [String] :branch Branch to use
     # @option opts [Boolean] :include_annotations Include job-locale annotations in the response
+    # @option opts [Boolean] :omit_translation_keys Omit translation keys in the response to reduce payload size for bigger jobs
     # @return [Array<(Response<(JobDetails)>, Integer, Hash)>] Response<(JobDetails)> data, response status code and response headers
     def job_show_with_http_info(project_id, id, opts = {})
       if @api_client.config.debugging
@@ -587,6 +589,7 @@ module Phrase
       query_params = opts[:query_params] || {}
       query_params[:'branch'] = opts[:'branch'] if !opts[:'branch'].nil?
       query_params[:'include_annotations'] = opts[:'include_annotations'] if !opts[:'include_annotations'].nil?
+      query_params[:'omit_translation_keys'] = opts[:'omit_translation_keys'] if !opts[:'omit_translation_keys'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

data/lib/phrase/api/locales_api.rb

@@ -248,7 +248,8 @@ module Phrase
     # @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 `include_unverified_translations`.
     # @option opts [Boolean] :include_unverified_translations if set to false unverified translations are excluded
     # @option opts [Boolean] :use_last_reviewed_version If set to true the last reviewed version of a translation is used. This is only available if the review workflow is enabled for the project.
-    # @option opts [String] :fallback_locale_id If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.
+    # @option opts [String] :fallback_locale_id If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`. 
+    # @option opts [Boolean] :use_locale_fallback If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`. 
     # @option opts [String] :source_locale_id Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.
     # @option opts [String] :translation_key_prefix Download all translation keys, and remove the specified prefix where possible. Warning: this may create duplicate key names if other keys share the same name after the prefix is removed.
     # @option opts [Boolean] :filter_by_prefix Only download translation keys containing the specified prefix, and remove the prefix from the generated file.
@@ -283,7 +284,8 @@ module Phrase
     # @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 `include_unverified_translations`.
     # @option opts [Boolean] :include_unverified_translations if set to false unverified translations are excluded
     # @option opts [Boolean] :use_last_reviewed_version If set to true the last reviewed version of a translation is used. This is only available if the review workflow is enabled for the project.
-    # @option opts [String] :fallback_locale_id If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.
+    # @option opts [String] :fallback_locale_id If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`. 
+    # @option opts [Boolean] :use_locale_fallback If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`. 
     # @option opts [String] :source_locale_id Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.
     # @option opts [String] :translation_key_prefix Download all translation keys, and remove the specified prefix where possible. Warning: this may create duplicate key names if other keys share the same name after the prefix is removed.
     # @option opts [Boolean] :filter_by_prefix Only download translation keys containing the specified prefix, and remove the prefix from the generated file.
@@ -323,6 +325,7 @@ module Phrase
       query_params[:'include_unverified_translations'] = opts[:'include_unverified_translations'] if !opts[:'include_unverified_translations'].nil?
       query_params[:'use_last_reviewed_version'] = opts[:'use_last_reviewed_version'] if !opts[:'use_last_reviewed_version'].nil?
       query_params[:'fallback_locale_id'] = opts[:'fallback_locale_id'] if !opts[:'fallback_locale_id'].nil?
+      query_params[:'use_locale_fallback'] = opts[:'use_locale_fallback'] if !opts[:'use_locale_fallback'].nil?
       query_params[:'source_locale_id'] = opts[:'source_locale_id'] if !opts[:'source_locale_id'].nil?
       query_params[:'translation_key_prefix'] = opts[:'translation_key_prefix'] if !opts[:'translation_key_prefix'].nil?
       query_params[:'filter_by_prefix'] = opts[:'filter_by_prefix'] if !opts[:'filter_by_prefix'].nil?

data/lib/phrase/api/uploads_api.rb

@@ -8,7 +8,7 @@ module Phrase
       @api_client = api_client
     end
     # Upload a new file
-    # Upload a new language file. Creates necessary resources in your project.
+    # Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
     # @param project_id [String] Project ID
     # @param file [File] File to be imported
     # @param file_format [String] File format. Auto-detected when possible and not specified.
@@ -41,7 +41,7 @@ module Phrase
     end
 
     # Upload a new file
-    # Upload a new language file. Creates necessary resources in your project.
+    # Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
     # @param project_id [String] Project ID
     # @param file [File] File to be imported
     # @param file_format [String] File format. Auto-detected when possible and not specified.

data/lib/phrase/models/branch_create_comparison_parameters.rb

@@ -0,0 +1,199 @@
+require 'date'
+
+module Phrase
+  class BranchCreateComparisonParameters
+    # direction of comparison, possible values are sync or merge (only for v2 branches)
+    attr_accessor :direction
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'direction' => :'direction'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'direction' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Phrase::BranchCreateComparisonParameters` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Phrase::BranchCreateComparisonParameters`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'direction')
+        self.direction = attributes[:'direction']
+      else
+        self.direction = 'merge'
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          direction == o.direction
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [direction].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      new.build_from_hash(attributes)
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      self.class.openapi_types.each_pair do |key, type|
+        if type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :DateTime
+        DateTime.parse(value)
+      when :Date
+        Date.parse(value)
+      when :Time
+        Time.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        Phrase.const_get(type).build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+  end
+end

data/lib/phrase/models/keys_exclude_parameters.rb

@@ -8,7 +8,7 @@ module Phrase
     # Specify a query to do broad search for keys by name (including wildcards).  The following qualifiers are also supported in the search term: - `ids:key_id,...` for queries on a comma-separated list of ids - `name:key_name` for text queries on exact key names - spaces, commas, and colons need to be escaped with double backslashes - `tags:tag_name` to filter for keys with certain tags - `translated:{true|false}` for translation status (also requires `locale_id` to be specified) - `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries - `unmentioned_in_upload:upload_id,...` to filter keys unmentioned within upload. When multiple upload IDs provided, matches only keys not mentioned in **all** uploads  Find more examples [here](/en/api/strings/usage-examples).     
     attr_accessor :q
 
-    # Locale used to exlcude or include keys.
+    # Exclude translations in locale
     attr_accessor :target_locale_id
 
     # Tag or comma-separated list of tags to add to the matching collection of keys

data/lib/phrase/models/keys_include_parameters.rb

@@ -8,7 +8,7 @@ module Phrase
     # Specify a query to do broad search for keys by name (including wildcards).  The following qualifiers are also supported in the search term:  * `ids:key_id,...` for queries on a comma-separated list of ids * `name:key_name` for text queries on exact key names - spaces, commas, and colons need to be escaped with double backslashes * `tags:tag_name` to filter for keys with certain tags * `translated:{true|false}` for translation status (also requires `locale_id` to be specified) * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `unmentioned_in_upload:upload_id,...` to filter keys unmentioned within upload. When multiple upload IDs provided, matches only keys not mentioned in **all** uploads  Find more examples [here](/en/api/strings/usage-examples). 
     attr_accessor :q
 
-    # Locale used to exlcude or include keys.
+    # Include translations in locale
     attr_accessor :target_locale_id
 
     # Tag or comma-separated list of tags to add to the matching collection of keys

data/lib/phrase/models/locale_download_create_parameters.rb

@@ -38,9 +38,12 @@ module Phrase
     # Locale IDs or locale names
     attr_accessor :locale_ids
 
-    # If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.
+    # If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`. 
     attr_accessor :fallback_locale_id
 
+    # If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used. Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id). Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`. 
+    attr_accessor :use_locale_fallback
+
     # Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.
     attr_accessor :source_locale_id
 
@@ -66,6 +69,7 @@ module Phrase
         :'use_last_reviewed_version' => :'use_last_reviewed_version',
         :'locale_ids' => :'locale_ids',
         :'fallback_locale_id' => :'fallback_locale_id',
+        :'use_locale_fallback' => :'use_locale_fallback',
         :'source_locale_id' => :'source_locale_id',
         :'custom_metadata_filters' => :'custom_metadata_filters',
         :'updated_since' => :'updated_since'
@@ -88,6 +92,7 @@ module Phrase
         :'use_last_reviewed_version' => :'Boolean',
         :'locale_ids' => :'Array<String>',
         :'fallback_locale_id' => :'String',
+        :'use_locale_fallback' => :'Boolean',
         :'source_locale_id' => :'String',
         :'custom_metadata_filters' => :'Object',
         :'updated_since' => :'String'
@@ -169,6 +174,10 @@ module Phrase
         self.fallback_locale_id = attributes[:'fallback_locale_id']
       end
 
+      if attributes.key?(:'use_locale_fallback')
+        self.use_locale_fallback = attributes[:'use_locale_fallback']
+      end
+
       if attributes.key?(:'source_locale_id')
         self.source_locale_id = attributes[:'source_locale_id']
       end
@@ -218,6 +227,7 @@ module Phrase
           use_last_reviewed_version == o.use_last_reviewed_version &&
           locale_ids == o.locale_ids &&
           fallback_locale_id == o.fallback_locale_id &&
+          use_locale_fallback == o.use_locale_fallback &&
           source_locale_id == o.source_locale_id &&
           custom_metadata_filters == o.custom_metadata_filters &&
           updated_since == o.updated_since
@@ -232,7 +242,7 @@ module Phrase
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [file_format, branch, tags, include_empty_translations, exclude_empty_zero_forms, include_translated_keys, keep_notranslate_tags, format_options, encoding, include_unverified_translations, use_last_reviewed_version, locale_ids, fallback_locale_id, source_locale_id, custom_metadata_filters, updated_since].hash
+      [file_format, branch, tags, include_empty_translations, exclude_empty_zero_forms, include_translated_keys, keep_notranslate_tags, format_options, encoding, include_unverified_translations, use_last_reviewed_version, locale_ids, fallback_locale_id, use_locale_fallback, source_locale_id, custom_metadata_filters, updated_since].hash
     end
 
     # Builds the object from hash

data/lib/phrase/models/upload_summary.rb

@@ -8,6 +8,7 @@ module Phrase
 
     attr_accessor :translation_keys_updated
 
+    # The number of translation keys in the project that were not mentioned in the upload.  Note: this field is not calculated (and shows 0) if the upload contains more than 10,000 keys. 
     attr_accessor :translation_keys_unmentioned
 
     attr_accessor :translations_created

data/lib/phrase/version.rb

@@ -1,3 +1,3 @@
 module Phrase
-  VERSION = '4.14.0'
+  VERSION = '4.15.0'
 end

data/lib/phrase.rb

@@ -24,6 +24,7 @@ require 'phrase/models/blacklisted_key'
 require 'phrase/models/blacklisted_key_create_parameters'
 require 'phrase/models/blacklisted_key_update_parameters'
 require 'phrase/models/branch'
+require 'phrase/models/branch_create_comparison_parameters'
 require 'phrase/models/branch_create_parameters'
 require 'phrase/models/branch_merge_parameters'
 require 'phrase/models/branch_name'

data/spec/api/automations_api_spec.rb

@@ -90,6 +90,20 @@ describe 'AutomationsApi' do
     end
   end
 
+  # unit tests for automation_trigger
+  # Trigger an automation
+  # Trigger an automation. 
+  # @param account_id Account ID
+  # @param id ID
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+  # @return [nil]
+  describe 'automation_trigger test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
   # unit tests for automation_update
   # Update an automation
   # Update an existing automation.  For feature availability, see [Jobs (Strings)](https://support.phrase.com/hc/en-us/articles/5784100517788-Jobs-Strings). 

data/spec/api/branches_api_spec.rb

@@ -22,7 +22,7 @@ describe 'BranchesApi' do
 
   # unit tests for branch_compare
   # Compare branches
-  # Compare branch with main branch.   *Note: Comparing a branch may take several minutes depending on the project size.* 
+  # Compare branch with main branch.  *Note: Comparing a branch may take several minutes depending on the project size. Consider using the `POST /compare` endpoint for creating comparison asynchronously.* 
   # @param project_id Project ID
   # @param name name
   # @param [Hash] opts the optional parameters
@@ -34,6 +34,21 @@ describe 'BranchesApi' do
     end
   end
 
+  # unit tests for branch_comparison_create
+  # Create comparison (async.)
+  # Create a branch comparison asynchronously. 
+  # @param project_id Project ID
+  # @param name name
+  # @param branch_create_comparison_parameters 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
+  # @return [nil]
+  describe 'branch_comparison_create test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
   # unit tests for branch_create
   # Create a branch
   # Create a new branch.  *Note: Creating a new branch may take several minutes depending on the project size.* 
@@ -93,7 +108,7 @@ describe 'BranchesApi' do
 
   # unit tests for branch_sync
   # Sync a branch
-  # Sync an existing branch.  *Note: Only available for branches created with new branching. New branching is currently in private beta* 
+  # Sync an existing branch.  *Note: Only available for branches created with new branching.* 
   # @param project_id Project ID
   # @param name name
   # @param branch_sync_parameters 

data/spec/api/jobs_api_spec.rb

@@ -133,6 +133,7 @@ describe 'JobsApi' do
   # @option opts [String] :x_phrase_app_otp Two-Factor-Authentication token (optional)
   # @option opts [String] :branch Branch to use
   # @option opts [Boolean] :include_annotations Include job-locale annotations in the response
+  # @option opts [Boolean] :omit_translation_keys Omit translation keys in the response to reduce payload size for bigger jobs
   # @return [JobDetails]
   describe 'job_show test' do
     it 'should work' do

data/spec/models/branch_create_comparison_parameters_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Phrase::BranchCreateComparisonParameters
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'BranchCreateComparisonParameters' do
+  before do
+    # run before each test
+    @instance = Phrase::BranchCreateComparisonParameters.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of BranchCreateComparisonParameters' do
+    it 'should create an instance of BranchCreateComparisonParameters' do
+      expect(@instance).to be_instance_of(Phrase::BranchCreateComparisonParameters)
+    end
+  end
+  describe 'test attribute "direction"' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end

data/spec/models/locale_download_create_parameters_spec.rb

@@ -98,6 +98,12 @@ describe 'LocaleDownloadCreateParameters' do
     end
   end
 
+  describe 'test attribute "use_locale_fallback"' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
   describe 'test attribute "source_locale_id"' do
     it 'should work' do
       # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phrase
 version: !ruby/object:Gem::Version
-  version: 4.14.0
+  version: 4.15.0
 platform: ruby
 authors:
 - Phrase
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-27 00:00:00.000000000 Z
+date: 2025-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -98,6 +98,7 @@ files:
 - docs/BlacklistedKeyUpdateParameters.md
 - docs/BlacklistedKeysApi.md
 - docs/Branch.md
+- docs/BranchCreateComparisonParameters.md
 - docs/BranchCreateParameters.md
 - docs/BranchMergeParameters.md
 - docs/BranchName.md
@@ -430,6 +431,7 @@ files:
 - lib/phrase/models/blacklisted_key_create_parameters.rb
 - lib/phrase/models/blacklisted_key_update_parameters.rb
 - lib/phrase/models/branch.rb
+- lib/phrase/models/branch_create_comparison_parameters.rb
 - lib/phrase/models/branch_create_parameters.rb
 - lib/phrase/models/branch_merge_parameters.rb
 - lib/phrase/models/branch_name.rb
@@ -709,6 +711,7 @@ files:
 - spec/models/blacklisted_key_create_parameters_spec.rb
 - spec/models/blacklisted_key_spec.rb
 - spec/models/blacklisted_key_update_parameters_spec.rb
+- spec/models/branch_create_comparison_parameters_spec.rb
 - spec/models/branch_create_parameters_spec.rb
 - spec/models/branch_merge_parameters_spec.rb
 - spec/models/branch_name_spec.rb
@@ -1202,6 +1205,7 @@ test_files:
 - spec/models/job_preview_spec.rb
 - spec/models/branch_spec.rb
 - spec/models/job_template_preview_spec.rb
+- spec/models/branch_create_comparison_parameters_spec.rb
 - spec/models/authorization_create_parameters_spec.rb
 - spec/models/team_detail_spec.rb
 - spec/models/translation_exclude_parameters_spec.rb