feat(specs): add put task endpoint to ingestion api (generated)

algolia/api-clients-automation#5281

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Clément Vannicatte <[email protected]>

Author: algolia-bot

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

@@ -987,6 +987,25 @@ public class IngestionClient(
     )
   }
 
+  /**
+   * Fully updates a task by its ID, use partialUpdateTask if you only want to update a subset of fields.
+   * @param taskID Unique identifier of a task.
+   * @param taskReplace
+   * @param requestOptions additional request configuration.
+   */
+  public suspend fun replaceTask(taskID: String, taskReplace: TaskReplace, requestOptions: RequestOptions? = null): TaskUpdateResponse {
+    require(taskID.isNotBlank()) { "Parameter `taskID` is required when calling `replaceTask`." }
+    val requestConfig = RequestConfig(
+      method = RequestMethod.PUT,
+      path = listOf("2", "tasks", "$taskID"),
+      body = taskReplace,
+    )
+    return requester.execute(
+      requestConfig = requestConfig,
+      requestOptions = requestOptions,
+    )
+  }
+
   /**
    * Runs all tasks linked to a source, only available for Shopify, BigCommerce and commercetools sources. Creates one run per task.
    *
@@ -1338,7 +1357,7 @@ public class IngestionClient(
   }
 
   /**
-   * Updates a task by its ID.
+   * Partially updates a task by its ID.
    * @param taskID Unique identifier of a task.
    * @param taskUpdate
    * @param requestOptions additional request configuration.

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

@@ -0,0 +1,48 @@
+/** Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT. */
+package com.algolia.client.model.ingestion
+
+import kotlinx.serialization.*
+import kotlinx.serialization.json.*
+
+/**
+ * API request body for updating a task.
+ *
+ * @param destinationID Universally unique identifier (UUID) of a destination resource.
+ * @param action
+ * @param subscriptionAction
+ * @param cron Cron expression for the task's schedule.
+ * @param enabled Whether the task is enabled.
+ * @param failureThreshold Maximum accepted percentage of failures for a task run to finish successfully.
+ * @param input
+ * @param cursor Date of the last cursor in RFC 3339 format.
+ * @param notifications
+ * @param policies
+ */
+@Serializable
+public data class TaskReplace(
+
+  /** Universally unique identifier (UUID) of a destination resource. */
+  @SerialName(value = "destinationID") val destinationID: String,
+
+  @SerialName(value = "action") val action: ActionType,
+
+  @SerialName(value = "subscriptionAction") val subscriptionAction: ActionType? = null,
+
+  /** Cron expression for the task's schedule. */
+  @SerialName(value = "cron") val cron: String? = null,
+
+  /** Whether the task is enabled. */
+  @SerialName(value = "enabled") val enabled: Boolean? = null,
+
+  /** Maximum accepted percentage of failures for a task run to finish successfully. */
+  @SerialName(value = "failureThreshold") val failureThreshold: Int? = null,
+
+  @SerialName(value = "input") val input: TaskInput? = null,
+
+  /** Date of the last cursor in RFC 3339 format. */
+  @SerialName(value = "cursor") val cursor: String? = null,
+
+  @SerialName(value = "notifications") val notifications: Notifications? = null,
+
+  @SerialName(value = "policies") val policies: Policies? = null,
+)

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

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * API request body for updating a task.
+ * API request body for partially updating a task.
  *
  * @param destinationID Universally unique identifier (UUID) of a destination resource.
  * @param cron Cron expression for the task's schedule.