phrase 4.25.0 → 4.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6cad43dbdeb14af43039a96509f173dcd8c3358bbaab868cb16cf04cb4fc05f
-  data.tar.gz: 3721a11b575861aad15b88d6dd410dd826405f57178286542dc37149de357b73
+  metadata.gz: 950c760b4ff662d461dc3b5ee1c2490949e2754537a02c512108ee2802eb6e37
+  data.tar.gz: 151f613ba922d317f0f492c9a3993cfe98718a68eaa64fe1f43709e9d98c2af0
 SHA512:
-  metadata.gz: 427e8f756767ed00efba125b3f5e168b51ec77b041e8aaa41d9af0a0a19a553a433941f5bc1988f2ab069c95170b8491fca8b4c5639c0590e94fe0eead400807
-  data.tar.gz: 1e52d069831312b3b82526499e19f6297e9e231e9b3106e6eb301277d667788d88753632cc8b76972be9bb219a0f34370224a14b054c60cfd413eba6bf09f1f8
+  metadata.gz: 921fc81ad5bf358718d0fe2bd1367c55511636c6291ce39b1298516ebe3f17efaa7ad0bd4361bba43cfc03fdea31147bab33bb88011f8e7517b9d433cc768a3d
+  data.tar.gz: c4cd0d523a362016d9aec722f94946d75969acf5f112d3a139aa843230d8672c189f193ca618eca790e9721099830ab0430cdeeaf6ba0a138092ce0e68324ab9

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [4.26.0](https://github.com/phrase/strings-openapi/compare/ruby-v4.25.0...ruby-v4.26.0) (2026-08-03)
+
+
+### Features
+
+* **API:** add automation events list endpoints #STRINGS-2826 ([#1227](https://github.com/phrase/strings-openapi/issues/1227)) ([c0ffc83](https://github.com/phrase/strings-openapi/commit/c0ffc839d71105d16b7633f8fea68ff08fbbb5fa))
+* **API:** add key format annotations list endpoint #STRINGS-3028 ([#1222](https://github.com/phrase/strings-openapi/issues/1222)) ([c43cc32](https://github.com/phrase/strings-openapi/commit/c43cc32cd6eadad3d7e2a49e31ca8f070033cf73))
+* **API:** add pre_translations resource to API ([#1224](https://github.com/phrase/strings-openapi/issues/1224)) ([d4ca2d0](https://github.com/phrase/strings-openapi/commit/d4ca2d0a1a47c10ac4b6f0bbe812b52d44974c5c))
+
+
+### Bug Fixes
+
+* **API:** extract cldr_version enum to fix TypeScript client build ([#1223](https://github.com/phrase/strings-openapi/issues/1223)) ([9a3aa7f](https://github.com/phrase/strings-openapi/commit/9a3aa7f8f1cb61676e554db5e72777a347805a53))
+* **API:** improve delete /projects/{project_id}/keys/{id}/key_links documentation ([#1193](https://github.com/phrase/strings-openapi/issues/1193)) ([b0b2e3f](https://github.com/phrase/strings-openapi/commit/b0b2e3f03407fb59dff1fd6004cf77d7a0aab503))
+* **API:** improve delete /projects/{project_id}/keys/{id}/key_links/{child_key_id} documentation ([#1194](https://github.com/phrase/strings-openapi/issues/1194)) ([c0055b4](https://github.com/phrase/strings-openapi/commit/c0055b46575dfdaec95ee6e13f59b68015493f8b))
+* **API:** improve get /projects/{project_id}/keys/{id}/key_links documentation ([#1188](https://github.com/phrase/strings-openapi/issues/1188)) ([41ae4c9](https://github.com/phrase/strings-openapi/commit/41ae4c93f946012032f41c4f206f53c97121d264))
+* **API:** improve post /icu/skeleton documentation ([#1187](https://github.com/phrase/strings-openapi/issues/1187)) ([1bbf2dc](https://github.com/phrase/strings-openapi/commit/1bbf2dcf6306742bc802ff12d9d6ae6962c4182e))
+* **ruby:** pin link-header-parser to >=7.0 and fix its new keyword arg ([#1229](https://github.com/phrase/strings-openapi/issues/1229)) ([34b7d82](https://github.com/phrase/strings-openapi/commit/34b7d8292cd0ea56da3c2f51d1fc76705b7910cd))
+
 ## [4.25.0](https://github.com/phrase/strings-openapi/compare/ruby-v4.24.0...ruby-v4.25.0) (2026-06-25)
 
 

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.25.0
+- Package version: 4.26.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.25.0.gem
+gem install ./phrase-4.26.0.gem
 ```
 
-(for development, run `gem install --dev ./phrase-4.25.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./phrase-4.26.0.gem` to install the development dependencies)
 
 ## Getting Started
 
@@ -137,6 +137,8 @@ Class | Method | HTTP request | Description
 *Phrase::AuthorizationsApi* | [**authorization_show**](docs/AuthorizationsApi.md#authorization_show) | **GET** /authorizations/{id} | Get a single authorization
 *Phrase::AuthorizationsApi* | [**authorization_update**](docs/AuthorizationsApi.md#authorization_update) | **PATCH** /authorizations/{id} | Update an authorization
 *Phrase::AuthorizationsApi* | [**authorizations_list**](docs/AuthorizationsApi.md#authorizations_list) | **GET** /authorizations | List authorizations
+*Phrase::AutomationEventsApi* | [**account_automation_events_list**](docs/AutomationEventsApi.md#account_automation_events_list) | **GET** /accounts/{account_id}/automation_events | List automation events for an account
+*Phrase::AutomationEventsApi* | [**automation_events_list**](docs/AutomationEventsApi.md#automation_events_list) | **GET** /accounts/{account_id}/automations/{automation_id}/events | List events for an automation
 *Phrase::AutomationsApi* | [**automation_activate**](docs/AutomationsApi.md#automation_activate) | **POST** /accounts/{account_id}/automations/{automation_id}/activate | Activate an automation
 *Phrase::AutomationsApi* | [**automation_create**](docs/AutomationsApi.md#automation_create) | **POST** /accounts/{account_id}/automations | Create an automation
 *Phrase::AutomationsApi* | [**automation_deactivate**](docs/AutomationsApi.md#automation_deactivate) | **POST** /accounts/{account_id}/automations/{automation_id}/deactivate | Deactivate an automation
@@ -258,6 +260,7 @@ Class | Method | HTTP request | Description
 *Phrase::JobsApi* | [**job_update**](docs/JobsApi.md#job_update) | **PATCH** /projects/{project_id}/jobs/{id} | Update a job
 *Phrase::JobsApi* | [**jobs_by_account**](docs/JobsApi.md#jobs_by_account) | **GET** /accounts/{account_id}/jobs | List account jobs
 *Phrase::JobsApi* | [**jobs_list**](docs/JobsApi.md#jobs_list) | **GET** /projects/{project_id}/jobs | List jobs
+*Phrase::KeyFormatAnnotationsApi* | [**key_format_annotations_list**](docs/KeyFormatAnnotationsApi.md#key_format_annotations_list) | **GET** /projects/{project_id}/keys/{id}/format_annotations | List format annotations for a key
 *Phrase::KeysApi* | [**key_create**](docs/KeysApi.md#key_create) | **POST** /projects/{project_id}/keys | Create a key
 *Phrase::KeysApi* | [**key_delete**](docs/KeysApi.md#key_delete) | **DELETE** /projects/{project_id}/keys/{id} | Delete a key
 *Phrase::KeysApi* | [**key_show**](docs/KeysApi.md#key_show) | **GET** /projects/{project_id}/keys/{id} | Get a single key
@@ -310,6 +313,9 @@ Class | Method | HTTP request | Description
 *Phrase::OrganizationJobTemplatesApi* | [**organization_job_template_update**](docs/OrganizationJobTemplatesApi.md#organization_job_template_update) | **PATCH** /accounts/{account_id}/job_templates/{id} | Update an organization job template
 *Phrase::OrganizationJobTemplatesApi* | [**organization_job_templates_list**](docs/OrganizationJobTemplatesApi.md#organization_job_templates_list) | **GET** /accounts/{account_id}/job_templates | List organization job templates
 *Phrase::OrganizationJobTemplatesApi* | [**organization_job_templates_show**](docs/OrganizationJobTemplatesApi.md#organization_job_templates_show) | **GET** /accounts/{account_id}/job_templates/{id} | Get a single organization job template
+*Phrase::PreTranslationsApi* | [**pre_translation_create**](docs/PreTranslationsApi.md#pre_translation_create) | **POST** /projects/{project_id}/pre_translations | Create a pre-translation job
+*Phrase::PreTranslationsApi* | [**pre_translation_show**](docs/PreTranslationsApi.md#pre_translation_show) | **GET** /projects/{project_id}/pre_translations/{id} | Get a single pre-translation job
+*Phrase::PreTranslationsApi* | [**pre_translations_list**](docs/PreTranslationsApi.md#pre_translations_list) | **GET** /projects/{project_id}/pre_translations | List pre-translation jobs
 *Phrase::ProjectsApi* | [**project_create**](docs/ProjectsApi.md#project_create) | **POST** /projects | Create a project
 *Phrase::ProjectsApi* | [**project_delete**](docs/ProjectsApi.md#project_delete) | **DELETE** /projects/{id} | Delete a project
 *Phrase::ProjectsApi* | [**project_show**](docs/ProjectsApi.md#project_show) | **GET** /projects/{id} | Get a single project
@@ -431,6 +437,8 @@ Class | Method | HTTP request | Description
  - [Phrase::AuthorizationUpdateParameters](docs/AuthorizationUpdateParameters.md)
  - [Phrase::AuthorizationWithToken](docs/AuthorizationWithToken.md)
  - [Phrase::Automation](docs/Automation.md)
+ - [Phrase::AutomationEvent](docs/AutomationEvent.md)
+ - [Phrase::AutomationEventProject](docs/AutomationEventProject.md)
  - [Phrase::AutomationsCreateParameters](docs/AutomationsCreateParameters.md)
  - [Phrase::AutomationsCreateParameters1](docs/AutomationsCreateParameters1.md)
  - [Phrase::BlacklistedKey](docs/BlacklistedKey.md)
@@ -482,6 +490,7 @@ Class | Method | HTTP request | Description
  - [Phrase::GlossaryTermUpdateParameters](docs/GlossaryTermUpdateParameters.md)
  - [Phrase::GlossaryUpdateParameters](docs/GlossaryUpdateParameters.md)
  - [Phrase::Icu](docs/Icu.md)
+ - [Phrase::IcuSkeletonError](docs/IcuSkeletonError.md)
  - [Phrase::IcuSkeletonParameters](docs/IcuSkeletonParameters.md)
  - [Phrase::Invitation](docs/Invitation.md)
  - [Phrase::InvitationCreateParameters](docs/InvitationCreateParameters.md)
@@ -518,10 +527,10 @@ Class | Method | HTTP request | Description
  - [Phrase::JobTemplateUpdateParameters](docs/JobTemplateUpdateParameters.md)
  - [Phrase::JobUpdateParameters](docs/JobUpdateParameters.md)
  - [Phrase::KeyCreateParameters](docs/KeyCreateParameters.md)
+ - [Phrase::KeyFormatAnnotationsList200ResponseInner](docs/KeyFormatAnnotationsList200ResponseInner.md)
  - [Phrase::KeyLink](docs/KeyLink.md)
  - [Phrase::KeyLinksBatchDestroyParameters](docs/KeyLinksBatchDestroyParameters.md)
  - [Phrase::KeyLinksCreateParameters](docs/KeyLinksCreateParameters.md)
- - [Phrase::KeyLinksIndex400Response](docs/KeyLinksIndex400Response.md)
  - [Phrase::KeyPreview](docs/KeyPreview.md)
  - [Phrase::KeyUpdateParameters](docs/KeyUpdateParameters.md)
  - [Phrase::KeysExcludeParameters](docs/KeysExcludeParameters.md)
@@ -560,6 +569,8 @@ Class | Method | HTTP request | Description
  - [Phrase::OrganizationJobTemplateLocaleUpdateParameters](docs/OrganizationJobTemplateLocaleUpdateParameters.md)
  - [Phrase::OrganizationJobTemplateLocalesCreateParameters](docs/OrganizationJobTemplateLocalesCreateParameters.md)
  - [Phrase::OrganizationJobTemplateUpdateParameters](docs/OrganizationJobTemplateUpdateParameters.md)
+ - [Phrase::PreTranslation](docs/PreTranslation.md)
+ - [Phrase::PreTranslationCreateParameters](docs/PreTranslationCreateParameters.md)
  - [Phrase::Project](docs/Project.md)
  - [Phrase::ProjectCreateParameters](docs/ProjectCreateParameters.md)
  - [Phrase::ProjectDetails](docs/ProjectDetails.md)

data/docs/AutomationEvent.md

@@ -0,0 +1,33 @@
+# Phrase::AutomationEvent
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | Unique identifier of the automation event. | [optional] 
+**automation_id** | **String** | Identifier of the automation that produced this event. | [optional] 
+**state** | **String** | Outcome of the automation run. | [optional] 
+**triggered_by** | **String** | What caused the automation to run. | [optional] 
+**created_at** | **Time** | Timestamp when the event was created. | [optional] 
+**jobs_created** | **Integer** | Number of jobs created during this automation run. | [optional] 
+**job_ids** | **Array<String>** | Identifiers of the jobs created during this automation run. | [optional] 
+**project** | [**AutomationEventProject**](AutomationEventProject.md) |  | [optional] 
+**details** | **String** | Error message describing the failure when state is `failure`; null otherwise. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::AutomationEvent.new(id: null,
+                                 automation_id: null,
+                                 state: null,
+                                 triggered_by: null,
+                                 created_at: null,
+                                 jobs_created: null,
+                                 job_ids: null,
+                                 project: null,
+                                 details: null)
+```
+
+

data/docs/AutomationEventProject.md

@@ -0,0 +1,19 @@
+# Phrase::AutomationEventProject
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | Project identifier. | [optional] 
+**name** | **String** | Project name. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::AutomationEventProject.new(id: null,
+                                 name: null)
+```
+
+

data/docs/AutomationEventsApi.md

@@ -0,0 +1,168 @@
+# Phrase::AutomationEventsApi
+
+All URIs are relative to *https://api.phrase.com/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**account_automation_events_list**](AutomationEventsApi.md#account_automation_events_list) | **GET** /accounts/{account_id}/automation_events | List automation events for an account
+[**automation_events_list**](AutomationEventsApi.md#automation_events_list) | **GET** /accounts/{account_id}/automations/{automation_id}/events | List events for an automation
+
+
+
+## account_automation_events_list
+
+> Array<AutomationEvent> account_automation_events_list(account_id, opts)
+
+List automation events for an account
+
+Returns the run history across all automations in the account, newest-first.  Use `automation_id` to narrow results to a single automation. Use `project_id` or `project_ids` to narrow by project.  For feature availability, see [Jobs (Strings)](https://support.phrase.com/hc/en-us/articles/5784100517788-Jobs-Strings). 
+
+### 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::AutomationEventsApi.new
+account_id = 'account_id_example' # String | Account ID
+opts = {
+  x_phrase_app_otp: 'x_phrase_app_otp_example', # String | Two-Factor-Authentication token (optional)
+  page: 1, # Integer | Page number
+  per_page: 25, # Integer | Limit on the number of objects to be returned, between 1 and 100. 25 by default
+  automation_id: 'automation_id_example', # String | Filter events to a single automation by its ID.
+  state: 'success', # String | Filter events by outcome state. Unrecognized values are ignored.
+  triggered_by: 'manual', # String | Filter events by what triggered the automation run. Unrecognized values are ignored.
+  project_id: 'project_id_example', # String | Filter events by project ID. Accepts a single ID or a comma-separated list of IDs.
+  project_ids: ['inner_example'], # Array<String> | Filter events by one or more project IDs.
+  created_after: '2023-01-01T00:00:00Z', # String | Return only events created after this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time.
+  created_before: '2023-01-01T00:00:00Z' # String | Return only events created before this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time.
+}
+
+begin
+  #List automation events for an account
+  result = api_instance.account_automation_events_list(account_id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling AutomationEventsApi->account_automation_events_list: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **account_id** | **String**| Account ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+ **page** | **Integer**| Page number | [optional] 
+ **per_page** | **Integer**| Limit on the number of objects to be returned, between 1 and 100. 25 by default | [optional] 
+ **automation_id** | **String**| Filter events to a single automation by its ID. | [optional] 
+ **state** | **String**| Filter events by outcome state. Unrecognized values are ignored. | [optional] 
+ **triggered_by** | **String**| Filter events by what triggered the automation run. Unrecognized values are ignored. | [optional] 
+ **project_id** | **String**| Filter events by project ID. Accepts a single ID or a comma-separated list of IDs. | [optional] 
+ **project_ids** | [**Array&lt;String&gt;**](String.md)| Filter events by one or more project IDs. | [optional] 
+ **created_after** | **String**| Return only events created after this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time. | [optional] 
+ **created_before** | **String**| Return only events created before this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time. | [optional] 
+
+### Return type
+
+Response<([**Array&lt;AutomationEvent&gt;**](AutomationEvent.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## automation_events_list
+
+> Array&lt;AutomationEvent&gt; automation_events_list(account_id, id, opts)
+
+List events for an automation
+
+Returns the run history for a specific automation, newest-first.  For feature availability, see [Jobs (Strings)](https://support.phrase.com/hc/en-us/articles/5784100517788-Jobs-Strings). 
+
+### 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::AutomationEventsApi.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)
+  page: 1, # Integer | Page number
+  per_page: 25, # Integer | Limit on the number of objects to be returned, between 1 and 100. 25 by default
+  state: 'success', # String | Filter events by outcome state. Unrecognized values are ignored.
+  triggered_by: 'manual', # String | Filter events by what triggered the automation run. Unrecognized values are ignored.
+  project_id: 'project_id_example', # String | Filter events by project ID. Accepts a single ID or a comma-separated list of IDs.
+  project_ids: ['inner_example'], # Array<String> | Filter events by one or more project IDs.
+  created_after: '2023-01-01T00:00:00Z', # String | Return only events created after this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time.
+  created_before: '2023-01-01T00:00:00Z' # String | Return only events created before this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time.
+}
+
+begin
+  #List events for an automation
+  result = api_instance.automation_events_list(account_id, id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling AutomationEventsApi->automation_events_list: #{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] 
+ **page** | **Integer**| Page number | [optional] 
+ **per_page** | **Integer**| Limit on the number of objects to be returned, between 1 and 100. 25 by default | [optional] 
+ **state** | **String**| Filter events by outcome state. Unrecognized values are ignored. | [optional] 
+ **triggered_by** | **String**| Filter events by what triggered the automation run. Unrecognized values are ignored. | [optional] 
+ **project_id** | **String**| Filter events by project ID. Accepts a single ID or a comma-separated list of IDs. | [optional] 
+ **project_ids** | [**Array&lt;String&gt;**](String.md)| Filter events by one or more project IDs. | [optional] 
+ **created_after** | **String**| Return only events created after this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time. | [optional] 
+ **created_before** | **String**| Return only events created before this ISO 8601 timestamp. Returns 400 if the value is not a valid date-time. | [optional] 
+
+### Return type
+
+Response<([**Array&lt;AutomationEvent&gt;**](AutomationEvent.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/AutomationsCreateParameters.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **String** | name of the automation | 
 **trigger** | **String** |  | 
-**project_ids** | **Array<String>** | List of project IDs to associate with the automation. Currently, only the first ID in the array is used. The array format leaves room for future support of multiple projects.  | 
+**project_ids** | **Array<String>** | List of project IDs to associate with the automation. Providing more than one project ID requires the `advanced_job_automation` plan feature; accounts without this feature receive a 422 response with error field `project_ids`.  | 
 **job_template_id** | **String** | id of job template that the automation uses to create jobs from | [optional] 
 **status_filters** | **Array<String>** | Translation states used when selecting keys for a job.  States are derived from associated translations, not the keys themselves.  When review workflow is enabled, `ready_for_review` is internally treated as `translated`.  | 
 **tags** | **Array<String>** | used to filter which keys are added to jobs | [optional] 

data/docs/AutomationsCreateParameters1.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **String** | name of the automation | 
 **trigger** | **String** |  | 
-**project_ids** | **Array<String>** | List of project IDs to associate with the automation. Currently, only the first ID in the array is used. The array format leaves room for future support of multiple projects.  | 
+**project_ids** | **Array<String>** | List of project IDs to associate with the automation. Providing more than one project ID requires the `advanced_job_automation` plan feature; accounts without this feature receive a 422 response with error field `project_ids`.  | 
 **job_template_id** | **String** | id of job template that the automation uses to create jobs from | [optional] 
 **status_filters** | **Array<String>** | translation key statuses used to filter keys that are added to jobs | 
 **tags** | **Array<String>** | used to filter which keys are added to jobs | [optional] 

data/docs/DocumentsApi.md

@@ -15,7 +15,7 @@ Method | HTTP request | Description
 
 Delete document
 
-Delete an existing document.
+Permanently deletes a document and all of its associated translation segments from the project. Use this when you want to remove a document that is no longer needed; the deletion cannot be reversed and all associated segments will be lost. 
 
 ### Example
 
@@ -77,7 +77,7 @@ Response<(nil (empty response body))>
 
 List documents
 
-List all documents the current user has access to.
+Returns all documents in a project that the authenticated user has read access to. A Document is a source file — an HTML or DOCX file — that has been uploaded to Phrase Strings and whose content is segmented into translation keys for localization.  Use this endpoint to enumerate documents before downloading, previewing, or triggering translation workflows for individual files.  The q parameter performs a prefix match on the document name (case-insensitive). For example, passing q=invoice returns documents whose names begin with \"invoice\" but not documents containing \"invoice\" elsewhere in the name. 
 
 ### Example
 
@@ -101,7 +101,7 @@ opts = {
   x_phrase_app_otp: 'x_phrase_app_otp_example', # String | Two-Factor-Authentication token (optional)
   page: 1, # Integer | Page number
   per_page: 25, # Integer | Limit on the number of objects to be returned, between 1 and 100. 25 by default
-  q: 'invoice' # String | Search query. Filters documents by name (case-insensitive substring match).
+  q: 'invoice' # String | Filter documents by name prefix. Returns documents whose name starts with the given value (case-insensitive).
 }
 
 begin
@@ -122,7 +122,7 @@ Name | Type | Description  | Notes
  **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
  **page** | **Integer**| Page number | [optional] 
  **per_page** | **Integer**| Limit on the number of objects to be returned, between 1 and 100. 25 by default | [optional] 
- **q** | **String**| Search query. Filters documents by name (case-insensitive substring match). | [optional] 
+ **q** | **String**| Filter documents by name prefix. Returns documents whose name starts with the given value (case-insensitive). | [optional] 
 
 ### Return type
 

data/docs/ICUApi.md

@@ -14,7 +14,7 @@ Method | HTTP request | Description
 
 Build ICU skeletons
 
-Returns ICU skeletons for multiple locale codes based on a source content.
+Generates ICU (International Components for Unicode) message format skeletons for a given source string across one or more locales. An ICU skeleton strips the literal text from a pluralized or select message while preserving its structural rules — argument names, plural categories, select cases, and ordinal forms — adjusted to the pluralization rules of each requested locale.  Use this endpoint to normalize translation templates before importing them into locale files, or to validate that a source string carries the plural forms required by a target language.  Either `content` or `id` must be provided — supplying both or neither returns 400. When `id` is used and the referenced translation does not exist, the endpoint returns 404. When the source string is not valid ICU message format syntax, the endpoint returns 422 with an `error` field describing the parse failure. 
 
 ### Example
 

data/docs/IcuSkeletonError.md

@@ -0,0 +1,17 @@
+# Phrase::IcuSkeletonError
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**error** | **String** | Human-readable description of the ICU message format parse failure. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::IcuSkeletonError.new(error: Expected "#" but "x" found.)
+```
+
+

data/docs/IcuSkeletonParameters.md

@@ -4,24 +4,24 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**content** | **String** | Source content to derive skeletons from. Mutually exclusive with `id`; exactly one of the two must be provided.  | [optional] 
-**id** | **String** | Translation code to source content from. Mutually exclusive with `content`; exactly one of the two must be provided.  | [optional] 
-**locale_codes** | **Array<String>** | Locale codes | [optional] 
-**keep_content** | **Boolean** | Keep the content and add missing plural forms for each locale | [optional] 
-**zero_form_enabled** | **Boolean** | Indicates whether the zero form should be included or excluded in the returned skeletons | [optional] 
-**cldr_version** | **String** | Strings supports two CLDR variants, when it comes to pluralization rules. \\ You can choose which one you want to use when constructing the skeletons. Possible values \\ are `legacy` and `cldr_41`. Default value is `legacy`. | [optional] 
+**content** | **String** | Source ICU message string to derive skeletons from. Mutually exclusive with `id`; exactly one of the two must be provided.  | [optional] 
+**id** | **String** | Code of an existing translation to source content from. Mutually exclusive with `content`; exactly one of the two must be provided. Returns 404 when the translation does not exist.  | [optional] 
+**locale_codes** | **Array<String>** | Locale codes for which to generate skeletons. The pluralization rules of each locale determine which plural forms appear in the output.  | [optional] 
+**keep_content** | **Boolean** | When true, preserves the existing translation text in each plural form and adds any missing forms for the locale rather than stripping all literal content. | [optional] 
+**zero_form_enabled** | **Boolean** | When true, includes the zero plural form in the generated skeleton for locales that support it. | [optional] 
+**cldr_version** | **String** | Pluralization rule set to use when constructing skeletons. Pass `legacy` for pre-CLDR behaviour, or a CLDR version string such as `cldr48`. Defaults to the project's configured version when omitted. | [optional] 
 
 ## Code Sample
 
 ```ruby
 require 'Phrase'
 
-instance = Phrase::IcuSkeletonParameters.new(content: {number, plural, one {One} other {%{n}}},
+instance = Phrase::IcuSkeletonParameters.new(content: {count, plural, one {One item} other {# items}},
                                  id: abcd1234abcd1234abcd1234abcd1234,
-                                 locale_codes: ["en"],
-                                 keep_content: null,
-                                 zero_form_enabled: null,
-                                 cldr_version: cldr_41)
+                                 locale_codes: ["en","de"],
+                                 keep_content: false,
+                                 zero_form_enabled: false,
+                                 cldr_version: cldr48)
 ```
 
 

data/docs/JobsApi.md

@@ -768,7 +768,7 @@ opts = {
   owned_by: 'abcd1234cdef1234abcd1234cdef1234', # String | filter by user owning job
   assigned_to: 'abcd1234cdef1234abcd1234cdef1234', # String | filter by user assigned to job
   state: 'completed', # String | filter by state of job; valid states are: `draft`, `in_progress`, `completed`
-  updated_since: '2013-02-21T00:00:00.000Z' # String | filter by jobs updated since given date
+  updated_since: '2013-02-21T00:00:00Z' # String | filter by jobs updated since given date
 }
 
 begin
@@ -844,7 +844,7 @@ opts = {
   state: 'completed', # String | filter by state of job; valid states are: `draft`, `in_progress`, `completed`
   states: ['inner_example'], # Array<String> | Filter by multiple job states at once. Accepted values are the same as `state`. When supplied, `state` is ignored. Rejected with `400 Bad Request` if any value is unknown.
   key_id: 'abcd1234cdef1234abcd1234cdef1234', # String | Filter to jobs that include the translation key identified by this code (matches via the job's tags).
-  updated_since: '2013-02-21T00:00:00.000Z' # String | filter by jobs updated since given date
+  updated_since: '2013-02-21T00:00:00Z' # String | filter by jobs updated since given date
 }
 
 begin

data/docs/KeyCreateParameters.md

@@ -40,7 +40,7 @@ instance = Phrase::KeyCreateParameters.new(branch: my-feature-branch,
                                  data_type: number,
                                  tags: awesome-feature,needs-proofreading,
                                  max_characters_allowed: 140,
-                                 screenshot: [B@6d448772,
+                                 screenshot: [B@32a4284d,
                                  remove_screenshot: null,
                                  unformatted: null,
                                  default_translation_content: Default translation content,

data/docs/KeyFormatAnnotationsApi.md

@@ -0,0 +1,74 @@
+# Phrase::KeyFormatAnnotationsApi
+
+All URIs are relative to *https://api.phrase.com/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**key_format_annotations_list**](KeyFormatAnnotationsApi.md#key_format_annotations_list) | **GET** /projects/{project_id}/keys/{id}/format_annotations | List format annotations for a key
+
+
+
+## key_format_annotations_list
+
+> Array<KeyFormatAnnotationsList200ResponseInner> key_format_annotations_list(project_id, id, opts)
+
+List format annotations for a key
+
+Returns the format annotations stored on a translation key. Format annotations capture file-format data recorded when the key was imported — for example, an ARB placeholder block or an XLIFF note.  Results are limited to 1,000 entries. 
+
+### 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::KeyFormatAnnotationsApi.new
+project_id = 'project_id_example' # String | Project ID
+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
+}
+
+begin
+  #List format annotations for a key
+  result = api_instance.key_format_annotations_list(project_id, id, opts)
+  pp result
+rescue Phrase::ApiError => e
+  puts "Exception when calling KeyFormatAnnotationsApi->key_format_annotations_list: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **project_id** | **String**| Project ID | 
+ **id** | **String**| ID | 
+ **x_phrase_app_otp** | **String**| Two-Factor-Authentication token (optional) | [optional] 
+ **branch** | **String**| Branch to use | [optional] 
+
+### Return type
+
+Response<([**Array&lt;KeyFormatAnnotationsList200ResponseInner&gt;**](KeyFormatAnnotationsList200ResponseInner.md))>
+
+### Authorization
+
+[Basic](../README.md#Basic), [Token](../README.md#Token)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/KeyFormatAnnotationsList200ResponseInner.md

@@ -0,0 +1,19 @@
+# Phrase::KeyFormatAnnotationsList200ResponseInner
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**file_format** | **String** | The file format that produced this annotation.  | [optional] 
+**original_representation** | **String** | The original file-format snippet captured when the key was imported. Returned as-is, may contain multi-line content.  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'Phrase'
+
+instance = Phrase::KeyFormatAnnotationsList200ResponseInner.new(file_format: xliff_2,
+                                 original_representation: <note category="meaning">header</note>)
+```
+
+

data/docs/KeyLinksBatchDestroyParameters.md

@@ -4,16 +4,18 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**child_key_ids** | **Array<String>** | The IDs of the child keys to unlink from the parent key. | 
-**unlink_parent** | **Boolean** | Whether to unlink the parent key as well and unmark it as linked-key. | [optional] [default to false]
+**child_key_ids** | **Array<String>** | Codes of the child keys to unlink. Required when unlink_parent is false or omitted. Ignored when unlink_parent is true. | 
+**unlink_parent** | **Boolean** | When true, dissolves the entire linked-key group by unlinking all children and removing the group. The child_key_ids field is ignored when this is set to true. | [optional] [default to false]
+**strategy** | **String** | Controls what happens to child key translation content after unlinking. keep_content (default) copies the parent translation into each child; remove_content clears each child translation. | [optional] [default to 'keep_content']
 
 ## Code Sample
 
 ```ruby
 require 'Phrase'
 
-instance = Phrase::KeyLinksBatchDestroyParameters.new(child_key_ids: ["child_key_id1","child_key_id2"],
-                                 unlink_parent: null)
+instance = Phrase::KeyLinksBatchDestroyParameters.new(child_key_ids: ["feature.subtitle","nav.home"],
+                                 unlink_parent: null,
+                                 strategy: null)
 ```