phrase 4.31.0 → 4.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e6724c6ff679a6b5bf758aebb13329971c1314a748d5a3dd35c3a05bedd2671
-  data.tar.gz: a8b4984f2e8d8f0267fa38d5f2dfe2e272731e95d358989acd02b0ad7e1e975c
+  metadata.gz: cb68f3e7de65794408fd8af7a561ef3b36a2e2220a6d3e1fb1b70ad12b10ddda
+  data.tar.gz: 9c0223415b68d524ccc0583496b23351d6caaedb44f1cccd04e5088eff221ec4
 SHA512:
-  metadata.gz: 91ee6eed37dd400687a455c17d1adb210d78b5c2cb0fcaa45989d27761027c3af386a9775dfd4ae1985bc2707574cee70937c86252751e483e4dada3b6dd131b
-  data.tar.gz: 05aac28e2cfd862b514ba702130ccb2b83b20e2c3aa0496690cd27f80149f0ef43946debbacbd66819e5f257784291b6512e21a60d59205d926af899c0fe091d
+  metadata.gz: '08ba82de28c3449d6abd1db15b585667c0fffb054a230a351a8dcd5c8073617ab4c2d7315ca8bf2ed4a7acf8fb6e02ee736631bbb07806e1e1643371e875857c'
+  data.tar.gz: 24c734ba8c05035c02b10128f73ced9d4c442df9ac09d5184097cf66076095a202f1c3d9eb8d797286c0960e9ad213cc7931344ff1424ac801e7c22463652623

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [4.33.0](https://github.com/phrase/strings-openapi/compare/ruby-v4.32.0...ruby-v4.33.0) (2026-11-04)
+
+
+### Features
+
+* **API:** add exclude_linked_child_keys to jobs and job templates #STRINGS-4424 ([#1356](https://github.com/phrase/strings-openapi/issues/1356)) ([46690ee](https://github.com/phrase/strings-openapi/commit/46690ee15758d6d500aa5eec5e264f1686f50200))
+* **API:** add uploads array to repo sync import event show response #STRINGS-3739 ([#1342](https://github.com/phrase/strings-openapi/issues/1342)) ([b5a07de](https://github.com/phrase/strings-openapi/commit/b5a07decfa83958869e9ce9363d45646cc8fa523))
+
+## [4.32.0](https://github.com/phrase/strings-openapi/compare/ruby-v4.31.0...ruby-v4.32.0) (2026-10-22)
+
+
+### Features
+
+* **API:** add terms_count field to glossary responses #STRINGS-3924 ([#1334](https://github.com/phrase/strings-openapi/issues/1334)) ([9eab4dc](https://github.com/phrase/strings-openapi/commit/9eab4dcc28074b581934d603ec6f653efe100d72))
+
+
+### Bug Fixes
+
+* **API:** make clearable string fields on update endpoints nullable #STRINGS-3652 ([#1326](https://github.com/phrase/strings-openapi/issues/1326)) ([3eb4b6f](https://github.com/phrase/strings-openapi/commit/3eb4b6fe2481f5ad199ae5e3c88eaecabc4d62da))
+* **API:** make translation content and key description nullable #STRINGS-3652 ([#1325](https://github.com/phrase/strings-openapi/issues/1325)) ([2f18702](https://github.com/phrase/strings-openapi/commit/2f1870215d4c84a382ab3cfa76dd9f922dad5903))
+
 ## [4.31.0](https://github.com/phrase/strings-openapi/compare/ruby-v4.30.1...ruby-v4.31.0) (2026-10-22)
 
 

data/Gemfile

@@ -5,6 +5,6 @@ gemspec
 group :development, :test do
   gem 'rake', '~> 13.0.1'
   gem 'pry-byebug'
-  gem 'rubocop', '~> 0.66.0'
+  gem 'rubocop', '~> 1.0'
   gem 'webmock'
 end

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.31.0
+- Package version: 4.33.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.31.0.gem
+gem install ./phrase-4.33.0.gem
 ```
 
-(for development, run `gem install --dev ./phrase-4.31.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./phrase-4.33.0.gem` to install the development dependencies)
 
 ## Getting Started
 
@@ -608,6 +608,7 @@ Class | Method | HTTP request | Description
  - [Phrase::RepoSync](docs/RepoSync.md)
  - [Phrase::RepoSyncCreateParameters](docs/RepoSyncCreateParameters.md)
  - [Phrase::RepoSyncEvent](docs/RepoSyncEvent.md)
+ - [Phrase::RepoSyncEventUploadsInner](docs/RepoSyncEventUploadsInner.md)
  - [Phrase::RepoSyncExportParameters](docs/RepoSyncExportParameters.md)
  - [Phrase::RepoSyncImportParameters](docs/RepoSyncImportParameters.md)
  - [Phrase::Screenshot](docs/Screenshot.md)

data/docs/CustomMetadataPropertiesUpdateParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **String** | name of the property | [optional] 
 **project_ids** | **Array<String>** | ids of projects that the property belongs to | [optional] 
-**description** | **String** | description of property | [optional] 
+**description** | **String** | description of property. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **value_options** | **Array<String>** | value options of property (only applies to single or multi select properties) | [optional] 
 
 ## Code Sample

data/docs/Glossary.md

@@ -6,6 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **String** |  | [optional] 
 **name** | **String** |  | [optional] 
+**terms_count** | **Integer** | Number of terms in the glossary. | [optional] 
 **projects** | [**Array<ProjectShort>**](ProjectShort.md) |  | [optional] 
 **spaces** | [**Array<Space>**](Space.md) |  | [optional] 
 **created_at** | **Time** |  | [optional] 
@@ -18,6 +19,7 @@ require 'phrase'
 
 instance = Phrase::Glossary.new(id: nil,
                                  name: nil,
+                                 terms_count: 42,
                                  projects: nil,
                                  spaces: nil,
                                  created_at: nil,

data/docs/GlossaryTermUpdateParameters.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **term** | **String** | Glossary term | [optional] 
-**description** | **String** | Description of term | [optional] 
+**description** | **String** | Description of term. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **translatable** | **Boolean** | Indicates whether the term should be used for all languages or can be translated | [optional] 
 **case_sensitive** | **Boolean** | Indicates whether the term is case sensitive | [optional] 
 

data/docs/JobCreateParameters.md

@@ -14,8 +14,9 @@ Name | Type | Description | Notes
 **tags** | **Array<String>** | tags of keys that should be included within the job.  *Note: a tag matches every key currently carrying that tag, not just the ones you just tagged. For example, if hundreds of pre-existing keys already share the tag `myUploadTag`, adding it here pulls in every one of them, not only the key you just tagged. Use `translation_key_ids` to scope the job to specific keys instead.*  | [optional] 
 **translation_key_ids** | **Array<String>** | ids of keys that should be included within the job | [optional] 
 **target_locale_ids** | **Array<String>** | List of target locales for the job. Mutually exclusive with `job_template_id`. | [optional] 
-**job_template_id** | **String** | id of a job template you would like to model the created job after. Any manually added parameters will take preference over template attributes. Mutually exclusive with `target_locale_ids`. | [optional] 
+**job_template_id** | **String** | id of a job template you would like to model the created job after. Any manually added parameters will take preference over template attributes. Mutually exclusive with `target_locale_ids`. The calling user must have read access to the template; if the template exists but is not accessible, the request returns 404.  | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation. | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from the job. While enabled, linked child keys cannot be added to the job. Defaults to `false`. | [optional] 
 
 ## Code Sample
 
@@ -33,7 +34,8 @@ instance = Phrase::JobCreateParameters.new(branch: 'my-feature-branch',
                                  translation_key_ids: ["abcd1234cdef1234abcd1234cdef1234"],
                                  target_locale_ids: ["abcd1234cdef1234abcd1234cdef1234"],
                                  job_template_id: 'abcd1234cdef1234abcd1234cdef1234',
-                                 autotranslate: true)
+                                 autotranslate: true,
+                                 exclude_linked_child_keys: false)
 ```
 
 

data/docs/JobDetails.md

@@ -25,6 +25,7 @@ Name | Type | Description | Notes
 **keys** | [**Array<KeyPreview>**](KeyPreview.md) |  | [optional] 
 **annotations** | [**Array<JobAnnotationShort>**](JobAnnotationShort.md) | Returned only when `include_annotations=true` is supplied on the request. | [optional] 
 **locked** | **Boolean** | `true` if the job has been locked by the project's job-locking workflow (translations attached to the job are read-only until the job advances).  | [optional] 
+**exclude_linked_child_keys** | **Boolean** | `true` if linked child keys are excluded from this job. While enabled, linked child keys cannot be added to the job.  | [optional] 
 
 ## Code Sample
 
@@ -51,7 +52,8 @@ instance = Phrase::JobDetails.new(id: nil,
                                  locales: nil,
                                  keys: nil,
                                  annotations: nil,
-                                 locked: nil)
+                                 locked: nil,
+                                 exclude_linked_child_keys: false)
 ```
 
 

data/docs/JobTemplateCreateParameters.md

@@ -8,6 +8,7 @@ Name | Type | Description | Notes
 **name** | **String** | Job template name | 
 **briefing** | **String** | Briefing for the translators | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation. | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from jobs created from this template. Defaults to `false`. | [optional] 
 **source_locale_id** | **String** | The API id of the source language. This locale will be set as source locale for the job template. If not provided, the project default locale will be used. | [optional] 
 **owner_id** | **String** | Code of the account member to set as the job template owner. The referenced user must also be a member of the project; passing the code of an account member who is not a project member returns a 404. When omitted or blank, no owner is pre-set; the user who creates a job from this template is assigned as owner at job-creation time.  | [optional] 
 
@@ -20,6 +21,7 @@ instance = Phrase::JobTemplateCreateParameters.new(branch: 'my-feature-branch',
                                  name: 'template',
                                  briefing: 'text',
                                  autotranslate: true,
+                                 exclude_linked_child_keys: false,
                                  source_locale_id: 'abcd1234cdef1234abcd1234cdef1234',
                                  owner_id: nil)
 ```

data/docs/JobTemplateDetails.md

@@ -15,6 +15,7 @@ Name | Type | Description | Notes
 **owner** | [**UserPreview**](UserPreview.md) |  | [optional] 
 **creator** | [**UserPreview**](UserPreview.md) |  | [optional] 
 **locales** | [**Array<LocalePreview>**](LocalePreview.md) |  | [optional] 
+**exclude_linked_child_keys** | **Boolean** | `true` if jobs created from this template exclude linked child keys.  | [optional] 
 
 ## Code Sample
 
@@ -31,7 +32,8 @@ instance = Phrase::JobTemplateDetails.new(id: nil,
                                  updated_at: nil,
                                  owner: nil,
                                  creator: nil,
-                                 locales: nil)
+                                 locales: nil,
+                                 exclude_linked_child_keys: false)
 ```
 
 

data/docs/JobTemplateUpdateParameters.md

@@ -6,8 +6,9 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
 **name** | **String** | Job template name | 
-**briefing** | **String** | Briefing for the translators | [optional] 
+**briefing** | **String** | Briefing for the translators. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation. | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from jobs created from this template. | [optional] 
 **source_locale_id** | **String** | The API id of the source language. This locale will be set as source locale for the job template. If not provided, the project default locale will be used. | [optional] 
 **owner_id** | **String** | Code of the account member to set as the job template owner. The referenced user must also be a member of the project; passing the code of an account member who is not a project member returns a 404. Pass an empty string to clear a previously set owner; when blank, jobs created from this template will default to assigning the job creator as owner.  | [optional] 
 
@@ -20,6 +21,7 @@ instance = Phrase::JobTemplateUpdateParameters.new(branch: 'my-feature-branch',
                                  name: 'template',
                                  briefing: 'text',
                                  autotranslate: true,
+                                 exclude_linked_child_keys: false,
                                  source_locale_id: 'abcd1234cdef1234abcd1234cdef1234',
                                  owner_id: nil)
 ```

data/docs/JobUpdateParameters.md

@@ -5,12 +5,13 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **String** | Job name | [optional] 
-**briefing** | **String** | Briefing for the translators | [optional] 
+**briefing** | **String** | Briefing for the translators. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **due_date** | **Time** | Date the job should be finished | [optional] 
 **review_due_date** | **Time** | Date the review of the job should be finished. Must not be before `due_date`. | [optional] 
-**ticket_url** | **String** | URL to a ticket for this job (e.g. Jira, Trello) | [optional] 
+**ticket_url** | **String** | URL to a ticket for this job (e.g. Jira, Trello) Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **target_locale_ids** | **Array<String>** | List of target locales for the job. | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from the job. When set to `true`, linked child keys already in the job are removed and none can be added while the option is enabled. | [optional] 
 
 ## Code Sample
 
@@ -23,7 +24,8 @@ instance = Phrase::JobUpdateParameters.new(name: 'de',
                                  review_due_date: nil,
                                  ticket_url: 'https://example.atlassian.net/browse/FOO',
                                  target_locale_ids: ["abcd1234cdef1234abcd1234cdef1234"],
-                                 autotranslate: true)
+                                 autotranslate: true,
+                                 exclude_linked_child_keys: false)
 ```
 
 

data/docs/KeyUpdateParameters.md

@@ -6,10 +6,10 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
 **name** | **String** | Key name | [optional] 
-**description** | **String** | Key description (usually includes contextual information for translators) | [optional] 
+**description** | **String** | Key description (usually includes contextual information for translators). Send an empty string or `null` to clear the description; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **plural** | **Boolean** | Indicates whether key supports pluralization | [optional] 
 **use_ordinal_rules** | **Boolean** | Indicates whether key uses ordinal rules for pluralization | [optional] 
-**name_plural** | **String** | Plural name for the key (used in some file formats, e.g. Gettext) | [optional] 
+**name_plural** | **String** | Plural name for the key (used in some file formats, e.g. Gettext) Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **data_type** | **String** | Type of the key. Can be one of the following: string, number, boolean, array, markdown. | [optional] 
 **tags** | **String** | List of tags separated by comma to be associated with the key. | [optional] 
 **max_characters_allowed** | **Integer** | Max. number of characters translations for this key can have. | [optional] 
@@ -17,9 +17,9 @@ Name | Type | Description | Notes
 **remove_screenshot** | **Boolean** | Indicates whether the screenshot will be deleted. This parameter is deprecated. Please use the Screenshots endpoint instead. | [optional] 
 **unformatted** | **Boolean** | Indicates whether the key should be exported as \"unformatted\". Supported by Android XML and other formats. | [optional] 
 **xml_space_preserve** | **Boolean** | Indicates whether the key should be exported with \"xml:space=preserve\". Supported by several XML-based formats. | [optional] 
-**original_file** | **String** | Original file attribute. Used in some formats, e.g. XLIFF. | [optional] 
-**localized_format_string** | **String** | NSStringLocalizedFormatKey attribute. Used in .stringsdict format. | [optional] 
-**localized_format_key** | **String** | NSStringLocalizedFormatKey attribute. Used in .stringsdict format. | [optional] 
+**original_file** | **String** | Original file attribute. Used in some formats, e.g. XLIFF. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**localized_format_string** | **String** | NSStringLocalizedFormatKey attribute. Used in .stringsdict format. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**localized_format_key** | **String** | NSStringLocalizedFormatKey attribute. Used in .stringsdict format. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **custom_metadata** | **Object** | Updates/Creates custom metadata property name and value pairs to be associated with key. If you want to delete a custom metadata property, you can set its value to null. If you want to update a custom metadata property, you can set its value to the new value. | [optional] 
 **excluded_in_locales** | **Array<String>** | Locales for which translations of this key are excluded from exports. Pass an empty array to clear exclusions.  | [optional] 
 **format_value_type** | **String** | Override of the value type for the key in the export. Most useful for formats like Android XML that distinguish string vs. plural resources.  | [optional] 

data/docs/LocaleUpdateParameters.md

@@ -11,12 +11,12 @@ Name | Type | Description | Notes
 **main** | **Boolean** | Indicates whether locale is a main locale. Main locales are part of the [Verification System](https://support.phrase.com/hc/en-us/articles/5784094755484) feature. | [optional] 
 **rtl** | **Boolean** | Indicates whether locale is a RTL (Right-to-Left) locale. | [optional] 
 **source_locale_id** | **String** | Source locale. Can be the name or id of the locale. Preferred is id. | [optional] 
-**fallback_locale_id** | **String** | Fallback locale for empty translations. Can be a locale name or id. | [optional] 
+**fallback_locale_id** | **String** | Fallback locale for empty translations. Can be a locale name or id. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **unverify_new_translations** | **Boolean** | Indicates that new translations for this locale should be marked as unverified. Part of the [Advanced Workflows](https://support.phrase.com/hc/en-us/articles/5784094755484) feature. | [optional] 
 **unverify_updated_translations** | **Boolean** | Indicates that updated translations for this locale should be marked as unverified. Part of the [Advanced Workflows](https://support.phrase.com/hc/en-us/articles/5784094755484) feature. | [optional] 
 **unverify_on_source_changes** | **Boolean** | Indicates that translations for this locale should be marked as unverified when the source language has been changed. | [optional] 
 **autotranslate** | **Boolean** | If set, translations for this locale will be fetched automatically, right after creation. | [optional] 
-**language_ai_profile** | **String** | Identifier of the Language AI profile to use for this locale. | [optional] 
+**language_ai_profile** | **String** | Identifier of the Language AI profile to use for this locale. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 
 ## Code Sample
 

data/docs/OrganizationJobTemplateCreateParameters.md

@@ -7,6 +7,7 @@ Name | Type | Description | Notes
 **name** | **String** | Job template name | 
 **briefing** | **String** | Briefing for the translators | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation. | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from jobs created from this template. Defaults to `false`. | [optional] 
 **owner_id** | **String** | Code of the account member to set as the job template owner. When omitted or blank, no owner is pre-set; the user who creates a job from this template is assigned as its owner at job-creation time.  | [optional] 
 
 ## Code Sample
@@ -17,6 +18,7 @@ require 'phrase'
 instance = Phrase::OrganizationJobTemplateCreateParameters.new(name: 'template',
                                  briefing: 'text',
                                  autotranslate: true,
+                                 exclude_linked_child_keys: false,
                                  owner_id: nil)
 ```
 

data/docs/OrganizationJobTemplateDetails.md

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **owner** | [**UserPreview**](UserPreview.md) |  | [optional] 
 **creator** | [**UserPreview**](UserPreview.md) |  | [optional] 
 **locales** | [**Array<LocalePreview>**](LocalePreview.md) |  | [optional] 
+**exclude_linked_child_keys** | **Boolean** | `true` if jobs created from this template exclude linked child keys.  | [optional] 
 
 ## Code Sample
 
@@ -29,7 +30,8 @@ instance = Phrase::OrganizationJobTemplateDetails.new(id: nil,
                                  updated_at: nil,
                                  owner: nil,
                                  creator: nil,
-                                 locales: nil)
+                                 locales: nil,
+                                 exclude_linked_child_keys: false)
 ```
 
 

data/docs/OrganizationJobTemplateUpdateParameters.md

@@ -5,8 +5,9 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **String** | Job template name | 
-**briefing** | **String** | Briefing for the translators | [optional] 
+**briefing** | **String** | Briefing for the translators. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **autotranslate** | **Boolean** | Automatically translate the job using machine translation. | [optional] 
+**exclude_linked_child_keys** | **Boolean** | Exclude linked child keys from jobs created from this template. | [optional] 
 **owner_id** | **String** | Code of the account member to set as the job template owner. Pass an empty string to clear a previously set owner; when blank, the owner is set to null and jobs created from this template will default to assigning the job creator as owner.  | [optional] 
 
 ## Code Sample
@@ -17,6 +18,7 @@ require 'phrase'
 instance = Phrase::OrganizationJobTemplateUpdateParameters.new(name: 'template',
                                  briefing: 'text',
                                  autotranslate: true,
+                                 exclude_linked_child_keys: false,
                                  owner_id: nil)
 ```
 

data/docs/ProjectUpdateParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **account_id** | **String** | (Optional) ID of an account the requesting user belongs to. Used only to disambiguate the request context; the project itself cannot be moved between accounts through this endpoint.  | [optional] 
 **name** | **String** | (Optional) Name of the project | [optional] 
-**point_of_contact** | **String** | (Optional) User ID of the point of contact for the project. Pass `null` to unset. | [optional] 
+**point_of_contact** | **String** | (Optional) User ID of the point of contact for the project. Pass `null` or an empty string to unset. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **main_format** | **String** | (Optional) Main file format specified by its API Extension name. Used for locale downloads if no format is specified. For API Extension names of available file formats see [Format Guide](https://support.phrase.com/hc/en-us/sections/6111343326364) or our [Formats API Endpoint](#formats). | [optional] 
 **media** | **String** | (Optional) Main technology stack used in the project. It affects for example the suggested placeholder style. Predefined values include: `Ruby`, `JavaScript`, `AngularJS`, `React`, `iOS`, `Android`, `Python`, `PHP`, `Java`, `Go`, `Windows Phone`, `Rails`, `Node.js`, `.NET`, `Django`, `Symfony`, `Yii Framework`, `Zend Framework`, `Apple App Store Description`, `Google Play Description`, but it can also take any other value. | [optional] 
 **shares_translation_memory** | **Boolean** | (Optional) Indicates whether the project should share the account's translation memory | [optional] 

data/docs/ReleaseUpdateParameters.md

@@ -4,10 +4,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**description** | **String** | Description of the release | [optional] 
+**description** | **String** | Description of the release. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **platforms** | **Array<String>** | List of platforms the release should support. | [optional] 
-**app_min_version** | **String** | Minimum version of the app that the release supports in semver format | [optional] 
-**app_max_version** | **String** | Maximum version of the app that the release supports in semver format | [optional] 
+**app_min_version** | **String** | Minimum version of the app that the release supports in semver format. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**app_max_version** | **String** | Maximum version of the app that the release supports in semver format. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **branch** | **String** | Branch used for release | [optional] 
 
 ## Code Sample

data/docs/RepoSyncEvent.md

@@ -11,6 +11,7 @@ Name | Type | Description | Notes
 **pull_request_url** | **String** | URL of the pull request created on export | [optional] 
 **auto_import** | **Boolean** | Whether the import was triggered by the repo push event | [optional] 
 **errors** | **Array<String>** | List of error messages, in case of failure | [optional] 
+**uploads** | [**Array<RepoSyncEventUploadsInner>**](RepoSyncEventUploadsInner.md) | The uploads associated with this import event, or `null` if no upload batch has been created yet. Each entry identifies a single file upload by its public code (`id`) and its current public state (`state`). Present on show responses only; absent from list responses. Possible `state` values: `initialized`, `waiting_for_preview`, `processing`, `success`, `error`.  | [optional] 
 
 ## Code Sample
 
@@ -23,7 +24,8 @@ instance = Phrase::RepoSyncEvent.new(id: nil,
                                  status: nil,
                                  pull_request_url: nil,
                                  auto_import: nil,
-                                 errors: nil)
+                                 errors: nil,
+                                 uploads: nil)
 ```
 
 

data/docs/RepoSyncEventUploadsInner.md

@@ -0,0 +1,19 @@
+# Phrase::RepoSyncEventUploadsInner
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | The upload's public identifier (code). | [optional] 
+**state** | **String** | The upload's current public state. Multiple internal processing states are collapsed to `processing`; both internal error states are collapsed to `error`.  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'phrase'
+
+instance = Phrase::RepoSyncEventUploadsInner.new(id: 'abcd1234',
+                                 state: nil)
+```
+
+

data/docs/ScreenshotUpdateParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
 **name** | **String** | Name of the screenshot | [optional] 
-**description** | **String** | Description of the screenshot | [optional] 
+**description** | **String** | Description of the screenshot. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **filename** | **File** | Screenshot file | [optional] 
 
 ## Code Sample

data/docs/StyleguideUpdateParameters.md

@@ -5,18 +5,18 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **title** | **String** | Style guide title | [optional] 
-**audience** | **String** | Audience description | [optional] 
+**audience** | **String** | Audience description. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **target_audience** | **String** | Target audience for the translations. | [optional] 
 **grammatical_person** | **String** | Preferred grammatical person. | [optional] 
 **vocabulary_type** | **String** | Vocabulary register the translations should use. | [optional] 
-**business** | **String** | Description of the business | [optional] 
-**company_branding** | **String** | Company branding to remain consistent. | [optional] 
-**formatting** | **String** | Formatting requirements and character limitations. | [optional] 
-**glossary_terms** | **String** | List of terms and/or phrases that need to be translated consistently. | [optional] 
-**grammar_consistency** | **String** | Formal or informal pronouns, consistent conjugation, grammatical gender | [optional] 
-**literal_translation** | **String** | Can be one of: Cultural/Conversational, Literal, Neutral. | [optional] 
-**overall_tone** | **String** | Tone requirement descriptions | [optional] 
-**samples** | **String** | Provide links to sample product pages, FAQ pages, etc. to give the translator a point of reference. You can also provide past translations. Even snippets or short paragraphs are helpful for maintaining consistency. | [optional] 
+**business** | **String** | Description of the business. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**company_branding** | **String** | Company branding to remain consistent. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**formatting** | **String** | Formatting requirements and character limitations. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**glossary_terms** | **String** | List of terms and/or phrases that need to be translated consistently. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**grammar_consistency** | **String** | Formal or informal pronouns, consistent conjugation, grammatical gender. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**literal_translation** | **String** | Can be one of: Cultural/Conversational, Literal, Neutral. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**overall_tone** | **String** | Tone requirement descriptions. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
+**samples** | **String** | Provide links to sample product pages, FAQ pages, etc. to give the translator a point of reference. You can also provide past translations. Even snippets or short paragraphs are helpful for maintaining consistency. Send an empty string or `null` to clear the value; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 
 ## Code Sample
 

data/docs/TranslationUpdateParameters.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
-**content** | **String** | Translation content | [optional] 
+**content** | **String** | Translation content. Send an empty string or `null` to clear the translation's content; omit the field to leave it unchanged. The Phrase CLI drops `null` values before sending, so use an empty string there. | [optional] 
 **plural_suffix** | **String** | Plural suffix. Can be one of: zero, one, two, few, many, other. Must be specified if the key associated to the translation is pluralized. | [optional] 
 **unverified** | **Boolean** | Indicates whether translation is unverified. Part of the [Advanced Workflows](https://support.phrase.com/hc/en-us/articles/5784094755484) feature. | [optional] 
 **excluded** | **Boolean** | Indicates whether translation is excluded. | [optional] 

data/docs/TranslationsApi.md

@@ -643,7 +643,7 @@ opts = {
   branch: 'my-feature-branch', # String | specify the branch to use
   sort: 'updated_at', # String | Sort criteria. Can be one of: key_name, created_at, updated_at.
   order: 'desc', # String | Order direction. Can be one of: asc, desc.
-  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  The following qualifiers are supported in the query:  * `id:translation_id,...` for queries on a comma-separated list of ids * `unverified:{true|false}` for verification status * `tags:XYZ` for tags on the translation * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries  Find more examples [here](/en/api/strings/usage-examples). 
+  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * `id:translation_id,...` for queries on a comma-separated list of translation ids * `locale.id:locale_id,...` for queries on a comma-separated list of locale ids * `locale.name:locale_name,...` for queries on a comma-separated list of locale names * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples). 
 }
 
 begin
@@ -668,7 +668,7 @@ Name | Type | Description  | Notes
  **branch** | **String**| specify the branch to use | [optional] 
  **sort** | **String**| Sort criteria. Can be one of: key_name, created_at, updated_at. | [optional] 
  **order** | **String**| Order direction. Can be one of: asc, desc. | [optional] 
- **q** | **String**| Specify a query to find translations by content (including wildcards).  The following qualifiers are supported in the query:  * &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of ids * &#x60;unverified:{true|false}&#x60; for verification status * &#x60;tags:XYZ&#x60; for tags on the translation * &#x60;excluded:{true|false}&#x60; for exclusion status * &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
+ **q** | **String**| Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of translation ids * &#x60;locale.id:locale_id,...&#x60; for queries on a comma-separated list of locale ids * &#x60;locale.name:locale_name,...&#x60; for queries on a comma-separated list of locale names * &#x60;tags:XYZ&#x60; for tags on the translation * &#x60;unverified:{true|false}&#x60; for verification status * &#x60;excluded:{true|false}&#x60; for exclusion status * &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries * &#x60;reviewed_after:2013-02-21T00:00:00Z&#x60; for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
 
 ### Return type
 
@@ -718,7 +718,7 @@ opts = {
   branch: 'my-feature-branch', # String | specify the branch to use
   sort: 'updated_at', # String | Sort criteria. Can be one of: key_name, created_at, updated_at.
   order: 'desc', # String | Order direction. Can be one of: asc, desc.
-  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: - `id:translation_id,...` for queries on a comma-separated list of ids - `unverified:{true|false}` for verification status - `tags:XYZ` for tags on the translation - `excluded:{true|false}` for exclusion status - `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries  Find more examples [here](/en/api/strings/usage-examples). 
+  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * `id:translation_id,...` for queries on a comma-separated list of translation ids * `key.id:key_id,...` for queries on a comma-separated list of translation key ids * `key.name:key_name,...` for queries on a comma-separated list of translation key names * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples). 
 }
 
 begin
@@ -743,7 +743,7 @@ Name | Type | Description  | Notes
  **branch** | **String**| specify the branch to use | [optional] 
  **sort** | **String**| Sort criteria. Can be one of: key_name, created_at, updated_at. | [optional] 
  **order** | **String**| Order direction. Can be one of: asc, desc. | [optional] 
- **q** | **String**| Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: - &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of ids - &#x60;unverified:{true|false}&#x60; for verification status - &#x60;tags:XYZ&#x60; for tags on the translation - &#x60;excluded:{true|false}&#x60; for exclusion status - &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
+ **q** | **String**| Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of translation ids * &#x60;key.id:key_id,...&#x60; for queries on a comma-separated list of translation key ids * &#x60;key.name:key_name,...&#x60; for queries on a comma-separated list of translation key names * &#x60;tags:XYZ&#x60; for tags on the translation * &#x60;unverified:{true|false}&#x60; for verification status * &#x60;excluded:{true|false}&#x60; for exclusion status * &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries * &#x60;reviewed_after:2013-02-21T00:00:00Z&#x60; for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
 
 ### Return type
 
@@ -922,7 +922,7 @@ opts = {
   locale_id: 'abcd1234cdef1234abcd1234cdef1234', # String | Filter translations to those for the given locale (locale code or id). Equivalent to calling `GET /projects/{project_id}/locales/{locale_id}/translations`.
   sort: 'updated_at', # String | Sort criteria. Can be one of: key_name, created_at, updated_at.
   order: 'desc', # String | Order direction. Can be one of: asc, desc.
-  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query:  * `id:translation_id,...` for queries on a comma-separated list of ids * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples). 
+  q: 'PhraseApp*%20unverified:true%20excluded:true%20tags:feature,center' # String | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * `id:translation_id,...` for queries on a comma-separated list of translation ids * `key.id:key_id,...` for queries on a comma-separated list of translation key ids * `key.name:key_name,...` for queries on a comma-separated list of translation key names * `locale.id:locale_id,...` for queries on a comma-separated list of locale ids * `locale.name:locale_name,...` for queries on a comma-separated list of locale names * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples). 
 }
 
 begin
@@ -950,7 +950,7 @@ Name | Type | Description  | Notes
  **locale_id** | **String**| Filter translations to those for the given locale (locale code or id). Equivalent to calling &#x60;GET /projects/{project_id}/locales/{locale_id}/translations&#x60;. | [optional] 
  **sort** | **String**| Sort criteria. Can be one of: key_name, created_at, updated_at. | [optional] 
  **order** | **String**| Order direction. Can be one of: asc, desc. | [optional] 
- **q** | **String**| Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query:  * &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of ids * &#x60;tags:XYZ&#x60; for tags on the translation * &#x60;unverified:{true|false}&#x60; for verification status * &#x60;excluded:{true|false}&#x60; for exclusion status * &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries * &#x60;reviewed_after:2013-02-21T00:00:00Z&#x60; for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
+ **q** | **String**| Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * &#x60;id:translation_id,...&#x60; for queries on a comma-separated list of translation ids * &#x60;key.id:key_id,...&#x60; for queries on a comma-separated list of translation key ids * &#x60;key.name:key_name,...&#x60; for queries on a comma-separated list of translation key names * &#x60;locale.id:locale_id,...&#x60; for queries on a comma-separated list of locale ids * &#x60;locale.name:locale_name,...&#x60; for queries on a comma-separated list of locale names * &#x60;tags:XYZ&#x60; for tags on the translation * &#x60;unverified:{true|false}&#x60; for verification status * &#x60;excluded:{true|false}&#x60; for exclusion status * &#x60;updated_at:{&gt;&#x3D;|&lt;&#x3D;}2013-02-21T00:00:00Z&#x60; for date range queries * &#x60;reviewed_after:2013-02-21T00:00:00Z&#x60; for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
 
 ### Return type
 
@@ -1165,7 +1165,7 @@ Response<([**AffectedCount**](AffectedCount.md))>
 
 Unverify translations by query
 
-Mark translations matching query as unverified.
+Mark translations matching query as unverified.  To unverify the translations of specific keys, filter by key id (and optionally locale) directly, for example `key.id:KEY_ID_1,KEY_ID_2 locale.id:LOCALE_ID`. There is no need to look up translation ids first. 
 
 ### Example
 

data/docs/TranslationsExcludeParameters.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
-**q** | **String** | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query:  * `id:translation_id,...` for queries on a comma-separated list of ids * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
+**q** | **String** | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * `id:translation_id,...` for queries on a comma-separated list of translation ids * `key.id:key_id,...` for queries on a comma-separated list of translation key ids * `key.name:key_name,...` for queries on a comma-separated list of translation key names * `locale.id:locale_id,...` for queries on a comma-separated list of locale ids * `locale.name:locale_name,...` for queries on a comma-separated list of locale names * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
 **sort** | **String** | Sort criteria. Can be one of: key_name, created_at, updated_at. | [optional] 
 **order** | **String** | Order direction. Can be one of: asc, desc. | [optional] 
 
@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 require 'phrase'
 
 instance = Phrase::TranslationsExcludeParameters.new(branch: 'my-feature-branch',
-                                 q: 'PhraseApp*%20verified:true%20tags:feature,center',
+                                 q: 'key.name:home.title,home.subtitle locale.name:de-DE tags:feature',
                                  sort: 'updated_at',
                                  order: 'desc')
 ```

data/docs/TranslationsIncludeParameters.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **branch** | **String** | specify the branch to use | [optional] 
-**q** | **String** | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: - `id:translation_id,...` for queries on a comma-separated list of ids - `tags:XYZ` for tags on the translation - `unverified:{true|false}` for verification status - `excluded:{true|false}` for exclusion status - `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
+**q** | **String** | Specify a query to find translations by content (including wildcards).  *Note: Search is limited to 10000 results and may not include recently updated data (depending on the project size).*  The following qualifiers are supported in the query: * `id:translation_id,...` for queries on a comma-separated list of translation ids * `key.id:key_id,...` for queries on a comma-separated list of translation key ids * `key.name:key_name,...` for queries on a comma-separated list of translation key names * `locale.id:locale_id,...` for queries on a comma-separated list of locale ids * `locale.name:locale_name,...` for queries on a comma-separated list of locale names * `tags:XYZ` for tags on the translation * `unverified:{true|false}` for verification status * `excluded:{true|false}` for exclusion status * `updated_at:{>=|<=}2013-02-21T00:00:00Z` for date range queries * `reviewed_after:2013-02-21T00:00:00Z` for fetching translations that were reviewed after the given timestamp  Find more examples [here](/en/api/strings/usage-examples).  | [optional] 
 **sort** | **String** | Sort criteria. Can be one of: key_name, created_at, updated_at. | [optional] 
 **order** | **String** | Order direction. Can be one of: asc, desc. | [optional] 
 
@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 require 'phrase'
 
 instance = Phrase::TranslationsIncludeParameters.new(branch: 'my-feature-branch',
-                                 q: 'PhraseApp*%20verified:true%20tags:feature,center',
+                                 q: 'key.name:home.title,home.subtitle locale.name:de-DE tags:feature',
                                  sort: 'updated_at',
                                  order: 'desc')
 ```