feat(specs): add new ingestion property for push (#5007)

Author: shortcuts

specs/ingestion/paths/push.yml

@@ -20,6 +20,12 @@ post:
   parameters:
     - $ref: '../../common/parameters.yml#/IndexName'
     - $ref: '../common/parameters.yml#/watch'
+    - name: referenceIndexName
+      in: query
+      description: This is required when targeting an index that does not have a push connector setup (e.g. a tmp index), but you wish to attach another index's transformation to it (e.g. the source index name).
+      required: false
+      schema:
+        type: string
   requestBody:
     content:
       application/json:

templates/java/api_helpers.mustache

@@ -738,6 +738,7 @@ public <T> WatchResponse saveObjectsWithTransformation(
       indexName,
       new PushTaskPayload().setAction(com.algolia.model.ingestion.Action.ADD_OBJECT).setRecords(this.objectsToPushTaskRecords(objects)),
       waitForTasks,
+      null,
       requestOptions
     );
 }
@@ -983,6 +984,7 @@ public <T> WatchResponse partialUpdateObjectsWithTransformation(
         )
         .setRecords(this.objectsToPushTaskRecords(objects)),
       waitForTasks,
+      null,
       requestOptions
     );
 }

tests/CTS/requests/ingestion/push.json

@@ -58,13 +58,15 @@
           }
         ]
       },
-      "watch": true
+      "watch": true,
+      "referenceIndexName": "foo"
     },
     "request": {
       "path": "/1/push/bar",
       "method": "POST",
       "queryParameters": {
-        "watch": "true"
+        "watch": "true",
+        "referenceIndexName": "foo"
       },
       "body": {
         "action": "addObject",