feat(specs): document runMetadata parameter (generated)

algolia/api-clients-automation#5087

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Devin Beeuwkes <[email protected]>

Author: algolia-bot

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

@@ -1019,13 +1019,15 @@ public class IngestionClient(
    *   - deleteIndex
    *   - editSettings
    * @param taskID Unique identifier of a task.
+   * @param runTaskPayload
    * @param requestOptions additional request configuration.
    */
-  public suspend fun runTask(taskID: String, requestOptions: RequestOptions? = null): RunResponse {
+  public suspend fun runTask(taskID: String, runTaskPayload: RunTaskPayload? = null, requestOptions: RequestOptions? = null): RunResponse {
     require(taskID.isNotBlank()) { "Parameter `taskID` is required when calling `runTask`." }
     val requestConfig = RequestConfig(
       method = RequestMethod.POST,
       path = listOf("2", "tasks", "$taskID", "run"),
+      body = runTaskPayload,
     )
     return requester.execute(
       requestConfig = requestConfig,
@@ -1042,13 +1044,15 @@ public class IngestionClient(
    *   - editSettings
    * @deprecated
    * @param taskID Unique identifier of a task.
+   * @param runTaskPayload
    * @param requestOptions additional request configuration.
    */
-  public suspend fun runTaskV1(taskID: String, requestOptions: RequestOptions? = null): RunResponse {
+  public suspend fun runTaskV1(taskID: String, runTaskPayload: RunTaskPayload? = null, requestOptions: RequestOptions? = null): RunResponse {
     require(taskID.isNotBlank()) { "Parameter `taskID` is required when calling `runTaskV1`." }
     val requestConfig = RequestConfig(
       method = RequestMethod.POST,
       path = listOf("1", "tasks", "$taskID", "run"),
+      body = runTaskPayload,
     )
     return requester.execute(
       requestConfig = requestConfig,

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

@@ -11,6 +11,7 @@ import kotlinx.serialization.json.*
  * @param indexToExclude List of index names to exclude in reindex/update.
  * @param entityIDs List of entityIDs to update.
  * @param entityType
+ * @param runMetadata Additional information that will be passed to the created runs.
  */
 @Serializable
 public data class RunSourcePayload(
@@ -25,4 +26,7 @@ public data class RunSourcePayload(
   @SerialName(value = "entityIDs") val entityIDs: List<String>? = null,
 
   @SerialName(value = "entityType") val entityType: EntityType? = null,
+
+  /** Additional information that will be passed to the created runs. */
+  @SerialName(value = "runMetadata") val runMetadata: JsonObject? = null,
 )

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

@@ -0,0 +1,17 @@
+/** 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.*
+
+/**
+ * RunTaskPayload
+ *
+ * @param runMetadata Additional information that will be passed to the created run.
+ */
+@Serializable
+public data class RunTaskPayload(
+
+  /** Additional information that will be passed to the created run. */
+  @SerialName(value = "runMetadata") val runMetadata: JsonObject? = null,
+)