POST /2/tasks

Creates a new task.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
subscriptionAction String No

Action to perform on the Algolia index.

Possible values:

  • "replace"
  • "partial"
  • "save"
  • "append"
failureThreshold Integer No

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

action String Yes

Action to perform on the Algolia index.

Possible values:

  • "replace"
  • "partial"
  • "save"
  • "append"
input No

Configuration of the task, depending on its type.

enabled Boolean No

Whether the task is enabled.

destinationID String Yes

Universally unique identifier (UUID) of a destination resource.

notifications Object No

Notifications settings for a task.

notifications.email Object Yes
notifications.email.enabled Boolean No

Whether to send email notifications, note that this doesn't prevent the task from being blocked.

sourceID String Yes

Universally uniqud identifier (UUID) of a source.

cron String No

Cron expression for the task's schedule.

cursor String No

Date of the last cursor in RFC 3339 format.

policies Object No

Set of rules for a task.

policies.criticalThreshold Integer No

The number of critical failures in a row before blocking the task and sending a notification.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.