Update a task V1

Updates a task by its ID using the v1 endpoint, please use updateTask instead.

PATCH /1/tasks/{taskID}

curl

cURL

curl --request PATCH \
  --url https://data.us.algolia.com/1/tasks/6c02aeb1-775e-418e-870b-1faccd4b2c0f \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID' \
  --data '{"destinationID":"6c02aeb1-775e-418e-870b-1faccd4b2c0f","trigger":{"cron":"* * 1 * *"},"input":{"mapping":{"format":"mappingkit/v1","actions":[{"id":"lorem","enabled":true,"trigger":"lorem","fieldDirectives":[{"fieldKey":"lorem","value":{}}]}]}},"enabled":true,"failureThreshold":0}'

200

{
  "taskID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
  "updatedAt": "<string>"
}

Required ACL: addObject, deleteIndex, editSettings

Authorizations

x-algolia-application-id · string · header · required

Your Algolia application ID.

x-algolia-api-key · string · header · required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Path Parameters

taskID · string · required

Unique identifier of a task. Universally unique identifier (UUID) of a task.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

Body

application/json

API request body for updating a task using the V1 shape, please use methods and types that don't contain the V1 suffix.

destinationID · string

Universally unique identifier (UUID) of a destination resource.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

trigger · object

Trigger for a task update.

Show child attributes

trigger. cron · string · required

Cron expression for the task's schedule.

Example:

"* * 1 * *"

input · Streaming input · object

Configuration of the task, depending on its type.

Streaming input

Show child attributes

input. mapping · object · required

Transformations to apply to the source, serialized as a JSON string.

Show child attributes

input.mapping. format · enum<string> · required

Mapping format schema.

Available options: mappingkit/v1

input.mapping. actions · object[] · required

Show child attributes

input.mapping.actions. enabled · boolean · required

Whether this action has any effect.

input.mapping.actions. trigger · string · required

Condition which must be satisfied to apply the action. If this evaluates to false, the action is not applied, and the process attempts to apply the next action, if any.

input.mapping.actions. fieldDirectives · object[] · required

Show child attributes

input.mapping.actions.fieldDirectives. fieldKey · string · required

Destination field key.

input.mapping.actions.fieldDirectives. value · object · required

How the destination field should be resolved from the source.

input.mapping.actions. id · string

ID to uniquely identify this action.

enabled · boolean

Whether the task is enabled.

failureThreshold · integer

Maximum accepted percentage of failures for a task run to finish successfully.

Required range: 0 <= x <= 100

Response

200

application/json

OK

API response for updating a task.

taskID · string · required

Universally unique identifier (UUID) of a task.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

updatedAt · string · required

Date of last update in RFC 3339 format.