POST /1/indexes/*/batch

Adds, updates, or deletes records in multiple indices with a single API request.

This operation is subject to indexing rate limits.

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
requests[] Array Yes
requests[].action String Yes

Which indexing operation to perform:

  • addObject: adds records to an index. Equivalent to the "Add a new record (with auto-generated object ID)" operation.
  • updateObject: adds or replaces records in an index. Equivalent to the "Add or replace a record" operation.
  • partialUpdateObject: adds or updates attributes within records. Equivalent to the "Add or update attributes" operation with the createIfNoExists parameter set to true. (If a record with the specified objectID doesn't exist in the specified index, this action creates adds the record to the index)
  • partialUpdateObjectNoCreate: same as partialUpdateObject, but with createIfNoExists set to false. (A record isn't added to the index if its objectID doesn't exist)
  • deleteObject: delete records from an index. Equivalent to the "Delete a record" operation.
  • delete. Delete an index. Equivalent to the "Delete an index" operation.
  • clear: delete all records from an index. Equivalent to the "Delete all records from an index operation".

Valid values:

  • "clear"
  • "addObject"
  • "partialUpdateObjectNoCreate"
  • "deleteObject"
  • "updateObject"
  • "partialUpdateObject"
  • "delete"
requests[].body Object No

Operation arguments (varies with specified action).

requests[].indexName String Yes

Index name (case-sensitive).

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.