@wix/auto_sdk_data_collections 1.0.108 → 1.0.110

package/build/es/index.typings.d.mts

@@ -1,6 +1,9 @@
 import { NonNullablePaths } from '@wix/sdk-types';
 
-/** A data collection determines the structure of data to be stored in a database. */
+/**
+ * A data collection defines the fields, data types, item permissions, and plugins for a set of data items.
+ * Use the Data Items API to store and retrieve the items themselves.
+ */
 interface DataCollection {
     /**
      * [Collection ID](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/work-with-data/introduction/about-collections#collection-ids). For example, `my-first-collection`.
@@ -30,6 +33,8 @@ interface DataCollection {
     maxPageSize?: number | null;
     /**
      * Collection's display name as shown in the CMS. For example, `My First Collection`.
+     *
+     * Default: The collection ID.
      * @maxLength 1000
      */
     displayName?: string | null;
@@ -47,6 +52,8 @@ interface DataCollection {
     displayNamespace?: string | null;
     /**
      * Field whose value the CMS displays to represent the collection item when referenced in a different collection.
+     *
+     * Default: The first field in the request, or `title` if no fields are specified.
      * @maxLength 1000
      */
     displayField?: string | null;
@@ -219,7 +226,7 @@ interface Field extends FieldRangeValidationsOneOf {
      * Learn more about [data types in Wix Data](https://dev.wix.com/docs/rest/business-solutions/cms/data-types-in-wix-data).
      */
     type?: TypeWithLiterals;
-    /** Metadata for complex data types. This property only exists for references, multi-references, objects, and arrays. */
+    /** Type-specific configuration, such as the referenced collection for a reference field or the calculation pattern for a page link. */
     typeMetadata?: TypeMetadata;
     /**
      * Whether the field is a system field.
@@ -245,7 +252,7 @@ interface Field extends FieldRangeValidationsOneOf {
      */
     readOnly?: boolean | null;
     /**
-     * Whether the field is immutable. An immutable field can be set once, but then cannot be updated.
+     * Whether the field is immutable. An immutable field can be set once, but then can't be updated.
      *
      * Default: `false`
      */
@@ -262,7 +269,7 @@ interface Field extends FieldRangeValidationsOneOf {
      */
     plugins?: FieldPlugin[];
     /**
-     * This indicates that this fields is conditional and is not retrieved by default.
+     * Conditions that control whether this field is included when retrieving data items.
      * @readonly
      */
     condition?: FieldCondition;
@@ -455,7 +462,7 @@ interface ObjectField {
      * Learn more about [data types in Wix Data](https://dev.wix.com/docs/rest/business-solutions/cms/data-types-in-wix-data).
      */
     type?: TypeWithLiterals;
-    /** Metadata for complex data types. This property only exists for references, multi-references, objects, and arrays. */
+    /** Type-specific configuration, such as the referenced collection for a reference field or the calculation pattern for a page link. */
     typeMetadata?: TypeMetadata;
     /**
      * Capabilities the object field supports.
@@ -464,12 +471,19 @@ interface ObjectField {
     capabilities?: FieldCapabilities;
 }
 interface FieldsPattern {
-    /** @maxLength 1000 */
+    /**
+     * Pattern used to generate the field value from item properties.
+     * @maxLength 1000
+     */
     pattern?: string;
+    /** Whether to convert the generated value to lowercase. Default: `false`. */
     lowercase?: boolean;
 }
 interface UrlizedOnlyPattern {
-    /** @maxLength 1000 */
+    /**
+     * Pattern used to generate the field value from item properties.
+     * @maxLength 1000
+     */
     pattern?: string;
 }
 interface Calculator extends CalculatorPatternOneOf {
@@ -538,10 +552,11 @@ interface _Object {
 interface _Array {
     /** Element's data type. */
     elementType?: TypeWithLiterals;
-    /** Metadata for complex data types. This property only exists for references, multi-references, objects, and arrays. */
+    /** Type-specific configuration, such as the referenced collection for a reference field or the calculation pattern for a page link. */
     typeMetadata?: TypeMetadata;
 }
 interface PageLink {
+    /** Calculation pattern used to generate the page link. Required for page link fields. */
     calculator?: Calculator;
     /**
      * Defines reference to router pattern in the site document.
@@ -551,22 +566,28 @@ interface PageLink {
 }
 interface Slug {
     /**
+     * Pattern used to generate the field value from item properties.
      * @minLength 1
      * @maxLength 1000
      */
     pattern?: string;
 }
 interface Text extends TextValidationOneOf {
+    /** Length and pattern constraints for the text value. */
     textValidation?: TextValidation;
+    /** Allowed text values. */
     enumValues?: EnumValues;
     defaultValue?: string | null;
 }
 /** @oneof */
 interface TextValidationOneOf {
+    /** Length and pattern constraints for the text value. */
     textValidation?: TextValidation;
+    /** Allowed text values. */
     enumValues?: EnumValues;
 }
 interface _Number {
+    /** Value assigned when a data item omits this field. */
     defaultValue?: number | null;
     /** Minimum permitted value for a numerical field. */
     min?: number | null;
@@ -574,48 +595,68 @@ interface _Number {
     max?: number | null;
 }
 interface _Date extends _DateDefaultValueOneOf, _DateMinDateOneOf, _DateMaxDateOneOf {
+    /** Fixed date and time used as the default value. */
     defaultValueFixed?: Date | null;
+    /** Offset from the current date, in days, used as the default value. */
     defaultValueOffsetFromNowInDays?: number | null;
+    /** Earliest permitted date and time. */
     minDateFixed?: Date | null;
+    /** Offset from the current date, in days, used as the earliest permitted date. */
     minValueOffsetFromNowInDays?: number | null;
+    /** Latest permitted date and time. */
     maxDateFixed?: Date | null;
+    /** Offset from the current date, in days, used as the latest permitted date. */
     maxValueOffsetFromNowInDays?: number | null;
 }
 /** @oneof */
 interface _DateDefaultValueOneOf {
+    /** Fixed date and time used as the default value. */
     defaultValueFixed?: Date | null;
+    /** Offset from the current date, in days, used as the default value. */
     defaultValueOffsetFromNowInDays?: number | null;
 }
 /** @oneof */
 interface _DateMinDateOneOf {
+    /** Earliest permitted date and time. */
     minDateFixed?: Date | null;
+    /** Offset from the current date, in days, used as the earliest permitted date. */
     minValueOffsetFromNowInDays?: number | null;
 }
 /** @oneof */
 interface _DateMaxDateOneOf {
+    /** Latest permitted date and time. */
     maxDateFixed?: Date | null;
+    /** Offset from the current date, in days, used as the latest permitted date. */
     maxValueOffsetFromNowInDays?: number | null;
 }
 interface Datetime extends DatetimeDefaultValueOneOf, DatetimeMinDateOneOf, DatetimeMaxDateOneOf {
+    /** Fixed date and time used as the default value. */
     defaultValueFixed?: Date | null;
+    /** Offset from the current time, in seconds, used as the default value. */
     defaultValueOffsetFromNowInSeconds?: number | null;
+    /** Earliest permitted date and time. */
     minDateFixed?: Date | null;
     minDateOffsetFromNowInSeconds?: number | null;
+    /** Latest permitted date and time. */
     maxDateFixed?: Date | null;
     maxDateOffsetFromNowInSeconds?: number | null;
 }
 /** @oneof */
 interface DatetimeDefaultValueOneOf {
+    /** Fixed date and time used as the default value. */
     defaultValueFixed?: Date | null;
+    /** Offset from the current time, in seconds, used as the default value. */
     defaultValueOffsetFromNowInSeconds?: number | null;
 }
 /** @oneof */
 interface DatetimeMinDateOneOf {
+    /** Earliest permitted date and time. */
     minDateFixed?: Date | null;
     minDateOffsetFromNowInSeconds?: number | null;
 }
 /** @oneof */
 interface DatetimeMaxDateOneOf {
+    /** Latest permitted date and time. */
     maxDateFixed?: Date | null;
     maxDateOffsetFromNowInSeconds?: number | null;
 }
@@ -623,6 +664,7 @@ interface Image {
     defaultValue?: string | null;
 }
 interface _Boolean {
+    /** Value assigned when a data item omits this field. */
     defaultValue?: boolean | null;
 }
 interface Document {
@@ -630,10 +672,12 @@ interface Document {
 }
 interface Url {
     /**
+     * Value assigned when a data item omits this field.
      * @minLength 1
      * @maxLength 2048
      */
     defaultValue?: string | null;
+    /** Length and pattern constraints for the text value. */
     textValidation?: TextValidation;
 }
 interface RichText {
@@ -690,16 +734,21 @@ interface Time {
     maxTime?: string | null;
 }
 interface RichContent {
+    /** Value assigned when a data item omits this field. */
     defaultValue?: Record<string, any> | null;
 }
 interface MediaGallery {
     defaultValue?: Record<string, any>[] | null;
 }
 interface Address {
+    /** Value assigned when a data item omits this field. */
     defaultValue?: Record<string, any> | null;
 }
 interface Email {
-    /** @format EMAIL */
+    /**
+     * Value assigned when a data item omits this field.
+     * @format EMAIL
+     */
     defaultValue?: string | null;
 }
 interface LegacyColor {
@@ -751,12 +800,13 @@ interface ArraySizeRange {
      */
     maxSize?: number | null;
 }
-/** Optional plug-in aspects for fields */
+/** Plugins that extend a field's behavior. */
 interface FieldPlugin extends FieldPluginOptionsOneOf {
     /** Options for the CMS plugin. */
     cmsOptions?: CmsOptions;
     /** Options for the CATEGORY_FIELD plugin. */
     categoryFieldOptions?: CategoryFieldOptions;
+    /** Field plugin type. */
     type?: FieldPluginTypeWithLiterals;
 }
 /** @oneof */
@@ -767,9 +817,9 @@ interface FieldPluginOptionsOneOf {
     categoryFieldOptions?: CategoryFieldOptions;
 }
 declare enum FieldPluginType {
-    /** Uknown plugin type. */
+    /** Unknown plugin type. */
     UNKNOWN = "UNKNOWN",
-    /** CMS-related field attributes */
+    /** CMS-related field attributes. */
     CMS = "CMS"
 }
 /** @enumType */
@@ -796,7 +846,7 @@ interface CategoryFieldOptions {
 }
 interface FieldCondition {
     /**
-     * If `group_name` is set, this field will not be present in query results. To retrieve this field, pass `group_name` value to `includeFieldGroups` parameter in query operations.
+     * If `groupName` is set, this field will not be present in query results. To retrieve this field, pass `groupName` value to `includeFieldGroups` parameter in query operations.
      * @maxLength 100
      */
     groupName?: string | null;
@@ -889,7 +939,9 @@ interface PluginOptionsOneOf {
     cmsOptions?: PluginCmsOptions;
 }
 declare enum Status {
+    /** Items are published by default. */
     PUBLISHED = "PUBLISHED",
+    /** Items are drafts by default. */
     DRAFT = "DRAFT"
 }
 /** @enumType */
@@ -965,7 +1017,11 @@ declare enum PluginType {
 /** @enumType */
 type PluginTypeWithLiterals = PluginType | 'PUBLISH' | 'SINGLE_ITEM' | 'URLIZED' | 'GRIDAPPLESS' | 'MULTILINGUAL' | 'SHARED' | 'EDITABLE_PAGE_LINK' | 'CMS';
 interface PublishPluginOptions {
-    /** Default status. */
+    /**
+     * Publication status assigned to items that don't specify one.
+     *
+     * Default: `PUBLISHED`.
+     */
     defaultStatus?: StatusWithLiterals;
 }
 interface SingleItemPluginOptions {
@@ -976,7 +1032,11 @@ interface SingleItemPluginOptions {
     singleItemId?: string;
 }
 interface UrlizedPluginOptions {
-    /** Encoding method for generating a URL in ASCII characters. */
+    /**
+     * Encoding method for generating a URL in ASCII characters.
+     *
+     * Default: `ORIGINAL`.
+     */
     format?: FormatWithLiterals;
 }
 interface MultilingualOptions {
@@ -988,7 +1048,17 @@ interface MultilingualOptions {
     translatableFieldKeys?: string[];
 }
 interface PageLinkPluginOptions {
+    /**
+     * Whether page link values are stored with the items.
+     *
+     * Default: `false`.
+     */
     isPersisted?: boolean;
+    /**
+     * Whether page link values can be updated.
+     *
+     * Default: `false`.
+     */
     isMutable?: boolean;
 }
 interface PluginCmsOptions {
@@ -997,7 +1067,9 @@ interface PluginCmsOptions {
 }
 interface CatalogOptions {
     /**
-     * *Required** - the field key that contains the catalog item name - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's name. The referenced field must have type `TEXT`.
+     *
+     * Use `nameFieldKey` instead. If both properties are specified, a non-empty `nameFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy name_field_key
@@ -1005,7 +1077,9 @@ interface CatalogOptions {
      */
     name?: string;
     /**
-     * *Required** - the field key that contains the catalog item price - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's price. The referenced field must have type `NUMBER`.
+     *
+     * Use `priceFieldKey` instead. If both properties are specified, a non-empty `priceFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy price_field_key
@@ -1013,7 +1087,9 @@ interface CatalogOptions {
      */
     price?: string;
     /**
-     * the field key that contains the catalog item URL - field must be of type URL.
+     * Key of the collection field that contains the catalog item's URL. The referenced field must have type `URL`.
+     *
+     * Use `urlFieldKey` instead. If both properties are specified, a non-empty `urlFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy url_field_key
@@ -1021,7 +1097,9 @@ interface CatalogOptions {
      */
     url?: string | null;
     /**
-     * the field key that contains the catalog item description - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's description. The referenced field must have type `TEXT`.
+     *
+     * Use `descriptionFieldKey` instead. If both properties are specified, a non-empty `descriptionFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy description_field_key
@@ -1029,7 +1107,9 @@ interface CatalogOptions {
      */
     description?: string | null;
     /**
-     * the field key that contains the catalog item image - field must be of type IMAGE.
+     * Key of the collection field that contains the catalog item's image. The referenced field must have type `IMAGE` or `MEDIA_IMAGE`.
+     *
+     * Use `imageFieldKey` instead. If both properties are specified, a non-empty `imageFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy image_field_key
@@ -1037,7 +1117,9 @@ interface CatalogOptions {
      */
     image?: string | null;
     /**
-     * the field key that contains the catalog item quantity - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's quantity. The referenced field must have type `NUMBER`.
+     *
+     * Use `quantityFieldKey` instead. If both properties are specified, a non-empty `quantityFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy quantity_field_key
@@ -1045,7 +1127,9 @@ interface CatalogOptions {
      */
     quantity?: string | null;
     /**
-     * the field key that contains the catalog item digital file - field must be of type SECURED_MEDIA.
+     * Key of the collection field that contains the catalog item's digital file. The referenced field must have type `SECURED_MEDIA`.
+     *
+     * Use `digitalFileFieldKey` instead. If both properties are specified, a non-empty `digitalFileFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy digital_file_field_key
@@ -1053,7 +1137,9 @@ interface CatalogOptions {
      */
     digitalFile?: string | null;
     /**
-     * the field key that contains the catalog item weight - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's weight. The referenced field must have type `NUMBER`.
+     *
+     * Use `weightFieldKey` instead. If both properties are specified, a non-empty `weightFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy weight_field_key
@@ -1061,7 +1147,9 @@ interface CatalogOptions {
      */
     weight?: string | null;
     /**
-     * the field key that contains the catalog item SKU - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's stock keeping unit (SKU). The referenced field must have type `TEXT`.
+     *
+     * Use `skuFieldKey` instead. If both properties are specified, a non-empty `skuFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy sku_field_key
@@ -1069,7 +1157,9 @@ interface CatalogOptions {
      */
     sku?: string | null;
     /**
-     * the field key that contains the catalog item shippable flag - field must be of type BOOLEAN.
+     * Key of the collection field that indicates whether the catalog item requires shipping. The referenced field must have type `BOOLEAN`.
+     *
+     * Use `shippableFieldKey` instead. If both properties are specified, a non-empty `shippableFieldKey` takes precedence.
      * @maxLength 1000
      * @deprecated
      * @replacedBy shippable_field_key
@@ -1077,52 +1167,56 @@ interface CatalogOptions {
      */
     shippable?: string | null;
     /**
-     * *Required** - the field key that contains the catalog item name - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's name. The referenced field must have type `TEXT`.
+     *
+     * Required when configuring the Catalog plugin.
      * @maxLength 1000
      */
     nameFieldKey?: string;
     /**
-     * *Required** - the field key that contains the catalog item price - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's price. The referenced field must have type `NUMBER`.
+     *
+     * Required when configuring the Catalog plugin.
      * @maxLength 1000
      */
     priceFieldKey?: string;
     /**
-     * the field key that contains the catalog item URL - field must be of type URL.
+     * Key of the collection field that contains the catalog item's URL. The referenced field must have type `URL`.
      * @maxLength 1000
      */
     urlFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item description - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's description. The referenced field must have type `TEXT`.
      * @maxLength 1000
      */
     descriptionFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item image - field must be of type IMAGE.
+     * Key of the collection field that contains the catalog item's image. The referenced field must have type `IMAGE` or `MEDIA_IMAGE`.
      * @maxLength 1000
      */
     imageFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item quantity - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's quantity. The referenced field must have type `NUMBER`.
      * @maxLength 1000
      */
     quantityFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item digital file - field must be of type SECURED_MEDIA.
+     * Key of the collection field that contains the catalog item's digital file. The referenced field must have type `SECURED_MEDIA`.
      * @maxLength 1000
      */
     digitalFileFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item weight - field must be of type NUMBER.
+     * Key of the collection field that contains the catalog item's weight. The referenced field must have type `NUMBER`.
      * @maxLength 1000
      */
     weightFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item SKU - field must be of type TEXT.
+     * Key of the collection field that contains the catalog item's stock keeping unit (SKU). The referenced field must have type `TEXT`.
      * @maxLength 1000
      */
     skuFieldKey?: string | null;
     /**
-     * the field key that contains the catalog item shippable flag - field must be of type BOOLEAN.
+     * Key of the collection field that indicates whether the catalog item requires shipping. The referenced field must have type `BOOLEAN`.
      * @maxLength 1000
      */
     shippableFieldKey?: string | null;
@@ -1224,32 +1318,32 @@ interface DataCollectionClonedEvent {
 }
 interface DataCollectionChangedEvent {
     /**
-     * list of new fields
+     * Fields added to the collection.
      * @maxSize 1000
      */
     fieldsAdded?: Field[];
     /**
-     * list of changed fields
+     * Fields whose definitions changed.
      * @maxSize 1000
      */
     fieldsUpdated?: FieldUpdate[];
     /**
-     * list of removed fields
+     * Fields removed from the collection.
      * @maxSize 1000
      */
     fieldsRemoved?: Field[];
     /**
-     * list of new plugins
+     * Plugins added to the collection.
      * @maxSize 100
      */
     pluginsAdded?: Plugin[];
     /**
-     * list of changed plugins
+     * Plugins whose options changed.
      * @maxSize 100
      */
     pluginsUpdated?: PluginUpdate[];
     /**
-     * list of removed plugins
+     * Plugins removed from the collection.
      * @maxSize 100
      */
     pluginsRemoved?: Plugin[];
@@ -1259,15 +1353,15 @@ interface DataCollectionChangedEvent {
     strictModeUpdated?: StrictModeUpdate;
 }
 interface FieldUpdate {
-    /** previous state of the field */
+    /** Previous field definition. */
     previous?: Field;
-    /** current state of the field */
+    /** Updated field definition. */
     current?: Field;
 }
 interface PluginUpdate {
-    /** previous state of the plugin */
+    /** Previous plugin configuration. */
     previous?: Plugin;
-    /** current state of the plugin */
+    /** Updated plugin configuration. */
     current?: Plugin;
 }
 interface PermissionsUpdate {
@@ -1295,7 +1389,7 @@ interface CreateDataCollectionRequest {
     collection: DataCollection;
 }
 interface CreateDataCollectionResponse {
-    /** Details of collection created. */
+    /** Created collection. */
     collection?: DataCollection;
 }
 interface GetDataCollectionRequest {
@@ -1313,8 +1407,9 @@ interface GetDataCollectionRequest {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 1000
      */
@@ -1328,17 +1423,23 @@ declare enum Segment {
 /** @enumType */
 type SegmentWithLiterals = Segment | 'UNKNOWN_SEGMENT' | 'PUBLIC' | 'DEV';
 interface GetDataCollectionResponse {
-    /** Details of the collection requested. */
+    /** Requested collection. */
     collection?: DataCollection;
 }
 interface ListDataCollectionsRequest {
     /**
      * Defines how collections in the response are sorted.
      *
-     * Default: Ordered by ID in ascending order.
+     * Supported properties: `id`, `displayName`, `createdDate`, `updatedDate`.
+     *
+     * Default: `id` in ascending order.
      */
     sort?: Sorting;
-    /** Pagination information. */
+    /**
+     * Pagination information. The maximum page size is `1000`.
+     *
+     * Default: `limit` is `1000` and `offset` is `0`.
+     */
     paging?: Paging;
     /**
      * Whether to retrieve data from the primary database instance.
@@ -1349,8 +1450,9 @@ interface ListDataCollectionsRequest {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 128
      */
@@ -1413,7 +1515,13 @@ interface BulkGetDataCollectionsRequest {
      * Default: `false`
      */
     includeReferencedCollections?: boolean;
-    /** Sorting preferences. */
+    /**
+     * Sorting preferences for active and deleted collections. Results aren't returned in request order.
+     *
+     * Supported properties: `id`, `displayName`, `createdDate`, `updatedDate`.
+     *
+     * Default: `id` in ascending order.
+     */
     sort?: Sorting;
     /**
      * Whether to retrieve data from the primary database instance.
@@ -1424,8 +1532,9 @@ interface BulkGetDataCollectionsRequest {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 1000
      */
@@ -1434,12 +1543,12 @@ interface BulkGetDataCollectionsRequest {
 interface BulkGetDataCollectionsResponse {
     /**
      * List of requested collections.
-     * When `include_referenced_collections` is `true` in the request, referenced collections are included here.
+     * When `includeReferencedCollections` is `true` in the request, referenced collections are included here.
      */
     activeCollections?: DataCollection[];
     /** List of requested deleted collections. Only populated when `showDeletedCollections` is true in the request. */
     deletedCollections?: DataCollection[];
-    /** List of failed collections. */
+    /** Collections that couldn't be loaded, with an error for each failure. */
     failedCollections?: FailedCollection[];
 }
 interface ApplicationError {
@@ -1452,7 +1561,7 @@ interface ApplicationError {
 }
 interface FailedCollection {
     /**
-     * IDs of the failed collection.
+     * ID of the collection that couldn't be loaded.
      * @maxLength 255
      */
     collectionId?: string;
@@ -1478,13 +1587,13 @@ interface DeleteDataCollectionResponse {
 }
 interface RestoreDataCollectionRequest {
     /**
-     * Data Collection ID to restore
+     * ID of the data collection to restore.
      * @maxLength 256
      */
     dataCollectionId?: string;
 }
 interface RestoreDataCollectionResponse {
-    /** Restored data collection */
+    /** Restored data collection. */
     dataCollection?: DataCollection;
 }
 interface PatchDataCollectionRequest {
@@ -1574,7 +1683,11 @@ interface AddPublishPluginRequest {
     dataCollectionId: string;
     /** Publish plugin options. */
     publishOptions: PublishPluginOptions;
-    /** Action to take when the Draft Items plugin is already installed. */
+    /**
+     * Action to take when the Draft Items plugin is already installed.
+     *
+     * Default: `FAIL_WHEN_DRAFT_ITEMS_INSTALLED`.
+     */
     draftItemsPluginConflictAction?: DraftItemsPluginConflictActionWithLiterals;
 }
 /** Behavior to apply when adding the Publish plugin to a collection that already has the Draft Items plugin. */
@@ -1611,7 +1724,10 @@ interface UpdatePublishPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated Publish plugin options. Read-only fields are ignored. */
+    /**
+     * Replacement writable options for the Publish plugin. Omitted options use their defaults.
+     * Server-managed lifecycle status is preserved.
+     */
     publishOptions: PublishPluginOptions;
 }
 interface UpdatePublishPluginResponse {
@@ -1648,7 +1764,7 @@ interface UpdateUrlizedPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated Urlized plugin options. */
+    /** Replacement options for the Urlized plugin. Omitted options use their defaults. */
     urlizedOptions: UrlizedPluginOptions;
 }
 interface UpdateUrlizedPluginResponse {
@@ -1685,7 +1801,7 @@ interface UpdateMultilingualPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated Multilingual plugin options. */
+    /** Replacement options for the Multilingual plugin. Omitted options use their defaults. */
     multilingualOptions: MultilingualOptions;
 }
 interface UpdateMultilingualPluginResponse {
@@ -1722,7 +1838,7 @@ interface UpdateCmsPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated CMS plugin options. */
+    /** Replacement options for the CMS plugin. Omitted options use their defaults. */
     cmsOptions: PluginCmsOptions;
 }
 interface UpdateCmsPluginResponse {
@@ -1759,7 +1875,7 @@ interface UpdateCatalogPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated Catalog plugin options. */
+    /** Replacement options for the Catalog plugin. Omitted options use their defaults. */
     catalogOptions: CatalogOptions;
 }
 interface UpdateCatalogPluginResponse {
@@ -1774,7 +1890,11 @@ interface AddDraftItemsPluginRequest {
     dataCollectionId: string;
     /** Draft Items plugin options. */
     draftItemsOptions: DraftItemsPluginOptions;
-    /** Action to take when the Publish plugin is already installed. */
+    /**
+     * Action to take when the Publish plugin is already installed.
+     *
+     * Default: `FAIL_WHEN_PUBLISH_INSTALLED`.
+     */
     publishPluginConflictAction?: PublishPluginConflictActionWithLiterals;
 }
 /** Behavior to apply when adding the Draft Items plugin to a collection that already has the Publish plugin. */
@@ -1796,7 +1916,11 @@ interface DeleteDraftItemsPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Action to take for existing draft items. */
+    /**
+     * Action to take for existing draft items.
+     *
+     * Default: `FAIL_IF_DRAFT_ITEMS_EXIST`.
+     */
     draftItemsRemovalAction?: DraftItemsRemovalActionWithLiterals;
 }
 /** Behavior to apply to existing draft items when removing the Draft Items plugin. */
@@ -1820,7 +1944,10 @@ interface UpdateDraftItemsPluginRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Updated Draft Items plugin options. Read-only fields are ignored. */
+    /**
+     * Replacement writable options for the Draft Items plugin. Omitted options use their defaults.
+     * Server-managed paired collection IDs are preserved.
+     */
     draftItemsOptions: DraftItemsPluginOptions;
 }
 interface UpdateDraftItemsPluginResponse {
@@ -1833,7 +1960,7 @@ interface PatchDataCollectionFieldRequest {
      * @maxLength 256
      */
     dataCollectionId: string;
-    /** Field to update. */
+    /** Field to update. Specify `key` to identify the existing field. */
     field: Field;
 }
 interface PatchDataCollectionFieldResponse {
@@ -1854,6 +1981,7 @@ interface UpdateDataPermissionsResponse {
     dataCollection?: DataCollection;
 }
 interface BulkGetDataCollectionsPageBySnapshotsRequest extends BulkGetDataCollectionsPageBySnapshotsRequestTenantModeOptionsOneOf {
+    /** App whose collection snapshots to retrieve. */
     appOptions?: AppOptions;
     /**
      * Ids of schema snapshot
@@ -1872,6 +2000,7 @@ interface BulkGetDataCollectionsPageBySnapshotsRequest extends BulkGetDataCollec
 }
 /** @oneof */
 interface BulkGetDataCollectionsPageBySnapshotsRequestTenantModeOptionsOneOf {
+    /** App whose collection snapshots to retrieve. */
     appOptions?: AppOptions;
 }
 declare enum TenantMode {
@@ -2152,15 +2281,27 @@ interface DeleteDataCollectionsSnapshotRequest {
 interface DeleteDataCollectionsSnapshotResponse {
 }
 interface CreateMigratedCollectionsSnapshotRequest {
-    /** @format GUID */
+    /**
+     * ID of the source snapshot.
+     * @format GUID
+     */
     existingSnapshotId?: string;
-    /** @maxLength 255 */
+    /**
+     * Namespace to assign to collections in the new snapshot.
+     * @maxLength 255
+     */
     newNamespace?: string;
-    /** @maxLength 255 */
+    /**
+     * Namespace to replace in the source snapshot.
+     * @maxLength 255
+     */
     existingNamespace?: string;
 }
 interface CreateMigratedCollectionsSnapshotResponse {
-    /** @format GUID */
+    /**
+     * ID of the created snapshot.
+     * @format GUID
+     */
     snapshotId?: string;
 }
 interface DomainEvent extends DomainEventBodyOneOf {
@@ -2317,7 +2458,7 @@ interface AccountInfo {
     siteId?: string | null;
 }
 /**
- * Creates a new data collection.
+ * Creates a data collection.
  *
  * The request body must include an ID, details for at least 1 field, and a permissions object. If any of these are missing, the collection isn't created.
  * @param collection - Collection details.
@@ -2333,25 +2474,26 @@ interface AccountInfo {
  * @param options - Options for creating a data collection.
  * @permissionId WIX_DATA.CREATE_COLLECTION
  * @applicableIdentity APP
- * @returns Details of collection created.
+ * @returns Created collection.
  * @fqn com.wixpress.cloud.data.api.collectionservice.DataCollectionService.CreateDataCollection
  */
 declare function createDataCollection(collection: NonNullablePaths<DataCollection, `_id` | `fields.${number}.key` | `fields.${number}.type` | `permissions.insert` | `permissions.read` | `permissions.remove` | `permissions.update`, 2>): Promise<NonNullablePaths<DataCollection, `_id` | `collectionType` | `defaultDisplayOrder.fieldKey` | `defaultDisplayOrder.direction` | `capabilities.dataOperations` | `capabilities.collectionOperations` | `capabilities.indexLimits.regular` | `capabilities.indexLimits.unique` | `capabilities.indexLimits.total` | `fields` | `fields.${number}.key` | `fields.${number}.type` | `fields.${number}.typeMetadata.reference.referencedCollectionId` | `fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `fields.${number}.typeMetadata.array.elementType` | `fields.${number}.systemField` | `fields.${number}.capabilities.sortable` | `fields.${number}.encrypted` | `fields.${number}.condition.permission` | `permissions.insert` | `permissions.update` | `permissions.remove` | `permissions.read` | `plugins` | `plugins.${number}.publishOptions.defaultStatus` | `plugins.${number}.singleItemOptions.singleItemId` | `plugins.${number}.urlizedOptions.format` | `plugins.${number}.editablePageLinkOptions.isPersisted` | `plugins.${number}.editablePageLinkOptions.isMutable` | `plugins.${number}.type` | `pagingModes` | `deprecation.deprecated`, 4>>;
 /**
  * Retrieves a data collection by ID.
  *
- * Starting on August 3rd, 2026, when called with a visitor (unauthenticated) identity, the response contains only
- * the collection details needed to display the collection's data: `id`, `displayName`, `displayField`, `plugins`,
- * and for each field in `fields` its `key`, `displayName`, `type`, and `typeMetadata`. All other collection
- * details, such as `permissions` and `capabilities`, are omitted. Calls made with any other identity return the
- * full collection.
+ * Calls made with a visitor (unauthenticated) identity return a limited collection view.
+ * The response includes display information, plugins, paging information, and supported operations.
+ * It omits permissions, creation and update dates, index limits, and field descriptions and encryption settings.
+ * Other identities return the full collection, subject to the requested field selection.
+ *
+ * To retrieve multiple collections in one call, use [Bulk Get Data Collections](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/bulk-get-data-collections).
  * @param dataCollectionId - ID of the collection to retrieve.
  * @public
  * @requiredField dataCollectionId
  * @param options - Options for retrieving a data collection.
  * @permissionId WIX_DATA.GET_COLLECTION
  * @applicableIdentity APP
- * @returns Details of the collection requested.
+ * @returns Requested collection.
  * @fqn com.wixpress.cloud.data.api.collectionservice.DataCollectionService.GetDataCollection
  */
 declare function getDataCollection(dataCollectionId: string, options?: GetDataCollectionOptions): Promise<NonNullablePaths<DataCollection, `_id` | `collectionType` | `defaultDisplayOrder.fieldKey` | `defaultDisplayOrder.direction` | `capabilities.dataOperations` | `capabilities.collectionOperations` | `capabilities.indexLimits.regular` | `capabilities.indexLimits.unique` | `capabilities.indexLimits.total` | `fields` | `fields.${number}.key` | `fields.${number}.type` | `fields.${number}.typeMetadata.reference.referencedCollectionId` | `fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `fields.${number}.typeMetadata.array.elementType` | `fields.${number}.systemField` | `fields.${number}.capabilities.sortable` | `fields.${number}.encrypted` | `fields.${number}.condition.permission` | `permissions.insert` | `permissions.update` | `permissions.remove` | `permissions.read` | `plugins` | `plugins.${number}.publishOptions.defaultStatus` | `plugins.${number}.singleItemOptions.singleItemId` | `plugins.${number}.urlizedOptions.format` | `plugins.${number}.editablePageLinkOptions.isPersisted` | `plugins.${number}.editablePageLinkOptions.isMutable` | `plugins.${number}.type` | `pagingModes` | `deprecation.deprecated`, 4>>;
@@ -2365,17 +2507,20 @@ interface GetDataCollectionOptions {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 1000
      */
     fields?: string[];
 }
 /**
- * Retrieves a list of all data collections associated with the site or project.
+ * Retrieves a page of data collections associated with the site or project.
  *
- * By default, the list is ordered by ID in ascending order.
+ * By default, results are sorted by `id` in ascending order, `paging.limit` is `1000`, and `paging.offset` is `0`.
+ * The maximum page size is `1000`. Larger limits are reduced to `1000`.
+ * To retrieve the next page, increase `paging.offset` by the number of collections returned.
  * @public
  * @param options - Options for retrieving a list of data collections.
  * @permissionId WIX_DATA.LIST_COLLECTIONS
@@ -2387,10 +2532,16 @@ interface ListDataCollectionsOptions {
     /**
      * Defines how collections in the response are sorted.
      *
-     * Default: Ordered by ID in ascending order.
+     * Supported properties: `id`, `displayName`, `createdDate`, `updatedDate`.
+     *
+     * Default: `id` in ascending order.
      */
     sort?: Sorting;
-    /** Pagination information. */
+    /**
+     * Pagination information. The maximum page size is `1000`.
+     *
+     * Default: `limit` is `1000` and `offset` is `0`.
+     */
     paging?: Paging;
     /**
      * Whether to retrieve data from the primary database instance.
@@ -2401,8 +2552,9 @@ interface ListDataCollectionsOptions {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 128
      */
@@ -2411,11 +2563,16 @@ interface ListDataCollectionsOptions {
 /**
  * Retrieves multiple data collections by ID.
  *
- * Starting on August 3rd, 2026, when called with a visitor (unauthenticated) identity, the returned collections
- * contain only the details needed to display the collections' data: `id`, `displayName`, `displayField`,
- * `plugins`, and for each field in `fields` its `key`, `displayName`, `type`, and `typeMetadata`. All other
- * collection details, such as `permissions` and `capabilities`, are omitted. Calls made with any other identity
- * return the full collections.
+ * Calls made with a visitor (unauthenticated) identity return a limited collection view.
+ * The response includes display information, plugins, paging information, and supported operations.
+ * It omits permissions, creation and update dates, index limits, and field descriptions and encryption settings.
+ * Other identities return the full collection, subject to the requested field selection.
+ *
+ * Successful results are returned in `activeCollections` and, when requested, `deletedCollections`.
+ * Collection loading failures are returned separately in `failedCollections`.
+ * Results are sorted by `id` in ascending order unless `sort` specifies a different order.
+ *
+ * To retrieve a single collection, call [Get Data Collection](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/get-data-collection).
  * @public
  * @documentationMaturity preview
  * @permissionId WIX_DATA.BULK_GET_COLLECTIONS
@@ -2443,7 +2600,13 @@ interface BulkGetDataCollectionsOptions {
      * Default: `false`
      */
     includeReferencedCollections?: boolean;
-    /** Sorting preferences. */
+    /**
+     * Sorting preferences for active and deleted collections. Results aren't returned in request order.
+     *
+     * Supported properties: `id`, `displayName`, `createdDate`, `updatedDate`.
+     *
+     * Default: `id` in ascending order.
+     */
     sort?: Sorting;
     /**
      * Whether to retrieve data from the primary database instance.
@@ -2454,8 +2617,9 @@ interface BulkGetDataCollectionsOptions {
      */
     consistentRead?: boolean;
     /**
-     * List of specific field names to return, if empty all fields are returned.
-     * Affects all returned collections
+     * Top-level collection properties to return, using camelCase names, such as `displayName`.
+     * Applies to every returned collection. `id`, `revision`, and `collectionType` are always retained.
+     * An empty list returns all properties available to the caller.
      * @maxSize 100
      * @maxLength 1000
      */
@@ -2505,7 +2669,7 @@ declare function updateDataCollection(collection: NonNullablePaths<DataCollectio
  *
  * Before deleting a collection:
  * - Make sure the collection isn't connected to any site pages or elements.
- * - You can create a manual backup of a collections with the Backups API, in case you need to restore them later.
+ * - You can create a manual backup of collections with the Backups API, in case you need to restore them later.
  * - You can also export a collection to a CSV file with the Data Movement Jobs API, if you want to save the data outside of Wix.
  *
  * > **Note:**
@@ -2519,10 +2683,10 @@ declare function updateDataCollection(collection: NonNullablePaths<DataCollectio
  */
 declare function deleteDataCollection(dataCollectionId: string): Promise<void>;
 /**
- * Restores recently deleted collection.
+ * Restores a recently deleted data collection.
  *
  * Fails with `WDE0025` if collection was deleted too long ago or has never existed.
- * @param dataCollectionId - Data Collection ID to restore
+ * @param dataCollectionId - ID of the data collection to restore.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2579,6 +2743,8 @@ interface PatchDataCollection {
     maxPageSize?: number | null;
     /**
      * Collection's display name as shown in the CMS. For example, `My First Collection`.
+     *
+     * Default: The collection ID.
      * @maxLength 1000
      */
     displayName?: string | null;
@@ -2596,6 +2762,8 @@ interface PatchDataCollection {
     displayNamespace?: string | null;
     /**
      * Field whose value the CMS displays to represent the collection item when referenced in a different collection.
+     *
+     * Default: The first field in the request, or `title` if no fields are specified.
      * @maxLength 1000
      */
     displayField?: string | null;
@@ -2663,13 +2831,13 @@ interface CreateDataCollectionFieldOptions {
     field: Field;
 }
 /**
- * Updates properties in a [data collection's](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/create-data-collection) `fields` array.
+ * Replaces the definition of a field in a data collection.
  *
  * <blockquote class="important">
  * <strong>Important:</strong>
  *
- * After `fields` is updated, it only contains the properties included in the Update Data Collection Field request.
- * If the existing `fields` array has properties with values and those properties aren't included in the updated details, their values are lost.<br/><br/>
+ * The field identified by `field.key` is replaced with the supplied definition.
+ * Properties omitted from that field definition aren't preserved. Other fields in the collection aren't replaced.<br/><br/>
  *
  * To update only specific properties in the array without affecting others, use [Patch Data Collection Field](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/patch-data-collection-field).
  * </blockquote>
@@ -2753,6 +2921,8 @@ interface DeleteDataCollectionPluginOptions {
 }
 /**
  * Adds the Publish plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2768,11 +2938,17 @@ declare function addPublishPlugin(dataCollectionId: string, options?: NonNullabl
 interface AddPublishPluginOptions {
     /** Publish plugin options. */
     publishOptions: PublishPluginOptions;
-    /** Action to take when the Draft Items plugin is already installed. */
+    /**
+     * Action to take when the Draft Items plugin is already installed.
+     *
+     * Default: `FAIL_WHEN_DRAFT_ITEMS_INSTALLED`.
+     */
     draftItemsPluginConflictAction?: DraftItemsPluginConflictActionWithLiterals;
 }
 /**
  * Removes the Publish plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2784,6 +2960,9 @@ interface AddPublishPluginOptions {
 declare function deletePublishPlugin(dataCollectionId: string): Promise<NonNullablePaths<DeletePublishPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 /**
  * Updates the Publish plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2796,11 +2975,16 @@ declare function deletePublishPlugin(dataCollectionId: string): Promise<NonNulla
  */
 declare function updatePublishPlugin(dataCollectionId: string, options: NonNullablePaths<UpdatePublishPluginOptions, `publishOptions`, 0>): Promise<NonNullablePaths<UpdatePublishPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdatePublishPluginOptions {
-    /** Updated Publish plugin options. Read-only fields are ignored. */
+    /**
+     * Replacement writable options for the Publish plugin. Omitted options use their defaults.
+     * Server-managed lifecycle status is preserved.
+     */
     publishOptions: PublishPluginOptions;
 }
 /**
  * Adds the Urlized plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2819,6 +3003,8 @@ interface AddUrlizedPluginOptions {
 }
 /**
  * Removes the Urlized plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2830,6 +3016,9 @@ interface AddUrlizedPluginOptions {
 declare function deleteUrlizedPlugin(dataCollectionId: string): Promise<NonNullablePaths<DeleteUrlizedPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 /**
  * Updates the Urlized plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2842,11 +3031,13 @@ declare function deleteUrlizedPlugin(dataCollectionId: string): Promise<NonNulla
  */
 declare function updateUrlizedPlugin(dataCollectionId: string, options: NonNullablePaths<UpdateUrlizedPluginOptions, `urlizedOptions`, 0>): Promise<NonNullablePaths<UpdateUrlizedPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdateUrlizedPluginOptions {
-    /** Updated Urlized plugin options. */
+    /** Replacement options for the Urlized plugin. Omitted options use their defaults. */
     urlizedOptions: UrlizedPluginOptions;
 }
 /**
  * Adds the Multilingual plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2865,6 +3056,8 @@ interface AddMultilingualPluginOptions {
 }
 /**
  * Removes the Multilingual plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2876,6 +3069,9 @@ interface AddMultilingualPluginOptions {
 declare function deleteMultilingualPlugin(dataCollectionId: string): Promise<NonNullablePaths<DeleteMultilingualPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 /**
  * Updates the Multilingual plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2888,11 +3084,13 @@ declare function deleteMultilingualPlugin(dataCollectionId: string): Promise<Non
  */
 declare function updateMultilingualPlugin(dataCollectionId: string, options: NonNullablePaths<UpdateMultilingualPluginOptions, `multilingualOptions`, 0>): Promise<NonNullablePaths<UpdateMultilingualPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdateMultilingualPluginOptions {
-    /** Updated Multilingual plugin options. */
+    /** Replacement options for the Multilingual plugin. Omitted options use their defaults. */
     multilingualOptions: MultilingualOptions;
 }
 /**
  * Adds the CMS plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2911,6 +3109,8 @@ interface AddCmsPluginOptions {
 }
 /**
  * Removes the CMS plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2922,6 +3122,9 @@ interface AddCmsPluginOptions {
 declare function deleteCmsPlugin(dataCollectionId: string): Promise<NonNullablePaths<DeleteCmsPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 /**
  * Updates the CMS plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2934,11 +3137,13 @@ declare function deleteCmsPlugin(dataCollectionId: string): Promise<NonNullableP
  */
 declare function updateCmsPlugin(dataCollectionId: string, options: NonNullablePaths<UpdateCmsPluginOptions, `cmsOptions`, 0>): Promise<NonNullablePaths<UpdateCmsPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdateCmsPluginOptions {
-    /** Updated CMS plugin options. */
+    /** Replacement options for the CMS plugin. Omitted options use their defaults. */
     cmsOptions: PluginCmsOptions;
 }
 /**
  * Adds the Catalog plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -2957,6 +3162,8 @@ interface AddCatalogPluginOptions {
 }
 /**
  * Removes the Catalog plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2968,6 +3175,9 @@ interface AddCatalogPluginOptions {
 declare function deleteCatalogPlugin(dataCollectionId: string): Promise<NonNullablePaths<DeleteCatalogPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 /**
  * Updates the Catalog plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -2980,11 +3190,13 @@ declare function deleteCatalogPlugin(dataCollectionId: string): Promise<NonNulla
  */
 declare function updateCatalogPlugin(dataCollectionId: string, options: NonNullablePaths<UpdateCatalogPluginOptions, `catalogOptions`, 0>): Promise<NonNullablePaths<UpdateCatalogPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdateCatalogPluginOptions {
-    /** Updated Catalog plugin options. */
+    /** Replacement options for the Catalog plugin. Omitted options use their defaults. */
     catalogOptions: CatalogOptions;
 }
 /**
  * Adds the Draft Items plugin to a data collection.
+ *
+ * Fails if the collection already has this plugin.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -3000,11 +3212,17 @@ declare function addDraftItemsPlugin(dataCollectionId: string, options?: NonNull
 interface AddDraftItemsPluginOptions {
     /** Draft Items plugin options. */
     draftItemsOptions: DraftItemsPluginOptions;
-    /** Action to take when the Publish plugin is already installed. */
+    /**
+     * Action to take when the Publish plugin is already installed.
+     *
+     * Default: `FAIL_WHEN_PUBLISH_INSTALLED`.
+     */
     publishPluginConflictAction?: PublishPluginConflictActionWithLiterals;
 }
 /**
  * Removes the Draft Items plugin from a data collection.
+ *
+ * Fails if the collection doesn't have this plugin.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -3016,11 +3234,18 @@ interface AddDraftItemsPluginOptions {
  */
 declare function deleteDraftItemsPlugin(dataCollectionId: string, options?: DeleteDraftItemsPluginOptions): Promise<NonNullablePaths<DeleteDraftItemsPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface DeleteDraftItemsPluginOptions {
-    /** Action to take for existing draft items. */
+    /**
+     * Action to take for existing draft items.
+     *
+     * Default: `FAIL_IF_DRAFT_ITEMS_EXIST`.
+     */
     draftItemsRemovalAction?: DraftItemsRemovalActionWithLiterals;
 }
 /**
  * Updates the Draft Items plugin options on a data collection.
+ *
+ * The plugin must already be installed. The supplied options replace its writable options; omitted options use their defaults.
+ * Server-managed properties are preserved, and other plugins aren't changed.
  * @param dataCollectionId - ID of the data collection to update.
  * @public
  * @documentationMaturity preview
@@ -3033,17 +3258,20 @@ interface DeleteDraftItemsPluginOptions {
  */
 declare function updateDraftItemsPlugin(dataCollectionId: string, options: NonNullablePaths<UpdateDraftItemsPluginOptions, `draftItemsOptions`, 0>): Promise<NonNullablePaths<UpdateDraftItemsPluginResponse, `dataCollection._id` | `dataCollection.collectionType` | `dataCollection.defaultDisplayOrder.fieldKey` | `dataCollection.defaultDisplayOrder.direction` | `dataCollection.capabilities.dataOperations` | `dataCollection.capabilities.collectionOperations` | `dataCollection.capabilities.indexLimits.regular` | `dataCollection.capabilities.indexLimits.unique` | `dataCollection.capabilities.indexLimits.total` | `dataCollection.fields` | `dataCollection.fields.${number}.key` | `dataCollection.fields.${number}.type` | `dataCollection.fields.${number}.typeMetadata.reference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencedCollectionId` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingFieldKey` | `dataCollection.fields.${number}.typeMetadata.multiReference.referencingDisplayName` | `dataCollection.fields.${number}.typeMetadata.array.elementType` | `dataCollection.fields.${number}.systemField` | `dataCollection.fields.${number}.capabilities.sortable` | `dataCollection.fields.${number}.encrypted` | `dataCollection.fields.${number}.condition.permission` | `dataCollection.permissions.insert` | `dataCollection.permissions.update` | `dataCollection.permissions.remove` | `dataCollection.permissions.read` | `dataCollection.plugins` | `dataCollection.plugins.${number}.publishOptions.defaultStatus` | `dataCollection.plugins.${number}.singleItemOptions.singleItemId` | `dataCollection.plugins.${number}.urlizedOptions.format` | `dataCollection.plugins.${number}.editablePageLinkOptions.isPersisted` | `dataCollection.plugins.${number}.editablePageLinkOptions.isMutable` | `dataCollection.plugins.${number}.type` | `dataCollection.pagingModes` | `dataCollection.deprecation.deprecated`, 5>>;
 interface UpdateDraftItemsPluginOptions {
-    /** Updated Draft Items plugin options. Read-only fields are ignored. */
+    /**
+     * Replacement writable options for the Draft Items plugin. Omitted options use their defaults.
+     * Server-managed paired collection IDs are preserved.
+     */
     draftItemsOptions: DraftItemsPluginOptions;
 }
 /**
- * Updates specified properties  in a [data collection's](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/create-data-collection) `fields` array.
+ * Updates specified properties of a field in a data collection.
  *
  * When you change a field's type, existing values aren't migrated. Use [Bulk Update Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-update-data-items) or [Bulk Patch Data Items](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/bulk-patch-data-items) to update item values to match the new type.
  *
  * To update properties in a data collection other than `fields`, use [Patch Data Collection](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/patch-data-collection).
  * @param dataCollectionId - ID of the data collection to update.
- * @param field - Field to update.
+ * @param field - Field to update. Specify `key` to identify the existing field.
  * @public
  * @requiredField dataCollectionId
  * @requiredField field