@wix/bex-utils 2.115.0 → 2.117.0

package/@wix/ambassador-hub-v1-job/src/main/proto/com/wixpress/cloud/data/api/data/data-item-service.proto

@@ -0,0 +1,915 @@
+//flynt-disable missing-autovelo-def
+//flynt-disable permissions-naming
+//flynt-disable missing-audience
+//flynt-disable missing-crud-annotation
+syntax = "proto3";
+
+package com.wixpress.cloud.data.api.data;
+
+import "google/api/annotations.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "wix/api/permissions.proto";
+import "wix/api/entity.proto";
+import "wix/api/callback.proto";
+import "com/wixpress/cloud/data/api/data/message/aggregate.proto";
+import "com/wixpress/cloud/data/api/data/message/aggregate-pipeline.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-insert.proto";
+import "com/wixpress/cloud/data/api/data/message/patch-data-item.proto";
+import "com/wixpress/cloud/data/api/data/message/async-patch-by-filter.proto";
+import "com/wixpress/cloud/data/api/data/message/async-remove-by-filter.proto";
+import "com/wixpress/cloud/data/api/data/message/async-job-status.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-remove.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-save.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-update.proto";
+import "com/wixpress/cloud/data/api/data/message/count.proto";
+import "com/wixpress/cloud/data/api/data/message/distinct.proto";
+import "com/wixpress/cloud/data/api/data/message/get.proto";
+import "com/wixpress/cloud/data/api/data/message/insert.proto";
+import "com/wixpress/cloud/data/api/data/message/query.proto";
+import "com/wixpress/cloud/data/api/data/message/query-referenced.proto";
+import "com/wixpress/cloud/data/api/data/message/is-referenced.proto";
+import "com/wixpress/cloud/data/api/data/message/remove.proto";
+import "com/wixpress/cloud/data/api/data/message/save.proto";
+import "com/wixpress/cloud/data/api/data/message/truncate.proto";
+import "com/wixpress/cloud/data/api/data/message/update.proto";
+import "com/wixpress/cloud/data/api/data/message/insert-reference.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-insert-references.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-remove-references.proto";
+import "com/wixpress/cloud/data/api/data/message/remove-reference.proto";
+import "com/wixpress/cloud/data/api/data/message/replace-references.proto";
+import "com/wixpress/cloud/data/api/data/message/search.proto";
+import "com/wixpress/cloud/data/api/data/message/create-data-item-draft.proto";
+import "com/wixpress/cloud/data/api/data/message/publish-data-item-draft.proto";
+import "com/wixpress/cloud/data/api/data/message/unpublish-data-item.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-unpublish-data-items.proto";
+import "com/wixpress/cloud/data/api/data/message/bulk-publish-data-item-drafts.proto";
+
+// Access and manipulate data items in collections.
+service DataItemService {
+  option (wix.api.service_entity).message = "com.wixpress.cloud.data.api.data.DataItem";
+
+
+  // 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](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/bulk-insert-data-items) to add multiple items in one call.
+  // - [Save Data Item](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/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](https://dev.wix.com/api/rest/wix-data/wix-data/data-collections).
+  //
+  // 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.
+  rpc InsertDataItem (InsertDataItemRequest) returns (InsertDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items"
+    };
+    option (wix.api.permission).name = "WIX_DATA.INSERT";
+    option (wix.api.required) = "InsertDataItemRequest.data_collection_id";
+    option (wix.api.required) = "InsertDataItemRequest.data_item";
+
+    option (wix.api.emits) = {
+      event_type: CREATED
+    };
+  }
+
+  // Patches an item in a collection.
+  //
+  // Call this method when you need a partial update and want fields that aren't mentioned in the request to stay unchanged. Patch requests are also the right place to use `fieldModifications` actions such as `SET_FIELD` for a direct replacement and `INCREMENT_FIELD` for arithmetic changes. For different behavior, you can call:
+  //
+  // - [Update Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/update-data-item) to replace the full payload rather than patch part of it.
+  // - [Save Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/save-data-item) for upsert behavior, meaning to create if the item doesn't exist and update if it does.
+  //
+  // This method modifies the specified item's existing data. Unlike [`Update Data Item`](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/update-data-item), only the fields specified in the request are modified. Data that isn't explicitly modified remains unchanged.
+  //
+  // To patch an item, specify its ID, the ID of the collection that contains it, and the modifications you want to apply. If an item is found in the specified collection with the specified ID, that item is patched. If the collection doesn't contain an item with that ID, the request fails.
+  //
+  // > **Notes**:
+  // > - When an item is patched, its `data._updatedDate` property is updated to the current date and time.
+  // > - You can only patch items in [collections created by Wix users](https://support.wix.com/en/article/cms-formerly-content-manager-creating-a-collection). Items in [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code) cannot be patched.
+  rpc PatchDataItem (PatchDataItemRequest) returns (PatchDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      patch: "/v2/items/{patch.data_item_id}",
+      additional_bindings: {
+        post: "/v2/items/patch"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.PATCH";
+    option (wix.api.required) = "PatchDataItemRequest.data_collection_id";
+    option (wix.api.required) = "PatchDataItemRequest.patch";
+    option (wix.api.required) = "PatchDataItemRequest.patch.data_item_id";
+    option (wix.api.required) = "PatchDataItemRequest.patch.field_modifications";
+    option (wix.api.required) = "PatchDataItemRequest.patch.field_modifications.field_path";
+    option (wix.api.required) = "PatchDataItemRequest.patch.field_modifications.action";
+    option (wix.api.required) = "PatchDataItemRequest.patch.field_modifications.action_options.increment_field_options.value";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+  }
+
+  // Patches one or more items in a collection.
+  //
+  // Call this method when you need to apply partial changes to many items and want each item to keep fields that aren't mentioned in the request. This is also the right bulk surface for `fieldModifications` actions such as `SET_FIELD` and `INCREMENT_FIELD`: increments and decrements apply atomically on the server, so concurrent writers don't have to read the current value first or coordinate to avoid lost updates. For different behavior, you can call:
+  //
+  // - [Bulk Update Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-update-data-items) to replace each item's full payload rather than patch part of it.
+  // - [Save Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/save-data-item) per item for upsert behavior, meaning to create the item if its ID doesn't exist yet and update it if it does.
+  //
+  // This method modifies the existing data of one or more items. Unlike [`Bulk Update Data Item`](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-update-data-items), only the fields specified in the request are modified. Data that isn't explicitly modified remains unchanged.
+  //
+  // To patch items, specify the ID of the collection that contains them. For each item, specify its ID and the modifications you want to apply. If the item is found in the specified collection with the specified ID, that item is patched. If no such item is found, the response's `results` array contains a corresponding item whose `itemMetadata.error` property contains details about the error.
+  //
+  // Learn more about [Wix Data error codes](https://dev.wix.com/docs/rest/business-solutions/cms/wix-data-error-codes).
+  //
+  // > **Notes**:
+  // > - When an item is patched, its `data._updatedDate` property is updated to the current date and time.
+  // > - You can only patch items in [collections created by Wix users](https://support.wix.com/en/article/cms-formerly-content-manager-creating-a-collection). Items in [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code) cannot be patched.
+  // > - Calling this method triggers the [`Data Item Updated`](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/data-item-updated) event for each patched item.
+  rpc BulkPatchDataItems (BulkPatchDataItemsRequest) returns (BulkPatchDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/patch"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_PATCH";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches.data_item_id";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches.field_modifications";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches.field_modifications.field_path";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches.field_modifications.action";
+    option (wix.api.required) = "BulkPatchDataItemsRequest.patches.field_modifications.action_options.increment_field_options.value";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+  }
+
+  // Patches all data items matching a filter. Runs asynchronously.
+  //
+  //
+  // This method selects all items that match the specified filter and applies the given field modifications to each one.
+  // Unlike [Bulk Patch Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-patch-data-items), you don't need to specify individual item IDs. Instead, items are selected by filter.
+  //
+  // The operation runs asynchronously and returns a job ID for tracking status.
+  // Call [Get Async Job Status](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/get-async-job-status) with the returned job ID to poll for status.
+  //
+  // An empty `filter` patches all items in the collection.
+  //
+  // > **Notes:**
+  // > - The number of affected items is not bounded.
+  // > - If any item fails to be patched, the async job stops and its status becomes `FAILED`. Some items may already have been patched before the failure.
+  // > - Each patched item's `data._updatedDate` property is updated to the current date and time.
+  // > - Calling this method triggers the [Data Item Updated](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/data-item-updated) event for each patched item.
+  rpc AsyncPatchDataItemsByFilter (AsyncPatchDataItemsByFilterRequest)
+      returns (AsyncPatchDataItemsByFilterResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = BETA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/async-patch-by-filter"
+    };
+    option (wix.api.permission).name = "WIX_DATA.ASYNC_PATCH_BY_FILTER";
+    option (wix.api.required) = "AsyncPatchDataItemsByFilterRequest.data_collection_id";
+    option (wix.api.required) = "AsyncPatchDataItemsByFilterRequest.field_modifications";
+    option (wix.api.required) = "AsyncPatchDataItemsByFilterRequest.field_modifications.field_path";
+    option (wix.api.required) = "AsyncPatchDataItemsByFilterRequest.field_modifications.action";
+    option (wix.api.required) = "AsyncPatchDataItemsByFilterRequest.field_modifications.action_options.increment_field_options.value";
+  }
+
+  // Removes all data items matching a filter. Runs asynchronously.
+  //
+  //
+  // This method selects all items that match the specified filter and removes each one.
+  // Unlike [Bulk Remove Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-remove-data-items), you don't need to specify individual item IDs. Instead, items are selected by filter.
+  //
+  // The operation runs asynchronously and returns a job ID for tracking status.
+  // Call [Get Async Job Status](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/get-async-job-status) with the returned job ID to poll for status.
+  //
+  // An empty `filter` removes all items in the collection.
+  //
+  // > **Notes:**
+  // > - The number of affected items is not bounded.
+  // > - If any item fails to be removed, the async job stops and its status becomes `FAILED`. Some items may already have been removed before the failure.
+  // > - Calling this method triggers the [Data Item Deleted](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/data-item-deleted) event for each removed item.
+  rpc AsyncRemoveDataItemsByFilter (AsyncRemoveDataItemsByFilterRequest)
+      returns (AsyncRemoveDataItemsByFilterResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = BETA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/async-remove-by-filter"
+    };
+    option (wix.api.permission).name = "WIX_DATA.ASYNC_REMOVE_BY_FILTER";
+    option (wix.api.required) = "AsyncRemoveDataItemsByFilterRequest.data_collection_id";
+  }
+
+  // Retrieves the status of an async job.
+  //
+  // Returns the current status and successful item count for a job started by an async operation
+  // such as [Async Patch Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-patch-data-items-by-filter)
+  // or [Async Remove Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-remove-data-items-by-filter).
+  rpc GetAsyncJobStatus (GetAsyncJobStatusRequest)
+      returns (GetAsyncJobStatusResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = BETA;
+    option (google.api.http) = {
+      get: "/v2/async-jobs/{job_id}/status"
+    };
+    option (wix.api.permission).name = "WIX_DATA.GET_ASYNC_JOB_STATUS";
+    option (wix.api.required) = "GetAsyncJobStatusRequest.job_id";
+  }
+
+  // Updates an item in a collection.
+  //
+  // Call this method when you want to replace an existing item's payload and expect the item to already exist. For different behavior, you can call:
+  //
+  // - [Patch Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/patch-data-item) to make partial field changes that keep the rest of the payload unchanged.
+  // - [Save Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/save-data-item) for upsert behavior, meaning to create the item if it doesn't exist and update it if it does.
+  //
+  // This method replaces the data item's existing data with the payload provided in `dataItem.data` in the request.
+  //
+  // To update an item, you need to specify an item ID and a collection ID.
+  // If an item is found in the specified collection with the specified ID, that item is updated.
+  // If the collection doesn't contain an item with that ID, the request fails.
+  //
+  // When an item is updated, its `data._updatedDate` field is changed to the current date and time.
+  //
+  // > **Note:**
+  // > After an item is updated, it only contains the fields included in the `dataItem.data` payload 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.
+  rpc UpdateDataItem (UpdateDataItemRequest) returns (UpdateDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      put: "/v2/items/{data_item.id}",
+      additional_bindings: {
+        post: "/v2/items/update"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.UPDATE";
+    option (wix.api.required) = "UpdateDataItemRequest.data_collection_id";
+    option (wix.api.required) = "UpdateDataItemRequest.data_item";
+    option (wix.api.required) = "UpdateDataItemRequest.data_item.id";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+  }
+
+  // Inserts or updates an item in a collection.
+  //
+  // Call this method when your workflow needs upsert behavior: create a new item when the ID doesn't exist yet, and update the existing item when the same ID is reused (for example, a rerunnable import or sync). For different behavior, you can call:
+  //
+  // - [Patch Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/patch-data-item) to change only specific fields and keep the rest of the existing data unchanged.
+  // - [Update Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/update-data-item) when you want the request to fail if the item doesn't already exist.
+  //
+  // This method inserts or updates the specified item, depending on whether it already exists in the collection:
+  //
+  // + If you don't provide an ID, a new item is created.
+  //
+  // + If you provide an ID that doesn't exist in the collection, a new item is created with that ID.
+  //
+  // + If an item with the ID you provide already exists in the collection, that item is updated. When an item is updated, its `data._updatedDate` field is changed to the current date and time.
+  //
+  // > **Note:** When you provide an item with an ID that already exists in the collection, the data you provide in `dataItem.data` replaces the existing item with that ID.
+  // > This means that the item's previous fields and values are lost.
+  rpc SaveDataItem (SaveDataItemRequest) returns (SaveDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/save"
+    };
+    option (wix.api.permission).name = "WIX_DATA.SAVE";
+    option (wix.api.required) = "SaveDataItemRequest.data_collection_id";
+    option (wix.api.required) = "SaveDataItemRequest.data_item";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: CREATED
+    };
+  }
+
+  // Retrieves a list of items, on the basis of the filtering, sorting, and paging preferences you provide.
+  //
+  // Choose between offset and cursor paging:
+  //
+  // - Use `query.paging` (offset) when each request needs its own `filter` or `sort`, or when you need `returnTotalCount`.
+  // - Use `query.cursorPaging` to continue an existing result set by reusing the cursor returned in `pagingMetadata.cursors`. Define `filter` and `sort` on the first request only — follow-up cursor requests should pass only the returned cursor, because `filter` and `sort` are ignored on subsequent cursor requests.
+  //
+  // For date and datetime fields, write filter values as `{"$date":"2026-05-05T00:00:00.000Z"}` (plain ISO 8601 strings are also accepted).
+  //
+  // To inline related items in each result, set `includeReferences`. If a reference or multi-reference field can contain more items than you want to inline, page the base query first and then call [Query Referenced Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/query-referenced-data-items) for the specific item and field you want to expand.
+  //
+  // Learn more about [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
+  rpc QueryDataItems (QueryDataItemsRequest) returns (QueryDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/query",
+      additional_bindings: {
+        get: "/v2/items/query"
+      },
+    };
+    option (wix.api.permission).name = "WIX_DATA.QUERY";
+    option (wix.api.required) = "QueryDataItemsRequest.data_collection_id";
+    option (wix.api.crud) = {
+      method: QUERY
+      query_options: {
+        items_field: 'data_items'
+        paging: {
+          type: OFFSET
+          paging_metadata_field: 'paging_metadata'
+        }
+        wql: {
+          operator_field_support: {
+            operator: EQ
+            operator: GT
+            operator: GTE
+            operator: IN
+            operator: LT
+            operator: LTE
+            operator: NE
+            operator: BEGINS
+            operator: EXISTS
+            operator: HAS_ALL
+            operator: HAS_SOME
+            operator: EMPTY
+            glob: "**" // Meaning all fields including sub-fields
+            sort: BOTH // NONE|ASC|DESC|BOTH. NONE is the default.
+          }
+        }
+      }
+    };
+  }
+
+  // Retrieves an item from a collection.
+  //
+  // Set `consistentRead` to `true` when you need to read an item back immediately after a write and want to reduce the chance of stale data.
+  rpc GetDataItem (GetDataItemRequest) returns (GetDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      get: "/v2/items/{data_item_id}",
+      additional_bindings: {
+        post: "/v2/items/get"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.GET";
+    option (wix.api.required) = "GetDataItemRequest.data_collection_id";
+    option (wix.api.required) = "GetDataItemRequest.data_item_id";
+    option (wix.api.crud) = {
+      method: GET_ITEM
+      get_options: {
+        item_field: "data_item"
+      }
+    };
+  }
+
+  // Removes an item from a collection.
+  //
+  //
+  // If any items in other collections reference the removed item in reference or multi-reference fields, those fields are cleared.
+  //
+  // > **Note:**
+  // > Once an item has been removed from a collection, it can't be restored.
+  rpc RemoveDataItem (RemoveDataItemRequest) returns (RemoveDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      delete: "/v2/items/{data_item_id}",
+      additional_bindings: {
+        post: "/v2/items/remove"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.REMOVE";
+    option (wix.api.required) = "RemoveDataItemRequest.data_collection_id";
+    option (wix.api.required) = "RemoveDataItemRequest.data_item_id";
+
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Removes all items from a collection.
+  //
+  //
+  // If any items in other collections reference the removed items in reference or multi-reference fields, those fields are cleared.
+  //
+  // > **Note:**
+  // > Once items have been removed from a collection, they can't be restored.
+  rpc TruncateDataItems (TruncateDataItemsRequest) returns (TruncateDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/truncate"
+    };
+    option (wix.api.permission).name = "WIX_DATA.TRUNCATE";
+    option (wix.api.required) = "TruncateDataItemsRequest.data_collection_id";
+
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Runs an aggregation on a data collection and returns the resulting list of items.
+  //
+  //
+  // An aggregation enables you to perform certain calculations on your collection data, or on groups of items that you define, to retrieve meaningful summaries.
+  // You can also add paging, filtering, and sorting preferences to your aggregation to retrieve exactly what you need.
+  rpc AggregateDataItems (AggregateDataItemsRequest) returns (AggregateDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/aggregate",
+      additional_bindings: {
+        get: "/v2/items/aggregate"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.AGGREGATE";
+    option (wix.api.required) = "AggregateDataItemsRequest.data_collection_id";
+  }
+
+  // Runs an aggregation pipeline on a data collection and returns the results.
+  //
+  // Aggregations enable you to perform advanced data calculations, transformations, and groupings. While [Aggregate Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/aggregate-data-items) allows you to perform basic aggregations, Aggregate Pipeline Data Items allows you to perform advanced aggregations sequentially in stages, with each stage transforming the results of the previous stage.
+  rpc AggregatePipelineDataItems (AggregatePipelineDataItemsRequest) returns (AggregatePipelineDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/aggregate-pipeline",
+      additional_bindings: {
+        get: "/v2/items/aggregate-pipeline"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.AGGREGATE";
+    option (wix.api.required) = "AggregatePipelineDataItemsRequest.data_collection_id";
+  }
+
+  // Counts the number of items in a data collection that match the provided filtering preferences.
+  rpc CountDataItems (CountDataItemsRequest) returns (CountDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/count",
+      additional_bindings: {
+        get: "/v2/items/count"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.COUNT";
+    option (wix.api.required) = "CountDataItemsRequest.data_collection_id";
+    option (.wix.api.crud) = {
+      method: COUNT
+      count_options: {
+        inherit_wql_from: "QueryDataItems",
+        count_field: "total_count"
+      }
+    };
+  }
+
+  // Retrieves a list of distinct values for a given field in all items that match a query, without duplicates.
+  //
+  //
+  // As with the [Query Data Items](https://dev.wix.com/api/rest/wix-data/wix-data/data-items/query-data-items) method, this method retrieves items based on the filtering, sorting, and paging preferences you provide.
+  // However, the Query Distinct Values method doesn't return all of the full items that match the query.
+  // Rather, it returns all unique values of the field you specify in `fieldName` for items that match the query.
+  // If more than one item has the same value for that field, that value appears only once.
+  //
+  // Learn more about [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
+  rpc QueryDistinctValues (QueryDistinctValuesRequest) returns (QueryDistinctValuesResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/query-distinct-values",
+      additional_bindings: {
+        get: "/v2/items/query-distinct-values"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.QUERY_DISTINCT_VALUES";
+    option (wix.api.required) = "QueryDistinctValuesRequest.data_collection_id";
+
+  }
+
+  // Adds multiple items to a collection.
+  //
+  //
+  // To add a single item, call Insert Data Item instead.
+  //
+  // When each item is inserted into a collection, its ID is automatically assigned a random value.
+  // You can optionally provide your own ID when inserting the item. If you specify an ID that already exists in the collection, the insertion will fail.
+  rpc BulkInsertDataItems (BulkInsertDataItemsRequest) returns (BulkInsertDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/insert"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_INSERT";
+    option (wix.api.required) = "BulkInsertDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkInsertDataItemsRequest.data_items";
+
+    option (wix.api.emits) = {
+      event_type: CREATED
+    };
+  }
+
+  // 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](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-patch-data-items) to apply partial changes that keep unmentioned fields unchanged.
+  // - [Bulk Patch Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/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](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/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.
+  rpc BulkUpdateDataItems (BulkUpdateDataItemsRequest) returns (BulkUpdateDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/update"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_UPDATE";
+    option (wix.api.required) = "BulkUpdateDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkUpdateDataItemsRequest.data_items";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+  }
+
+  // Inserts or updates multiple items in a collection.
+  //
+  //
+  // The Bulk Save Data Items method inserts or updates each item provided, depending on whether it already exists in the collection. For each item:
+  //
+  // + If you don't provide an ID, a new item is created.
+  //
+  // + If you provide an ID that doesn't exist in the collection, a new item is created with that ID.
+  //
+  // + If an item with the ID you provide already exists in the collection, that item is updated. When an item is updated, its `data._updatedDate` field is changed to the current date and time.
+  //
+  // > **Note:** When you provide an item with an ID that already exists in the collection, the item you provide completely replaces the existing item with that ID.
+  // > This means that all of the item's previous fields and values are lost.
+  rpc BulkSaveDataItems (BulkSaveDataItemsRequest) returns (BulkSaveDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/save"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_SAVE";
+    option (wix.api.required) = "BulkSaveDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkSaveDataItemsRequest.data_items";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: CREATED
+    };
+  }
+
+  // Removes multiple items from a collection.
+  //
+  // For retention or cleanup flows, first call [Query Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/query-data-items) to collect the IDs you want to remove, then pass those IDs to this method in batches.
+  //
+  // If any items in other collections reference the removed items in reference or multi-reference fields, those fields are cleared.
+  //
+  // > **Note:** Once an item has been removed from a collection, it can't be restored.
+  rpc BulkRemoveDataItems (BulkRemoveDataItemsRequest) returns (BulkRemoveDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/remove"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_REMOVE";
+    option (wix.api.required) = "BulkRemoveDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkRemoveDataItemsRequest.data_item_ids";
+
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Retrieves the full items referenced in the specified field of an item.
+  //
+  // Call this method when a reference or multi-reference field can contain more related items than you want to inline with `includeReferences` on [Query Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/query-data-items), or when you want to expand one specific item's references after paging a base query.
+  //
+  // Reference and multi-reference fields refer to items in different collections. This method retrieves the full details of the referenced items themselves.
+  //
+  // For example, suppose you have a **Movies** collection with an **Actors** field that contains references to items in a **People** collection.
+  // Querying the **Movies** collection using this method returns the relevant **People** items referenced in the **Actors** field of the specified **Movie** item.
+  // This gives you information from the **People** collection about each of the actors in the specified movie.
+  rpc QueryReferencedDataItems (QueryReferencedDataItemsRequest) returns (QueryReferencedDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/query-referenced",
+      additional_bindings: {
+        get: "/v2/items/query-referenced"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.QUERY_REFERENCED";
+    option (wix.api.required) = "QueryReferencedDataItemsRequest.data_collection_id";
+  }
+
+  // Checks whether a field in a referring item contains a reference to a specified item.
+  rpc IsReferencedDataItem (IsReferencedDataItemRequest) returns (IsReferencedDataItemResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (wix.api.cacheable) = {manual: true};
+    option (google.api.http) = {
+      post: "/v2/items/is-referenced",
+      additional_bindings: {
+        get: "/v2/items/is-referenced"
+      }
+    };
+    option (wix.api.permission).name = "WIX_DATA.IS_REFERENCED";
+    option (wix.api.required) = "IsReferencedDataItemRequest.data_collection_id";
+    option (wix.api.required) = "IsReferencedDataItemRequest.referring_item_field_name";
+    option (wix.api.required) = "IsReferencedDataItemRequest.referring_item_id";
+    option (wix.api.required) = "IsReferencedDataItemRequest.referenced_item_id";
+  }
+
+  // Inserts a reference in the specified field in an item in a collection.
+  //
+  //
+  // A reference in the `dataItemReference` field specifies a referring item's ID, the field in which to insert the reference, and the ID of the referenced item.
+  rpc InsertDataItemReference (InsertDataItemReferenceRequest) returns (InsertDataItemReferenceResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/insert-reference"
+    };
+    option (wix.api.permission).name = "WIX_DATA.INSERT_REFERENCE";
+    option (wix.api.required) = "InsertDataItemReferenceRequest.data_collection_id";
+    option (wix.api.required) = "InsertDataItemReferenceRequest.data_item_reference.referring_item_field_name";
+    option (wix.api.required) = "InsertDataItemReferenceRequest.data_item_reference.referring_item_id";
+    option (wix.api.required) = "InsertDataItemReferenceRequest.data_item_reference.referenced_item_id";
+  }
+
+  // Removes the specified reference from the specified field.
+  rpc RemoveDataItemReference (RemoveDataItemReferenceRequest) returns (RemoveDataItemReferenceResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/remove-reference"
+    };
+    option (wix.api.permission).name = "WIX_DATA.REMOVE_REFERENCE";
+    option (wix.api.required) = "RemoveDataItemReferenceRequest.data_collection_id";
+    option (wix.api.required) = "RemoveDataItemReferenceRequest.data_item_reference";
+    option (wix.api.required) = "RemoveDataItemReferenceRequest.data_item_reference.referring_item_field_name";
+    option (wix.api.required) = "RemoveDataItemReferenceRequest.data_item_reference.referring_item_id";
+    option (wix.api.required) = "RemoveDataItemReferenceRequest.data_item_reference.referenced_item_id";
+  }
+
+
+  // Inserts one or more references in the specified fields of items in a collection.
+  //
+  //
+  // This method adds one or more references to a collection.
+  // Each new reference in the `dataItemReferences` field specifies a referring item's ID, the field in which to insert the reference, and the ID of the referenced item.
+  rpc BulkInsertDataItemReferences (BulkInsertDataItemReferencesRequest) returns (BulkInsertDataItemReferencesResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/insert-references"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_INSERT_REFERENCES";
+    option (wix.api.required) = "BulkInsertDataItemReferencesRequest.data_collection_id";
+    option (wix.api.required) = "BulkInsertDataItemReferencesRequest.data_item_references";
+    option (wix.api.required) = "BulkInsertDataItemReferencesRequest.data_item_references.referring_item_field_name";
+    option (wix.api.required) = "BulkInsertDataItemReferencesRequest.data_item_references.referring_item_id";
+    option (wix.api.required) = "BulkInsertDataItemReferencesRequest.data_item_references.referenced_item_id";
+  }
+
+  // Removes one or more references.
+  rpc BulkRemoveDataItemReferences (BulkRemoveDataItemReferencesRequest) returns (BulkRemoveDataItemReferencesResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/remove-references"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_REMOVE_REFERENCES";
+    option (wix.api.required) = "BulkRemoveDataItemReferencesRequest.data_collection_id";
+    option (wix.api.required) = "BulkRemoveDataItemReferencesRequest.data_item_references";
+    option (wix.api.required) = "BulkRemoveDataItemReferencesRequest.data_item_references.referring_item_field_name";
+    option (wix.api.required) = "BulkRemoveDataItemReferencesRequest.data_item_references.referring_item_id";
+    option (wix.api.required) = "BulkRemoveDataItemReferencesRequest.data_item_references.referenced_item_id";
+  }
+
+  // Replaces references in a specified field of a specified data item.
+  //
+  //
+  // This method replaces the existing reference or references contained in the field specified in `referringItemFieldName` within the data item specified in `referringItemId`.
+  // The method removes existing references and in their place it adds references to the items specified in `newReferencedItemIds`.
+  //
+  // > **Note:** If you pass an empty array in `newReferencedItemIds`, all existing references are removed.
+  rpc ReplaceDataItemReferences (ReplaceDataItemReferencesRequest) returns (ReplaceDataItemReferencesResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/replace-references"
+    };
+    option (wix.api.permission).name = "WIX_DATA.REPLACE_REFERENCES";
+    option (wix.api.required) = "ReplaceDataItemReferencesRequest.data_collection_id";
+    option (wix.api.required) = "ReplaceDataItemReferencesRequest.referring_item_field_name";
+    option (wix.api.required) = "ReplaceDataItemReferencesRequest.referring_item_id";
+  }
+
+
+  // Searches for items in a collection on the basis of the filtering, sorting, searching, and paging preferences you provide.
+  //
+  // Learn more about [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
+  //
+  // > **Notes:**
+  // > - You can only search collections [created in the CMS](https://support.wix.com/en/article/cms-formerly-content-manager-creating-a-collection) or with the [Data Collections API](https://dev.wix.com/docs/rest/business-solutions/cms/data-collections/introduction). Searching isn't currently supported for [Wix app collections](https://support.wix.com/en/article/cms-formerly-content-manager-working-with-wix-app-collections), [external collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site) or [Wix Blocks](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/wix-blocks/about-wix-blocks).
+  // > - Filtering is only supported for fields explicitly defined in the [data collection structure](https://dev.wix.com/docs/rest/business-solutions/cms/data-collections/introduction#data-collections-and-their-structure). Fields not defined in the collection structure cannot be used for filtering.
+  // > - Searching for data items is always [eventually consistent](https://dev.wix.com/docs/rest/business-solutions/cms/eventual-consistency).
+  //
+  // ### Supported filter operators by field type
+  //
+  // Each [field type](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-type) supports a specific set of [filter operators](https://dev.wix.com/docs/rest/articles/get-started/api-query-language#operators). Using a filter operator that's not supported for a given field type causes the search to fail.
+  //
+  // | Field Type | Supported Filter Operators |
+  // |------------|----------------------------|
+  // | Text, Image, Document, URL, Video, Audio, Time, Reference, [Page Link](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#page-link-fields), [Rich Text](https://dev.wix.com/docs/rest/articles/get-started/rich-text), [Rich Content](https://dev.wix.com/docs/ricos/getting-started/introduction), Address | `$in`, `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$isEmpty`, `$startsWith` |
+  // | Number, Date, Date and Time | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$exists` |
+  // | Boolean | `$eq`, `$ne`, `$exists` |
+  // | Array of strings | `$hasSome`, `$hasAll`, `$exists` |
+  // | Array, Document Array, Object, Any, Media Gallery | `$exists` |
+  //
+  // Learn more about [data types in Wix Data](https://dev.wix.com/docs/rest/business-solutions/cms/data-types-in-wix-data).
+  //
+  rpc SearchDataItems (SearchDataItemsRequest) returns (SearchDataItemsResponse) {
+    option (wix.api.exposure) = PUBLIC;
+    option (wix.api.maturity) = GA;
+    option (google.api.http) = {
+      post: "/v2/items/search"
+    };
+    option (wix.api.permission).name = "WIX_DATA.SEARCH";
+    option (wix.api.required) = "SearchDataItemsRequest.data_collection_id";
+  }
+
+  // Creates a draft copy of a published data item.
+  //
+  // The published item remains live and unchanged.
+  //
+  // If a draft with same _id already exists the request will fail.
+  //
+  // After creating the draft, edit it via [Update Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/update-data-item) or [Patch Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/patch-data-item) in the drafts collection. To put the edits live, call [Publish Data Item Draft](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/publish-data-item-draft).
+  //
+  // > **Notes:**
+  // > - The response carries the newly-created draft, not the published item.
+  // > - Returns `NOT_FOUND` if no published item exists with the supplied `dataItemId`.
+  rpc CreateDataItemDraft(CreateDataItemDraftRequest) returns (CreateDataItemDraftResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = ALPHA;
+    option (google.api.http) = {
+      post: "/v2/items/create-draft"
+    };
+    option (wix.api.permission).name = "WIX_DATA.CREATE_DATA_ITEM_DRAFT";
+    option (wix.api.required) = "CreateDataItemDraftRequest.data_collection_id";
+    option (wix.api.required) = "CreateDataItemDraftRequest.data_item_id";
+
+    option (wix.api.emits) = {
+      event_type: CREATED
+    };
+  }
+
+  // Publishes a pending draft of a data item.
+  //
+  //
+  // This method replaces the published item's data with the draft's content. On success, the draft is deleted.
+  //
+  // To create a draft for a published item, call [Save Data Item Draft](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/save-data-item-draft).
+  // To retract a published item back to draft state, call [Unpublish Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/unpublish-data-item).
+  //
+  // > **Note:** Returns `NOT_FOUND` if no pending draft exists for the supplied `dataItemId`.
+  rpc PublishDataItemDraft(PublishDataItemDraftRequest) returns (PublishDataItemDraftResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = ALPHA;
+    option (google.api.http) = {
+      post: "/v2/items/publish-draft"
+    };
+    option (wix.api.permission).name = "WIX_DATA.PUBLISH_DRAFT";
+    option (wix.api.required) = "PublishDataItemDraftRequest.data_collection_id";
+    option (wix.api.required) = "PublishDataItemDraftRequest.data_item_id";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Publishes multiple pending drafts at once.
+  //
+  //
+  // This method publishes each draft independently and supports partial success: if some drafts cannot be published, the remaining ones are still processed. For each item, the response includes an entry in `results` with success/error details. Use `results.itemMetadata.originalIndex` to correlate response entries with the request's `dataItemIds`.
+  //
+  // Set `returnEntity` to `true` to include the published items in the response.
+  //
+  // > **Notes:**
+  // > - Each successfully published draft is deleted; the published item now contains the draft's content.
+  // > - Per-item `NOT_FOUND` is reported in the result when no pending draft exists for a given `dataItemId`.
+  // > - The order of `results` matches the order of `dataItemIds` in the request.
+  rpc BulkPublishDataItemDrafts(BulkPublishDataItemDraftsRequest) returns (BulkPublishDataItemDraftsResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = ALPHA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/publish-drafts"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_PUBLISH_DRAFTS";
+    option (wix.api.required) = "BulkPublishDataItemDraftsRequest.data_collection_id";
+    option (wix.api.required) = "BulkPublishDataItemDraftsRequest.data_item_ids";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Retracts a published data item back to draft state.
+  //
+  //
+  // This method removes the published copy of the item and creates a draft seeded with the previously-published data. Use it to take a published item offline so it can be edited.
+  //
+  // After unpublishing, edit the resulting draft via [Update Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/update-data-item) or [Patch Data Item](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/patch-data-item) in drafts collection. To put the item back live, call [Publish Data Item Draft](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/publish-data-item-draft).
+  //
+  // > **Notes:**
+  // > - If a pending draft already exists for the supplied `dataItemId`, it is silently overwritten with the previously-published data.
+  // > - The response carries the newly-created (or overwritten) draft, not the previously-published item.
+  // > - Returns `NOT_FOUND` if no published item exists with the supplied `dataItemId`.
+  rpc UnpublishDataItem(UnpublishDataItemRequest) returns (UnpublishDataItemResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = ALPHA;
+    option (google.api.http) = {
+      post: "/v2/items/unpublish"
+    };
+    option (wix.api.permission).name = "WIX_DATA.UNPUBLISH";
+    option (wix.api.required) = "UnpublishDataItemRequest.data_collection_id";
+    option (wix.api.required) = "UnpublishDataItemRequest.data_item_id";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+
+  // Retracts multiple published data items back to draft state.
+  //
+  //
+  // This method unpublishes each item independently and supports partial success: if some items cannot be unpublished, the remaining ones are still processed. For each item, the response includes an entry in `results` with success/error details. Use `results.itemMetadata.originalIndex` to correlate response entries with the request's `dataItemIds`.
+  //
+  // Set `returnEntity` to `true` to include the resulting drafts in the response.
+  //
+  // > **Notes:**
+  // > - For each successfully unpublished item, the published copy is removed and a draft (seeded with the previously-published data) is created or, if a draft already exists, overwritten.
+  // > - Per-item `NOT_FOUND` is reported in the result when no published item exists for a given `dataItemId`.
+  // > - The order of `results` matches the order of `dataItemIds` in the request.
+  rpc BulkUnpublishDataItems(BulkUnpublishDataItemsRequest) returns (BulkUnpublishDataItemsResponse) {
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.maturity) = ALPHA;
+    option (google.api.http) = {
+      post: "/v2/bulk/items/unpublish"
+    };
+    option (wix.api.permission).name = "WIX_DATA.BULK_UNPUBLISH";
+    option (wix.api.required) = "BulkUnpublishDataItemsRequest.data_collection_id";
+    option (wix.api.required) = "BulkUnpublishDataItemsRequest.data_item_ids";
+
+    option (wix.api.emits) = {
+      event_type: UPDATED
+    };
+    option (wix.api.emits) = {
+      event_type: DELETED
+    };
+  }
+}