feat(API): Add "verify_mentioned_translations" parameter to uploads (#830)

Author: forelabs

clients/java/src/test/java/com/phrase/client/api/UploadsApiTest.java

@@ -107,6 +107,7 @@ public void uploadCreateTest() throws ApiException, IOException, InterruptedExce
         String fileEncoding = null;
         Object localeMapping = null;
         Boolean autotranslate = null;
+        Boolean verifyMentionedTranslations = null;
         Boolean markReviewed = null;
         Boolean tagOnlyAffectedKeys = null;
         String translationKeyPrefix = null;
@@ -122,7 +123,7 @@ public void uploadCreateTest() throws ApiException, IOException, InterruptedExce
         Upload response = api.uploadCreate(projectId, file, fileFormat, localeId, xPhraseAppOTP, branch,
             tags, updateTranslations, updateTranslationKeys, updateTranslationsOnSourceMatch,
             updateDescriptions, convertEmoji, skipUploadTags, skipUnverification, fileEncoding,
-            localeMapping, formatOptionsMap, autotranslate, markReviewed, tagOnlyAffectedKeys,
+            localeMapping, formatOptionsMap, autotranslate, verifyMentionedTranslations, markReviewed, tagOnlyAffectedKeys,
             translationKeyPrefix);
 
         Assert.assertEquals("valid id returned", "id_example", response.getId());

doc/compiled.json

@@ -14591,6 +14591,12 @@
                     "type": "boolean",
                     "example": null
                   },
+                  "verify_mentioned_translations": {
+                    "description": "Indicates whether all translations mentioned in the upload should be verified.",
+                    "type": "boolean",
+                    "default": false,
+                    "example": null
+                  },
                   "mark_reviewed": {
                     "description": "Indicated whether the imported translations should be marked as reviewed. This setting is available if the review workflow is enabled for the project.",
                     "type": "boolean",

paths/uploads/create.yaml

@@ -1,12 +1,11 @@
----
 summary: Upload a new file
 description: Upload a new language file. Creates necessary resources in your project.
 operationId: upload/create
 tags:
-- Uploads
+  - Uploads
 parameters:
-- "$ref": "../../parameters.yaml#/X-PhraseApp-OTP"
-- "$ref": "../../parameters.yaml#/project_id"
+  - "$ref": "../../parameters.yaml#/X-PhraseApp-OTP"
+  - "$ref": "../../parameters.yaml#/project_id"
 responses:
   '201':
     description: Created
@@ -28,30 +27,30 @@ responses:
   '429':
     "$ref": "../../responses.yaml#/429"
 x-code-samples:
-- lang: Curl
-  source: |-
-    curl "https://api.phrase.com/v2/projects/:project_id/uploads" \
-      -u USERNAME_OR_ACCESS_TOKEN \
-      -X POST \
-      -F branch=my-feature-branch \
-      -F file=@/path/to/my/file.json \
-      -F file_format=json \
-      -F locale_id=abcd1234cdef1234abcd1234cdef1234 \
-      -F tags=awesome-feature,needs-proofreading \
-      -F locale_mapping[en]=2 \
-      -F format_options[foo]=bar
-- lang: CLI v2
-  source: |-
-    phrase uploads create \
-    --project_id <project_id> \
-    --branch my-feature-branch \
-    --file /path/to/my/file.json \
-    --file_format json \
-    --locale_id abcd1234cdef1234abcd1234cdef1234 \
-    --tags awesome-feature,needs-proofreading \
-    --locale_mapping '{"en": "2"}' \
-    --format_options '{"foo": "bar"}' \
-    --access_token <token>
+  - lang: Curl
+    source: |-
+      curl "https://api.phrase.com/v2/projects/:project_id/uploads" \
+        -u USERNAME_OR_ACCESS_TOKEN \
+        -X POST \
+        -F branch=my-feature-branch \
+        -F file=@/path/to/my/file.json \
+        -F file_format=json \
+        -F locale_id=abcd1234cdef1234abcd1234cdef1234 \
+        -F tags=awesome-feature,needs-proofreading \
+        -F locale_mapping[en]=2 \
+        -F format_options[foo]=bar
+  - lang: CLI v2
+    source: |-
+      phrase uploads create \
+      --project_id <project_id> \
+      --branch my-feature-branch \
+      --file /path/to/my/file.json \
+      --file_format json \
+      --locale_id abcd1234cdef1234abcd1234cdef1234 \
+      --tags awesome-feature,needs-proofreading \
+      --locale_mapping '{"en": "2"}' \
+      --format_options '{"foo": "bar"}' \
+      --access_token <token>
 requestBody:
   required: true
   content:
@@ -134,6 +133,11 @@ requestBody:
             description: If set, translations for the uploaded language will be fetched automatically.
             type: boolean
             example:
+          verify_mentioned_translations:
+            description: Indicates whether all translations mentioned in the upload should be verified.
+            type: boolean
+            default: false
+            example:
           mark_reviewed:
             description: Indicated whether the imported translations should be marked as reviewed. This setting is available if the review workflow is enabled for the project.
             type: boolean