feat(API): add pr_branch param to repo-sync export #SCD-594 (#978)

Author: BlumMichael

doc/compiled.json

@@ -22893,6 +22893,24 @@
             "$ref": "#/components/parameters/id"
           }
         ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "title": "repo_sync/export/parameters",
+                "properties": {
+                  "pr_branch": {
+                    "description": "Source branch to open a pull request from",
+                    "type": "string",
+                    "example": "my-feature-branch"
+                  }
+                }
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
             "description": "OK",
@@ -22928,11 +22946,11 @@
         "x-code-samples": [
           {
             "lang": "Curl",
-            "source": "curl \"https://api.phrase.com/v2/accounts/ab12cd34/repo_syncs/45ef6789/export\"\\\n  -u USERNAME_OR_ACCESS_TOKEN \\\n  -X POST \\\n  -H 'Content-Type: application/json'"
+            "source": "curl \"https://api.phrase.com/v2/accounts/ab12cd34/repo_syncs/45ef6789/export\" \\\n  -u USERNAME_OR_ACCESS_TOKEN \\\n  -X POST \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"pr_branch\":\"my-feature-branch\"}'"
           },
           {
             "lang": "CLI v2",
-            "source": "phrase repo_syncs export \\\n--id <repo_sync_id> \\\n--access_token <token>"
+            "source": "phrase repo_syncs export \\\n--id <repo_sync_id> \\\n--pr_branch my-feature-branch \\\n--access_token <token>"
           }
         ],
         "x-cli-version": "2.24"

paths/repo_syncs/export.yaml

@@ -12,6 +12,18 @@ parameters:
 - "$ref": "../../parameters.yaml#/X-PhraseApp-OTP"
 - "$ref": "../../parameters.yaml#/account_id"
 - "$ref": "../../parameters.yaml#/id"
+requestBody:
+  required: false
+  content:
+    application/json:
+      schema:
+        type: object
+        title: repo_sync/export/parameters
+        properties:
+          pr_branch:
+            description: Source branch to open a pull request from
+            type: string
+            example: my-feature-branch
 responses:
   '200':
     description: OK
@@ -35,13 +47,15 @@ responses:
 x-code-samples:
 - lang: Curl
   source: |-
-    curl "https://api.phrase.com/v2/accounts/ab12cd34/repo_syncs/45ef6789/export"\
+    curl "https://api.phrase.com/v2/accounts/ab12cd34/repo_syncs/45ef6789/export" \
       -u USERNAME_OR_ACCESS_TOKEN \
       -X POST \
-      -H 'Content-Type: application/json'
+      -H 'Content-Type: application/json' \
+      -d '{"pr_branch":"my-feature-branch"}'
 - lang: CLI v2
   source: |-
     phrase repo_syncs export \
     --id <repo_sync_id> \
+    --pr_branch my-feature-branch \
     --access_token <token>
 x-cli-version: '2.24'