feat(specs): add watch to pushTask ingestion

Author: shortcuts

specs/ingestion/paths/tasks/v2/pushTask.yml

@@ -10,6 +10,12 @@ post:
     - editSettings
   parameters:
     - $ref: '../../../common/parameters.yml#/pathTaskID'
+    - name: watch
+      in: query
+      description: When provided, the push operation will be synchronous and the API will wait for the ingestion to be finished before responding.
+      required: false
+      schema:
+        type: boolean
   requestBody:
     description: Request body of a Search API `batch` request that will be pushed in the Connectors pipeline.
     content:

tests/CTS/requests/ingestion/pushTask.json

@@ -37,5 +37,46 @@
         ]
       }
     }
+  },
+  {
+    "testName": "allows for watch query parameter",
+    "parameters": {
+      "taskID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
+      "watch": true,
+      "pushTaskPayload": {
+        "action": "addObject",
+        "records": [
+          {
+            "key": "bar",
+            "foo": "1",
+            "objectID": "o"
+          },
+          {
+            "key": "baz",
+            "foo": "2",
+            "objectID": "k"
+          }
+        ]
+      }
+    },
+    "request": {
+      "path": "/2/tasks/6c02aeb1-775e-418e-870b-1faccd4b2c0f/push?watch=true",
+      "method": "POST",
+      "body": {
+        "action": "addObject",
+        "records": [
+          {
+            "key": "bar",
+            "foo": "1",
+            "objectID": "o"
+          },
+          {
+            "key": "baz",
+            "foo": "2",
+            "objectID": "k"
+          }
+        ]
+      }
+    }
   }
 ]