POST

Bulk Update Data Items


Updates multiple items in a collection.

Call this method when you need to replace the full payload of multiple existing items in one call. For different behavior, you can call:

  • Bulk Patch Data Items to apply partial changes that keep unmentioned fields unchanged.
  • Bulk Patch Data Items with action: INCREMENT_FIELD for atomic numeric increments or decrements, such as stock-count deltas. Don't try to express deltas with Bulk Update — replacing the full payload forces a client-side read-then-write that isn't atomic and produces incorrect results under concurrent writers.
  • Save Data Item per item for upsert behavior, when some IDs may not exist yet.

This method replaces each specified data item's existing data with the payload provided in the request.

Each item in the request must include an ID. If an item is found in the specified collection with the same ID, that item is updated. If the collection doesn't contain an item with that ID, the update fails.

When an item is updated, its data._updatedDate field is changed to the current date and time.

Note: After each item is updated, it only contains the fields included in the request. If the existing item has fields with values and those fields aren't included in the updated item, their values are lost.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Write Data Items
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/wix-data/v2/bulk/items/update

Errors

This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?