feat(specs): add global push endpoint (generated)

algolia/api-clients-automation#4855

Co-authored-by: algolia-bot <accounts+algolia-api-client-bot@algolia.com>
Co-authored-by: Clément Vannicatte <vannicattec@gmail.com>

Author: algolia-bot

client/src/commonMain/kotlin/com/algolia/client/api/IngestionClient.kt

@@ -922,14 +922,46 @@ public class IngestionClient(
   }
 
   /**
-   * Push a `batch` request payload through the Pipeline. You can check the status of task pushes with the observability endpoints.
+   * Pushes records through the Pipeline, directly to an index. You can make the call synchronous by providing the `watch` parameter, for asynchronous calls, you can use the observability endpoints and/or debugger dashboard to see the status of your task. If you want to leverage the [pre-indexing data transformation](https://www.algolia.com/doc/guides/sending-and-managing-data/send-and-update-your-data/how-to/transform-your-data/), this is the recommended way of ingesting your records. This method is similar to `pushTask`, but requires an `indexName` instead of a `taskID`. If zero or many tasks are found, an error will be returned.
+   *
+   * Required API Key ACLs:
+   *   - addObject
+   *   - deleteIndex
+   *   - editSettings
+   * @param indexName Name of the index on which to perform the operation.
+   * @param pushTaskPayload
+   * @param watch When provided, the push operation will be synchronous and the API will wait for the ingestion to be finished before responding.
+   * @param requestOptions additional request configuration.
+   */
+  public suspend fun push(indexName: String, pushTaskPayload: PushTaskPayload, watch: Boolean? = null, requestOptions: RequestOptions? = null): WatchResponse {
+    require(indexName.isNotBlank()) { "Parameter `indexName` is required when calling `push`." }
+    val requestConfig = RequestConfig(
+      method = RequestMethod.POST,
+      path = listOf("1", "push", "$indexName"),
+      query = buildMap {
+        watch?.let { put("watch", it) }
+      },
+      body = pushTaskPayload,
+    )
+    return requester.execute(
+      requestConfig = requestConfig,
+      requestOptions = RequestOptions(
+        readTimeout = 180000.milliseconds,
+        writeTimeout = 180000.milliseconds,
+        connectTimeout = 180000.milliseconds,
+      ) + requestOptions,
+    )
+  }
+
+  /**
+   * Pushes records through the Pipeline, directly to an index. You can make the call synchronous by providing the `watch` parameter, for asynchronous calls, you can use the observability endpoints and/or debugger dashboard to see the status of your task. If you want to leverage the [pre-indexing data transformation](https://www.algolia.com/doc/guides/sending-and-managing-data/send-and-update-your-data/how-to/transform-your-data/), this is the recommended way of ingesting your records. This method is similar to `push`, but requires a `taskID` instead of a `indexName`, which is useful when many `destinations` target the same `indexName`.
    *
    * Required API Key ACLs:
    *   - addObject
    *   - deleteIndex
    *   - editSettings
    * @param taskID Unique identifier of a task.
-   * @param pushTaskPayload Request body of a Search API `batch` request that will be pushed in the Connectors pipeline.
+   * @param pushTaskPayload
    * @param watch When provided, the push operation will be synchronous and the API will wait for the ingestion to be finished before responding.
    * @param requestOptions additional request configuration.
    */

client/src/commonMain/kotlin/com/algolia/client/model/ingestion/Action.kt

@@ -19,16 +19,7 @@ public enum class Action(public val value: kotlin.String) {
   PartialUpdateObject("partialUpdateObject"),
 
   @SerialName(value = "partialUpdateObjectNoCreate")
-  PartialUpdateObjectNoCreate("partialUpdateObjectNoCreate"),
-
-  @SerialName(value = "deleteObject")
-  DeleteObject("deleteObject"),
-
-  @SerialName(value = "delete")
-  Delete("delete"),
-
-  @SerialName(value = "clear")
-  Clear("clear");
+  PartialUpdateObjectNoCreate("partialUpdateObjectNoCreate");
 
   override fun toString(): kotlin.String = value
 }