Search for tasks

Searches for tasks.

POST /2/tasks/search

curl

cURL

curl --request POST \
  --url https://data.us.algolia.com/2/tasks/search \
  --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 '{"taskIDs":["6c02aeb1-775e-418e-870b-1faccd4b2c0f"]}'

200

[
  {
    "taskID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    "sourceID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    "destinationID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    "enabled": true,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "cron": "* * 1 * *",
    "lastRun": "<string>",
    "nextRun": "<string>",
    "owner": "<string>",
    "input": {
      "mapping": {
        "format": "mappingkit/v1",
        "actions": [
          {
            "enabled": true,
            "trigger": "<string>",
            "fieldDirectives": [
              {
                "fieldKey": "<string>",
                "value": {}
              }
            ],
            "id": "<string>"
          }
        ]
      }
    },
    "failureThreshold": 50,
    "action": "replace",
    "subscriptionAction": "replace",
    "cursor": "<string>",
    "notifications": {
      "email": {
        "enabled": true
      }
    },
    "policies": {
      "criticalThreshold": 5
    }
  }
]

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.

Body

application/json

taskIDs · string[] · required

Universally unique identifier (UUID) of a task.

Response

200

application/json

OK

taskID · string · required

Universally unique identifier (UUID) of a task.

Example:

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

sourceID · string · required

Universally uniqud identifier (UUID) of a source.

Example:

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

destinationID · string · required

Universally unique identifier (UUID) of a destination resource.

Example:

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

enabled · boolean · default: true · required

Whether the task is enabled.

createdAt · string · required

Date of creation in RFC 3339 format.

updatedAt · string · required

Date of last update in RFC 3339 format.

cron · string

Cron expression for the task's schedule.

Example:

"* * 1 * *"

lastRun · string

The last time the scheduled task ran in RFC 3339 format.

nextRun · string

The next scheduled run of the task in RFC 3339 format.

owner · string | null

Owner of the resource.

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.

failureThreshold · integer

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

Required range: 0 <= x <= 100

action · enum<string>

Action to perform on the Algolia index.

Available options: replace, save, partial, partialNoCreate, append

subscriptionAction · enum<string>

Action to perform on the Algolia index.

Available options: replace, save, partial, partialNoCreate, append

cursor · string

Date of the last cursor in RFC 3339 format.

notifications · object

Notifications settings for a task.

Show child attributes

notifications. email · emailNotifications · object · required

Show child attributes

notifications.email. enabled · boolean

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

policies · object

Set of rules for a task.

Show child attributes

policies. criticalThreshold · integer

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

Required range: 1 <= x <= 10