Insert Data Item

Adds an item to a collection.

Call this method when you want a create-only operation. If the supplied dataItem.id already exists in the collection, the request fails. For different behavior, you can call:

• Bulk Insert Data Items to add multiple items in one call.
• Save Data Item for upsert behavior, meaning to create missing items and update existing items with the same stable ID.

An item can only be inserted into an existing collection. You can create a new collection using the Data Collections API.

When an item is inserted into a collection, the item's ID is automatically assigned a random value. You can optionally provide a custom ID in dataItem.id when inserting the item. If you specify an ID that already exists in the collection, the insertion will fail.

If dataItem.data is empty, a new item is created with no data fields.