From 1099dcc3248633d11f5142f1f88f6b29c17e34a8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Ciesielski?= Date: Mon, 31 Aug 2026 11:40:50 +0000 Subject: [PATCH 1/2] docs(STRINGS-3241): document fallback_for_unverified_translations project setting Adds the already-implemented project-level fallback_for_unverified_translations setting to the Create/Update Project request bodies and the shared project details response schema (used by Show/Create/Update). The setting was fully wired up in strings-app but missing from the public API reference. --- doc/compiled.json | 15 +++++++++++++++ paths/projects/create.yaml | 4 ++++ paths/projects/update.yaml | 4 ++++ schemas/project_details.yaml | 4 ++++ 4 files changed, 27 insertions(+) diff --git a/doc/compiled.json b/doc/compiled.json index ba504c34b..0bf9dbaef 100644 --- a/doc/compiled.json +++ b/doc/compiled.json @@ -2301,6 +2301,10 @@ "type": "boolean", "example": false }, + "fallback_for_unverified_translations": { + "type": "boolean", + "example": false + }, "autocomplete_job_enabled": { "type": "boolean", "example": false @@ -2348,6 +2352,7 @@ "autotranslate_use_machine_translation": false, "autotranslate_use_translation_memory": true, "autotranslate_overwrite_unverified_translations": false, + "fallback_for_unverified_translations": false, "autocomplete_job_enabled": false, "default_encoding": "UTF-8", "cldr_version": "legacy", @@ -17935,6 +17940,11 @@ "type": "boolean", "example": true }, + "fallback_for_unverified_translations": { + "description": "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only.", + "type": "boolean", + "example": false + }, "autocomplete_job_enabled": { "description": "(Optional) Enable autocomplete-job behavior so that newly created keys and locales are automatically added to in-progress jobs.", "type": "boolean", @@ -18259,6 +18269,11 @@ "type": "boolean", "example": true }, + "fallback_for_unverified_translations": { + "description": "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only.", + "type": "boolean", + "example": false + }, "default_encoding": { "description": "(Optional) Sets the default encoding for Uploads. If you leave it empty, we will try to guess it automatically for you when you Upload a file. You can still override this value by setting the [`file_encoding`](/en/api/strings/uploads/upload-a-new-file) parameter for Uploads.", "type": "string", diff --git a/paths/projects/create.yaml b/paths/projects/create.yaml index 5d6d0e6b4..2e4302e1d 100644 --- a/paths/projects/create.yaml +++ b/paths/projects/create.yaml @@ -161,6 +161,10 @@ requestBody: description: "(Optional) Requires autotranslate_enabled to be true" type: boolean example: true + fallback_for_unverified_translations: + description: "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only." + type: boolean + example: false autocomplete_job_enabled: description: "(Optional) Enable autocomplete-job behavior so that newly created keys and locales are automatically added to in-progress jobs." type: boolean diff --git a/paths/projects/update.yaml b/paths/projects/update.yaml index f1161b286..891f2cd87 100644 --- a/paths/projects/update.yaml +++ b/paths/projects/update.yaml @@ -153,6 +153,10 @@ requestBody: description: "(Optional) Requires autotranslate_enabled to be true" type: boolean example: true + fallback_for_unverified_translations: + description: "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only." + type: boolean + example: false default_encoding: description: "(Optional) Sets the default encoding for Uploads. If you leave it empty, we will try to guess it automatically for you when you Upload a file. You can still override this value by setting the [`file_encoding`](/en/api/strings/uploads/upload-a-new-file) parameter for Uploads." type: string diff --git a/schemas/project_details.yaml b/schemas/project_details.yaml index e72afd129..9b373a5c9 100644 --- a/schemas/project_details.yaml +++ b/schemas/project_details.yaml @@ -51,6 +51,9 @@ project_details: autotranslate_overwrite_unverified_translations: type: boolean example: false + fallback_for_unverified_translations: + type: boolean + example: false autocomplete_job_enabled: type: boolean example: false @@ -90,6 +93,7 @@ project_details: autotranslate_use_machine_translation: false autotranslate_use_translation_memory: true autotranslate_overwrite_unverified_translations: false + fallback_for_unverified_translations: false autocomplete_job_enabled: false default_encoding: "UTF-8" cldr_version: "legacy" From 80b8454e3aea0e50d960669ccb855bd665c2dfd0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Ciesielski?= Date: Mon, 31 Aug 2026 11:53:23 +0000 Subject: [PATCH 2/2] docs(STRINGS-3241): use exact description text from ticket Use the description text specified verbatim in STRINGS-3241 instead of a reworded version. --- doc/compiled.json | 4 ++-- paths/projects/create.yaml | 2 +- paths/projects/update.yaml | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/compiled.json b/doc/compiled.json index 0bf9dbaef..09e53b17b 100644 --- a/doc/compiled.json +++ b/doc/compiled.json @@ -17941,7 +17941,7 @@ "example": true }, "fallback_for_unverified_translations": { - "description": "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only.", + "description": "(Optional) When enabled, the fallback locale's translation is used on export for unverified translations in addition to empty ones. Requires a fallback locale to be configured on the locale.", "type": "boolean", "example": false }, @@ -18270,7 +18270,7 @@ "example": true }, "fallback_for_unverified_translations": { - "description": "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only.", + "description": "(Optional) When enabled, the fallback locale's translation is used on export for unverified translations in addition to empty ones. Requires a fallback locale to be configured on the locale.", "type": "boolean", "example": false }, diff --git a/paths/projects/create.yaml b/paths/projects/create.yaml index 2e4302e1d..bbdb0dd65 100644 --- a/paths/projects/create.yaml +++ b/paths/projects/create.yaml @@ -162,7 +162,7 @@ requestBody: type: boolean example: true fallback_for_unverified_translations: - description: "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only." + description: "(Optional) When enabled, the fallback locale's translation is used on export for unverified translations in addition to empty ones. Requires a fallback locale to be configured on the locale." type: boolean example: false autocomplete_job_enabled: diff --git a/paths/projects/update.yaml b/paths/projects/update.yaml index 891f2cd87..99ed617b2 100644 --- a/paths/projects/update.yaml +++ b/paths/projects/update.yaml @@ -154,7 +154,7 @@ requestBody: type: boolean example: true fallback_for_unverified_translations: - description: "(Optional) When enabled, translations in a non-final state are replaced by the fallback locale's translation on export, in addition to empty translations. \"Non-final\" means `unverified` in the simple workflow, and additionally `translated` (awaiting review) in the review workflow. Requires a fallback locale to be configured on the locale. This is a persistent project-level default; the `fallback_for_unverified_translations` query parameter on locale downloads overrides it for a single request only." + description: "(Optional) When enabled, the fallback locale's translation is used on export for unverified translations in addition to empty ones. Requires a fallback locale to be configured on the locale." type: boolean example: false default_encoding: