Replace items in bulk

put/v1/data/{workspace_id}/collections/{collection_id}/items/batch

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Replace several items with one request. For each item, send its ID and the replacement object.

These examples use a Person collection with firstName and lastName properties. Use your collection's itemsType and property keys.

Each array entry pairs an item ID with its data: ["item_id", {...}].

The request is all-or-nothing: if any item fails, none of the changes are saved.

info

Every item ID must exist. If one is missing, the whole request fails.

A successful request returns 204 No Content with no response body.

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/data/workspace_example/collections/collection_example/items/batch"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = [["item_example", {
    "@type": "Person",
    "firstName": "John",
    "lastName": "Malkovich"
}], ["item_other", {
    "@type": "Person",
    "firstName": "John",
    "lastName": "Malkovich"
}]]

response = requests.put(url, headers=headers, json=payload)

print(response.text)

Response

204

No response body.