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

src/main/scala/algoliasearch/api/IngestionClient.scala

@@ -58,6 +58,7 @@ import algoliasearch.ingestion.Task
 import algoliasearch.ingestion.TaskCreate
 import algoliasearch.ingestion.TaskCreateResponse
 import algoliasearch.ingestion.TaskCreateV1
+import algoliasearch.ingestion.TaskReplace
 import algoliasearch.ingestion.TaskSearch
 import algoliasearch.ingestion.TaskSortKeys._
 import algoliasearch.ingestion.TaskUpdate
@@ -1302,6 +1303,26 @@ 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.
+    */
+  def replaceTask(taskID: String, taskReplace: TaskReplace, requestOptions: Option[RequestOptions] = None)(implicit
+      ec: ExecutionContext
+  ): Future[TaskUpdateResponse] = Future {
+    requireNotNull(taskID, "Parameter `taskID` is required when calling `replaceTask`.")
+    requireNotNull(taskReplace, "Parameter `taskReplace` is required when calling `replaceTask`.")
+
+    val request = HttpRequest
+      .builder()
+      .withMethod("PUT")
+      .withPath(s"/2/tasks/${escape(taskID)}")
+      .withBody(taskReplace)
+      .build()
+    execute[TaskUpdateResponse](request, requestOptions)
+  }
+
   /** Runs all tasks linked to a source, only available for Shopify, BigCommerce and commercetools sources. Creates one
     * run per task.
     *
@@ -1690,7 +1711,7 @@ class IngestionClient(
     execute[SourceUpdateResponse](request, requestOptions)
   }
 
-  /** Updates a task by its ID.
+  /** Partially updates a task by its ID.
     *
     * @param taskID
     *   Unique identifier of a task.

src/main/scala/algoliasearch/ingestion/TaskReplace.scala

@@ -0,0 +1,48 @@
+/** Ingestion API The Ingestion API lets you connect third-party services and platforms with Algolia and schedule tasks
+  * to ingest your data. The Ingestion API powers the no-code [data
+  * connectors](https://dashboard.algolia.com/connectors). ## Base URLs The base URLs for requests to the Ingestion API
+  * are: - `https://data.us.algolia.com` - `https://data.eu.algolia.com` Use the URL that matches your [analytics
+  * region](https://dashboard.algolia.com/account/infrastructure/analytics). **All requests must use HTTPS.** ##
+  * Authentication To authenticate your API requests, add these headers: - `x-algolia-application-id`. Your Algolia
+  * application ID. - `x-algolia-api-key`. An API key with the necessary permissions to make the request. The required
+  * access control list (ACL) to make a request is listed in each endpoint's reference. You can find your application ID
+  * and API key in the [Algolia dashboard](https://dashboard.algolia.com/account). ## Request format Request bodies must
+  * be JSON objects. ## Response status and errors Response bodies are JSON objects. Successful responses return a `2xx`
+  * status. Client errors return a `4xx` status. Server errors are indicated by a `5xx` status. Error responses have a
+  * `message` property with more information. ## Version The current version of the Ingestion API is version 1, as
+  * indicated by the `/1/` in each endpoint's URL.
+  *
+  * The version of the OpenAPI document: 1.0.0
+  *
+  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+  * https://openapi-generator.tech Do not edit the class manually.
+  */
+package algoliasearch.ingestion
+
+import algoliasearch.ingestion.ActionType._
+
+/** API request body for updating a task.
+  *
+  * @param destinationID
+  *   Universally unique identifier (UUID) of a destination resource.
+  * @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 cursor
+  *   Date of the last cursor in RFC 3339 format.
+  */
+case class TaskReplace(
+    destinationID: String,
+    action: ActionType,
+    subscriptionAction: Option[ActionType] = scala.None,
+    cron: Option[String] = scala.None,
+    enabled: Option[Boolean] = scala.None,
+    failureThreshold: Option[Int] = scala.None,
+    input: Option[TaskInput] = scala.None,
+    cursor: Option[String] = scala.None,
+    notifications: Option[Notifications] = scala.None,
+    policies: Option[Policies] = scala.None
+)

src/main/scala/algoliasearch/ingestion/TaskUpdate.scala

@@ -21,7 +21,7 @@ package algoliasearch.ingestion
 
 import algoliasearch.ingestion.ActionType._
 
-/** 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.