Items

Create items in bulk

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

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Create several items with one request. Send an array of Item objects, as shown below.

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

You can supply createdAt and @id for each item, or let the API generate them. An existing @id returns 400 IntegrityError. A successful request returns 201 Created with the created item IDs.

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

Request

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 = [{
    "@type": "Person",
    "firstName": "John",
    "lastName": "Malkovich"
}, {
    "@type": "Person",
    "firstName": "John",
    "lastName": "Malkovich"
}]

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

print(response.text)

Response · illustrative example

{
  "@context": {
    "@vocab": "http://vocab.datablist.com/",
    "@import": "http://vocab.datablist.com/terms.jsonld"
  },
  "data": [
    {
      "@id": "item_example"
    },
    {
      "@id": "item_other"
    }
  ]
}