@wix/agent-skills 1.24.0 → 1.25.0

package/skills/wix-manage/references/cms/cms-data-items-crud.md

@@ -1,12 +1,12 @@
 ---
 name: "CMS Data Items CRUD"
-description: "Add, query, update, and delete items in CMS collections. Use this to insert content, bulk insert/update/patch/delete items, query with filters, and manage collection data. Key endpoints: /wix-data/v2/items, /wix-data/v2/bulk/items/*."
+description: "Add, query, update, and delete items in CMS collections, one at a time or in bulk. Also covers counting items, upserting with bulk save, truncating a collection, aggregating data with a pipeline, linking items through single- and multi-reference fields, and reading items with their referenced items expanded."
 ---
 # CMS Data Items CRUD
 
 > **Standard call shape (every curl below).** The `<AUTH>` placeholder is shorthand for `Authorization: Bearer <TOKEN>` only. Body-bearing requests also need `Content-Type: application/json`.
 
-This recipe covers basic Create, Read, Update, Delete (CRUD) operations for Wix CMS data items.
+This recipe covers Create, Read, Update, Delete (CRUD) operations for Wix CMS data items, plus count, upsert, truncate, aggregate, and reference-field links.
 
 ## Prerequisites
 
@@ -231,6 +231,8 @@ Unlike Update, this only modifies the specified fields — all other fields rema
 
 **Endpoint**: `POST https://www.wixapis.com/wix-data/v2/bulk/items/update`
 
+> There is no update-by-filter endpoint. To update the items matching a filter, query them first (see [Query Data Items](#query-data-items)), then send their ids to bulk update or bulk patch.
+
 > **Important**: Use `id` (not `_id`) at the element level. The `data` object should NOT contain `_id`.
 
 ```json
@@ -297,7 +299,7 @@ Unlike bulk update, this only modifies the specified fields - other fields remai
 }
 ```
 
-**Setting a reference field** (single REFERENCE only):
+**Setting a single `REFERENCE` field** (the value is one item ID; for `MULTI_REFERENCE` the value shape differs, see the next example):
 ```json
 {
   "dataCollectionId": "events",
@@ -318,26 +320,39 @@ Unlike bulk update, this only modifies the specified fields - other fields remai
 }
 ```
 
+**Setting a `MULTI_REFERENCE` field** (verified live): the value is an **array of item IDs**, and `SET_FIELD` **replaces the whole link set**. To add links without dropping the existing ones, use [Insert Multi-Reference Links](#insert-multi-reference-links) instead. A plain string, or `APPEND_TO_ARRAY`, fails per item with `WDE0303` inside a 200 bulk response — check `results[].itemMetadata`.
+```json
+{
+  "dataCollectionId": "Projects",
+  "patches": [
+    {
+      "dataItemId": "project-item-id",
+      "fieldModifications": [
+        {
+          "fieldPath": "team",
+          "action": "SET_FIELD",
+          "setFieldOptions": {
+            "value": ["alice-item-id", "bob-item-id"]
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
 **Available actions**: `SET_FIELD`, `REMOVE_FIELD`, `INCREMENT_FIELD`, `APPEND_TO_ARRAY`, `REMOVE_FROM_ARRAY`
 
 > **Common error**: If you get `WDE0080: patches must not be empty`, you sent `dataItems` instead of `patches`. Use the format above.
 
 > **Recommended**: Use bulk patch instead of bulk update when you only need to change specific fields.
 
-> **Reference Fields**:
-> - **Single REFERENCE**: CAN be set during insert/update by providing the referenced item's ID as the field value (e.g., `"venue": "venue-item-id"`)
-> - **MULTI_REFERENCE**: **STOP** - You cannot use this recipe for multi-reference fields. They cannot be set via insert/update/patch.
->
-> **For MULTI_REFERENCE operations (add speakers, assign tags, link categories, etc.):**
-> **READ [CMS References & Relationships](cms-references-and-relationships.md)** for the exact endpoints and request bodies:
-> - `POST https://www.wixapis.com/wix-data/v2/bulk/items/insert-references` - add references
-> - `POST https://www.wixapis.com/wix-data/v2/items/replace-references` - replace all references
-> - `POST https://www.wixapis.com/wix-data/v2/bulk/items/remove-references` - remove references
->
-> Error `WDE0303` occurs when attempting to set multi-reference fields via data operations.
+> **Reference fields**: a single `REFERENCE` field is set like any other value (`"venue": "venue-item-id"`, as above). `MULTI_REFERENCE` links are written only by a `SET_FIELD` patch (single or bulk) or by the reference endpoints in [Reference Fields](#reference-fields) below; insert, bulk insert, bulk save, PUT and bulk update all return 200 but silently drop multi-reference values (verified live) — read the item back after any of them.
 
 ## Delete Data Item
 
+> Deletes are irreversible. Confirm with the user before calling either delete endpoint unless the request already names the items to remove.
+
 **Endpoint**: `DELETE https://www.wixapis.com/wix-data/v2/items/{itemId}?dataCollectionId={collectionId}`
 
 ```bash
@@ -357,6 +372,225 @@ curl -X DELETE \
 }
 ```
 
+## Count Data Items
+
+Count items in a collection, optionally with filters.
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items/count`
+
+**Count All Items**:
+```json
+{
+  "dataCollectionId": "Products"
+}
+```
+
+**Response**:
+```json
+{
+  "totalCount": 42
+}
+```
+
+**Count with Filter**:
+```json
+{
+  "dataCollectionId": "Products",
+  "filter": {
+    "$and": [
+      { "inStock": true },
+      { "price": { "$gte": 50 } }
+    ]
+  }
+}
+```
+
+Count returns only `totalCount`. When the user needs to know *which* items match, run Query Data Items with the same filter instead of, or after, counting.
+
+## Bulk Save (Upsert)
+
+Insert new items or update existing items in a single operation. This is useful for syncing data.
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/bulk/items/save`
+
+```json
+{
+  "dataCollectionId": "Products",
+  "dataItems": [
+    {
+      "id": "existing-item-id",
+      "data": {
+        "title": "Updated Product",
+        "price": 199.99,
+        "inStock": true
+      }
+    },
+    {
+      "data": {
+        "title": "New Product",
+        "price": 79.99,
+        "inStock": true
+      }
+    }
+  ],
+  "returnEntity": true
+}
+```
+
+| Scenario | Action |
+|----------|--------|
+| No `id` provided | INSERT - Creates new item with generated ID |
+| `id` provided, doesn't exist | INSERT - Creates new item with provided ID |
+| `id` provided, exists | UPDATE - Replaces existing item |
+
+> **Warning**: When updating, the entire item is replaced. Include all fields you want to keep. Confirm with the user before saving over existing items.
+
+## Truncate Collection
+
+Remove all items from a collection.
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items/truncate`
+
+```json
+{
+  "dataCollectionId": "TestCollection"
+}
+```
+
+> **Warning**: This permanently deletes ALL items in the collection and cannot be undone. Ask the user to confirm before calling it.
+
+## Aggregate Data
+
+Perform calculations on collection data using a pipeline of sequential stages. The example shows one `group` stage; the full set of stages (`filter`, `group`, `sort`, `projection`, `unwindArray`, `skip`, `limit`) and accumulators is in the [Aggregate Pipeline Data Items reference](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/aggregate-pipeline-data-items).
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items/aggregate-pipeline`
+
+**Count by Category**:
+```json
+{
+  "dataCollectionId": "Products",
+  "pipeline": {
+    "stages": [
+      {
+        "group": {
+          "groupIds": [
+            {"key": "category", "expression": {"fieldPath": "category"}}
+          ],
+          "accumulators": [
+            {
+              "resultFieldName": "count",
+              "sum": {"expression": {"numeric": 1}}
+            }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## Operation Comparison
+
+| Operation | Use Case | Behavior |
+|-----------|----------|----------|
+| **Bulk Insert** | Add new items only | Fails if ID exists |
+| **Bulk Update** | Update existing items | Fails if ID doesn't exist, replaces entire item |
+| **Bulk Save** | Upsert (insert or update) | Creates or updates based on ID |
+| **Bulk Patch** | Partial update | Only modifies specified fields |
+
+## Reference Fields
+
+Reference fields link items across collections. A single `REFERENCE` field holds one item ID and is set like any other value in insert, update, or patch. A `MULTI_REFERENCE` field holds many links, and only two kinds of write create them: a `SET_FIELD` patch on the field (single or bulk), or the reference endpoints below, which add, replace, or remove links without touching the rest of the item. To add a reference field to a collection, see [Add a Reference Field](cms-schema-management.md#add-a-reference-field).
+
+> **Warning (verified live)**: writing IDs into a `MULTI_REFERENCE` field through insert, bulk insert, bulk save, or PUT update returns **200 and silently drops that field's value** — no error is raised. Bulk update is a full-item replace like PUT and does the same: `success: true`, value dropped (verified live, bulk save on both its insert and update paths). Never trust the write response for reference links: read the item back with `includeReferencedItems` and confirm the linked items are there.
+
+Linking flow, every time:
+
+1. Resolve the referring item ID and the referenced item IDs (query by a field value; never guess IDs).
+2. Write the links with the reference endpoints below, or with a `SET_FIELD` patch on the reference field. If the field already has links, `insert-references` adds without dropping them; `replace-references` and `SET_FIELD` discard the rest — confirm with the user before replacing unless the request says to.
+3. **Read the referring item back** with Query Data Items and `includeReferencedItems: ["<field>"]` (or `includeReferences: [{ "field": "<field>" }]`), and confirm the linked items are present. The write's 200 is not proof; only the read-back is.
+
+### Insert Multi-Reference Links
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/bulk/items/insert-references`
+
+```json
+{
+  "dataCollectionId": "Products",
+  "dataItemReferences": [
+    {
+      "referringItemId": "product-item-id",
+      "referringItemFieldName": "tags",
+      "referencedItemId": "tag-1-item-id"
+    },
+    {
+      "referringItemId": "product-item-id",
+      "referringItemFieldName": "tags",
+      "referencedItemId": "tag-2-item-id"
+    }
+  ],
+  "returnEntity": true
+}
+```
+
+### Replace All References
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items/replace-references`
+
+```json
+{
+  "dataCollectionId": "Products",
+  "referringItemId": "product-item-id",
+  "referringItemFieldName": "tags",
+  "newReferencedItemIds": ["new-tag-1-id", "new-tag-2-id", "new-tag-3-id"]
+}
+```
+
+> **Note**: To remove all references, pass an empty array for `newReferencedItemIds`.
+
+### Remove References (Bulk)
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/bulk/items/remove-references`
+
+```json
+{
+  "dataCollectionId": "Products",
+  "dataItemReferences": [
+    {
+      "referringItemId": "product-id-1",
+      "referringItemFieldName": "tags",
+      "referencedItemId": "tag-to-remove-id"
+    }
+  ]
+}
+```
+
+### Query with Referenced Items Expanded
+
+**Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items/query`
+
+```json
+{
+  "dataCollectionId": "Products",
+  "query": {
+    "filter": {
+      "inStock": true
+    }
+  },
+  "includeReferencedItems": ["category", "tags"]
+}
+```
+
+The method article documents the same expansion as `"includeReferences": [{ "field": "category" }, { "field": "tags", "limit": 50 }]`; both forms work (verified live). Either way the expanded value is an **array of item objects** (with `_id`, `name`, …), not an array of IDs. Without one of these properties a `MULTI_REFERENCE` field is absent from the returned item, and a single `REFERENCE` field is returned as the item ID string (it is stored on the item; verified live).
+
+### Reference Query Operators
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| `$eq` | Exact match (single reference) | `{ "category": "id" }` |
+| `$hasSome` | Has at least one of | `{ "tags": { "$hasSome": ["id1", "id2"] } }` |
+| `$hasAll` | Has all of | `{ "tags": { "$hasAll": ["id1", "id2"] } }` |
+
 ## Field Types Reference
 
 | Type | Description | Example Value |
@@ -379,7 +613,7 @@ curl -X DELETE \
 | `ARRAY_STRING` | Array of strings | `["tag1", "tag2"]` |
 | `OBJECT` | JSON object | `{"key": "value"}` |
 | `REFERENCE` | Single reference | Item ID string |
-| `MULTI_REFERENCE` | Multiple references, use separate *reference* endpoints to manipulate, `include` to include in queries | Array of IDs |
+| `MULTI_REFERENCE` | Multiple references. Write with a `SET_FIELD` patch (array of item IDs, replaces the set) or the *reference* endpoints (add / replace / remove); expand in queries with `includeReferencedItems` or `includeReferences` | Write: array of item IDs (`SET_FIELD`). Read: absent unless expanded with `includeReferencedItems` / `includeReferences`, then an array of item objects |
 
 ---
 
@@ -465,7 +699,7 @@ confirmation before performing the install.
 | `PERMISSION_DENIED` | Insufficient access | Check API permissions |
 | `WDE0007` | Bulk update: wrong ID field name | Use `id` not `_id` at element level |
 | `WDE0080` | Validation failed (multiple causes) | Bulk update: don't include `_id` in `data`; Bulk patch: use `patches` array not `dataItems` |
-| `WDE0303` | Can't set multi-reference field via data operations | Use reference endpoints: `insert-references`, `replace-references` |
+| `WDE0303` | Multi-reference field value is not an array of item IDs (a single ID string, or `APPEND_TO_ARRAY`); reported per item inside a 200 bulk response | Send `"value": ["id1", "id2"]` with `SET_FIELD`, or use the reference endpoints |
 | `WDE0110` | Wix CMS (Wix Data) application is not installed | Install application with appDefId: `e593b0bd-b783-45b8-97c2-873d42aacaf4` |
 
 ---
@@ -474,6 +708,4 @@ confirmation before performing the install.
 
 - [Data Items API Reference](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/introduction)
 - [CMS Schema Management](cms-schema-management.md) - Creating and modifying collections
-- [CMS References & Relationships](cms-references-and-relationships.md) - Linking collections
-- [CMS Data Operations Extended](cms-data-operations-extended.md) - Count, upsert, aggregate
 - [CMS Draft & Publish Workflow](cms-publishing-flow.md) - Collections gated behind a draft/publish (Draft Items plugin) workflow

package/skills/wix-manage/references/cms/cms-schema-management.md

@@ -1,6 +1,6 @@
 ---
 name: "CMS Schema Management"
-description: Create and modify CMS collection structures. Covers listing collections, creating collections with fields, adding/removing fields, and updating collection settings.
+description: Create and modify CMS collection structures. Covers listing collections, creating collections with fields, adding/removing fields (including single- and multi-reference fields that link two collections), and updating collection settings.
 ---
 # CMS Schema Management
 
@@ -86,6 +86,55 @@ curl -X GET \
 }
 ```
 
+### Add a Reference Field
+
+Same endpoint as above: `POST https://www.wixapis.com/wix-data/v2/collections/create-field`. The two bodies below differ only in `type` and `typeMetadata`; omitting `typeMetadata` fails with `WDE0075` (see Error Handling).
+
+| Type | Field Type | Relationship | Example |
+|------|------------|--------------|---------|
+| Single Reference | `REFERENCE` | One-to-one, Many-to-one | Product → Category |
+| Multi-Reference | `MULTI_REFERENCE` | One-to-many, Many-to-many | Product → Tags |
+
+**Single reference** — `typeMetadata.reference` names the referenced collection:
+
+```json
+{
+  "dataCollectionId": "Products",
+  "field": {
+    "key": "category",
+    "displayName": "Category",
+    "type": "REFERENCE",
+    "typeMetadata": {
+      "reference": {
+        "referencedCollectionId": "Categories"
+      }
+    }
+  }
+}
+```
+
+**Multi-reference** — `typeMetadata.multiReference` also names the field created on the other collection:
+
+```json
+{
+  "dataCollectionId": "Products",
+  "field": {
+    "key": "tags",
+    "displayName": "Tags",
+    "type": "MULTI_REFERENCE",
+    "typeMetadata": {
+      "multiReference": {
+        "referencedCollectionId": "Tags",
+        "referencingFieldKey": "products",
+        "referencingDisplayName": "Products"
+      }
+    }
+  }
+}
+```
+
+To link items through these fields, see [Reference Fields](cms-data-items-crud.md#reference-fields) in the CMS Data Items CRUD recipe.
+
 ## Delete a Field from Collection
 
 > **Warning**: This permanently deletes all data stored in this field across all items.
@@ -170,6 +219,8 @@ Don't delete and recreate a collection just to change its permissions — this f
 
 | Error | Cause | Solution |
 |-------|-------|----------|
+| `WDE0075` (`Metadata for Reference type field not provided`) | `create-field` with `type` REFERENCE or MULTI_REFERENCE but no `typeMetadata` | Send `typeMetadata.reference.referencedCollectionId` (or `typeMetadata.multiReference…`), see Add a Reference Field |
+| `WDE0075` (`Not recognized role provided in permissions`) | `PATCH /collections/{id}` with a `permissions` change | Use the full-replace `PUT /collections` (see Update Collection Settings) or the Data Permissions API |
 | `WDE0110` | Wix CMS (Wix Data) app is not installed on the site | Install it: `POST https://www.wixapis.com/apps-installer-service/v1/app-instance/install` with body `{"tenant":{"tenantType":"SITE","id":"<SITE_ID>"},"appInstance":{"appDefId":"e593b0bd-b783-45b8-97c2-873d42aacaf4"}}`, then retry. See the [Install Wix Apps recipe](../app-installation/install-wix-apps.md). |
 
 ## Related Documentation

package/skills/wix-manage/references/cms/cms-data-operations-extended.md

@@ -1,263 +0,0 @@
----
-name: "CMS Data Operations Extended"
-description: Additional CMS data operations including count, upsert (bulk save), and update by filter patterns.
----
-# CMS Data Operations Extended
-
-This recipe covers additional CMS data operations not included in the basic CRUD recipe.
-
-## Prerequisites
-
-1. Wix CMS enabled on the site
-2. Collections created with data
-3. API access with CMS permissions
-
-## Required APIs
-
-- **Data Items API**: [REST](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/introduction)
-
-## Count Data Items
-
-Count items in a collection, optionally with filters.
-
-**Endpoint**: `POST /wix-data/v2/items/count`
-
-**Count All Items**:
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/items/count' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products"
-}'
-```
-
-**Response**:
-```json
-{
-  "totalCount": 42
-}
-```
-
-**Count with Filter**:
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/items/count' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products",
-  "filter": {
-    "inStock": true
-  }
-}'
-```
-
-**Count with Complex Filter**:
-```json
-{
-  "dataCollectionId": "Products",
-  "filter": {
-    "$and": [
-      { "inStock": true },
-      { "price": { "$gte": 50 } }
-    ]
-  }
-}
-```
-
-## Bulk Save (Upsert)
-
-Insert new items or update existing items in a single operation. This is useful for syncing data.
-
-**Endpoint**: `POST /wix-data/v2/bulk/items/save`
-
-**Request Body**:
-```json
-{
-  "dataCollectionId": "Products",
-  "dataItems": [
-    {
-      "id": "existing-item-id",
-      "data": {
-        "title": "Updated Product",
-        "price": 199.99,
-        "inStock": true
-      }
-    },
-    {
-      "data": {
-        "title": "New Product",
-        "price": 79.99,
-        "inStock": true
-      }
-    }
-  ],
-  "returnEntity": true
-}
-```
-
-### Bulk Save Behavior
-
-| Scenario | Action |
-|----------|--------|
-| No `id` provided | INSERT - Creates new item with generated ID |
-| `id` provided, doesn't exist | INSERT - Creates new item with provided ID |
-| `id` provided, exists | UPDATE - Replaces existing item |
-
-> **Warning**: When updating, the entire item is replaced. Include all fields you want to keep.
-
-## Update by Filter Pattern
-
-Wix CMS doesn't have a direct "update by filter" API. Use this two-step pattern:
-
-### 3.1: Query Items to Update
-
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/items/query' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products",
-  "query": {
-    "filter": {
-      "category": "electronics"
-    }
-  }
-}'
-```
-
-### 3.2: Bulk Update Those Items
-
-> **Important**: Use `id` (not `_id`) at the element level. The `data` object should NOT contain `_id`.
-
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/bulk/items/update' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products",
-  "dataItems": [
-    {
-      "id": "item-1-from-query",
-      "data": {
-        "title": "Updated Title 1",
-        "price": 99.99,
-        "onSale": true
-      }
-    },
-    {
-      "id": "item-2-from-query",
-      "data": {
-        "title": "Updated Title 2",
-        "price": 149.99,
-        "onSale": true
-      }
-    }
-  ]
-}'
-```
-
-### Alternative: Bulk Patch (Partial Update)
-
-If you only want to update specific fields without replacing the entire item, use Bulk Patch:
-
-**Endpoint**: `POST /wix-data/v2/bulk/items/patch`
-
-> **Important**: This endpoint uses `patches` array with `fieldModifications`, NOT `dataItems`. Do not confuse with bulk update.
-
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/bulk/items/patch' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products",
-  "patches": [
-    {
-      "dataItemId": "item-1",
-      "fieldModifications": [
-        {
-          "fieldPath": "onSale",
-          "action": "SET_FIELD",
-          "setFieldOptions": {
-            "value": true
-          }
-        }
-      ]
-    }
-  ]
-}'
-```
-
-> **Common error**: If you get `WDE0080: patches must not be empty`, you sent `dataItems` instead of `patches`. Use the format above.
-
-## Truncate Collection
-
-Remove all items from a collection (dangerous operation).
-
-**Endpoint**: `POST /wix-data/v2/items/truncate`
-
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/items/truncate' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "TestCollection"
-}'
-```
-
-> **Warning**: This permanently deletes ALL items in the collection. Use with extreme caution.
-
-## Aggregate Data
-
-Perform calculations on collection data using a pipeline of sequential stages.
-
-**Endpoint**: `POST /wix-data/v2/items/aggregate-pipeline`
-
-**Count by Category**:
-```bash
-curl -X POST \
-'https://www.wixapis.com/wix-data/v2/items/aggregate-pipeline' \
--H 'Content-Type: application/json' \
--H 'Authorization: <AUTH>' \
--d '{
-  "dataCollectionId": "Products",
-  "pipeline": {
-    "stages": [
-      {
-        "group": {
-          "groupIds": [
-            {"key": "category", "expression": {"fieldPath": "category"}}
-          ],
-          "accumulators": [
-            {
-              "resultFieldName": "count",
-              "sum": {"expression": {"numeric": 1}}
-            }
-          ]
-        }
-      }
-    ]
-  }
-}'
-```
-
-## Operation Comparison
-
-| Operation | Use Case | Behavior |
-|-----------|----------|----------|
-| **Bulk Insert** | Add new items only | Fails if ID exists |
-| **Bulk Update** | Update existing items | Fails if ID doesn't exist, replaces entire item |
-| **Bulk Save** | Upsert (insert or update) | Creates or updates based on ID |
-| **Bulk Patch** | Partial update | Only modifies specified fields |
-
-## Related Documentation
-
-- [Data Items API Reference](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/introduction)
-- [CMS Operations Best Practices](cms-data-items-crud.md)
-- [CMS Schema Management](cms-schema-management.md)