@wix/auto_sdk_crm_contacts-v-5 1.0.5 → 1.0.7

package/build/cjs/{contacts-v5-contact-contacts-v-5.universal-Bkb1VwgJ.d.ts → contacts-v5-contact-contacts-v-5.universal-B3ebcTEk.d.ts}

@@ -20,19 +20,19 @@ interface Contact {
      */
     revision?: string | null;
     /**
-     * Date and time the Contact was created.
+     * Date and time the contact was created.
      * @readonly
      * @immutable
      */
     _createdDate?: Date | null;
     /**
-     * Date and time the Contact was last updated.
+     * Date and time the contact was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Contact External ID. Used to identify contacts from external systems.
-     * This field can only be set once and cannot be updated after creation.
+     * Contact external ID. Used to identify contacts from external systems.
+     * This field can only be set once and can't be updated after creation.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -122,7 +122,7 @@ interface Contact {
      */
     lastActivity?: ContactActivity;
     /**
-     * List of Contact segment IDs that this contact belongs to.
+     * IDs of the segments the contact belongs to.
      * Segments are used for organizing and targeting groups of contacts.
      * @maxSize 60
      * @readonly
@@ -232,7 +232,8 @@ interface AdditionalEmail {
 interface ContactPhone {
     /**
      * Phone type classification. Helps categorize the phone number's purpose.
-     * Default value: OTHER
+     *
+     * Default: `OTHER`
      */
     tag?: PhoneTagWithLiterals;
     /**
@@ -288,7 +289,8 @@ type PhoneDeliverabilityStatusWithLiterals = PhoneDeliverabilityStatus | 'NO_PHO
 interface AdditionalPhone {
     /**
      * Phone type classification for the additional phone number.
-     * Default value: OTHER
+     *
+     * Default: `OTHER`
      */
     tag?: PhoneTagWithLiterals;
     /**
@@ -309,7 +311,8 @@ interface AdditionalPhone {
 interface ContactAddress {
     /**
      * Address type classification. Helps categorize the address purpose.
-     * Default value: OTHER
+     *
+     * Default: `OTHER`
      */
     tag?: AddressTagWithLiterals;
     /**
@@ -318,18 +321,17 @@ interface ContactAddress {
      */
     address?: Address;
     /**
-     * Indicates whether this address is the primary/default address for the contact.
+     * Whether this address is the contact's default address.
      * Only one address can be designated as default per contact.
      * If no address is explicitly set as default, the first address automatically becomes the default.
-     * All other addresses will have this field set to false.
      */
     defaultAddress?: boolean | null;
     /**
-     * Address ID
+     * Address ID.
      * @format GUID
      */
     addressId?: string | null;
-    /** Address recipient information for delivery purposes */
+    /** Address recipient information for delivery purposes. */
     recipient?: Recipient;
 }
 declare enum AddressTag {
@@ -341,7 +343,7 @@ declare enum AddressTag {
 }
 /** @enumType */
 type AddressTagWithLiterals = AddressTag | 'OTHER' | 'HOME' | 'WORK' | 'BILLING' | 'SHIPPING';
-/** Physical address */
+/** Physical address, such as a billing or shipping address. */
 interface Address extends AddressStreetOneOf {
     /** Street address object, with number and name in separate fields. */
     streetAddress?: StreetAddress;
@@ -357,7 +359,7 @@ interface Address extends AddressStreetOneOf {
      */
     country?: string | null;
     /**
-     * Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. e.g. NY
+     * Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. For example, `NY`.
      * @format SUBDIVISION
      */
     subdivision?: string | null;
@@ -433,7 +435,7 @@ interface StreetAddress {
      */
     apt?: string;
     /**
-     * Optional address line 1
+     * Optional formatted version of the street address line.
      * @maxLength 2000
      */
     formattedAddressLine?: string | null;
@@ -454,7 +456,7 @@ interface AddressLocation {
 }
 interface Subdivision {
     /**
-     * subdivision short code
+     * Subdivision short code.
      * @maxLength 20
      */
     code?: string;
@@ -463,7 +465,7 @@ interface Subdivision {
      * @maxLength 100
      */
     name?: string;
-    /** Subdivision level */
+    /** Subdivision level. */
     type?: SubdivisionTypeWithLiterals;
     /**
      * Free text description of subdivision type.
@@ -474,25 +476,25 @@ interface Subdivision {
 }
 declare enum SubdivisionType {
     UNKNOWN_SUBDIVISION_TYPE = "UNKNOWN_SUBDIVISION_TYPE",
-    /** State */
+    /** State. */
     ADMINISTRATIVE_AREA_LEVEL_1 = "ADMINISTRATIVE_AREA_LEVEL_1",
-    /** County */
+    /** County. */
     ADMINISTRATIVE_AREA_LEVEL_2 = "ADMINISTRATIVE_AREA_LEVEL_2",
-    /** City/town */
+    /** City/town. */
     ADMINISTRATIVE_AREA_LEVEL_3 = "ADMINISTRATIVE_AREA_LEVEL_3",
-    /** Neighborhood/quarter */
+    /** Neighborhood/quarter. */
     ADMINISTRATIVE_AREA_LEVEL_4 = "ADMINISTRATIVE_AREA_LEVEL_4",
-    /** Street/block */
+    /** Street/block. */
     ADMINISTRATIVE_AREA_LEVEL_5 = "ADMINISTRATIVE_AREA_LEVEL_5",
-    /** ADMINISTRATIVE_AREA_LEVEL_0. Indicates the national political entity, and is typically the highest order type returned by the Geocoder. */
+    /** Equivalent to `ADMINISTRATIVE_AREA_LEVEL_0`. Indicates the national political entity, and is typically the highest order type returned by the Geocoder. */
     COUNTRY = "COUNTRY"
 }
 /** @enumType */
 type SubdivisionTypeWithLiterals = SubdivisionType | 'UNKNOWN_SUBDIVISION_TYPE' | 'ADMINISTRATIVE_AREA_LEVEL_1' | 'ADMINISTRATIVE_AREA_LEVEL_2' | 'ADMINISTRATIVE_AREA_LEVEL_3' | 'ADMINISTRATIVE_AREA_LEVEL_4' | 'ADMINISTRATIVE_AREA_LEVEL_5' | 'COUNTRY';
-/** Subdivision Concordance values */
+/** Subdivision concordance values. */
 interface StandardDetails {
     /**
-     * subdivision iso-3166-2 code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). e.g. US-NY, GB-SCT, NO-30
+     * Subdivision code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). For example, `US-NY`, `GB-SCT`, `NO-30`.
      * @maxLength 20
      */
     iso31662?: string | null;
@@ -668,8 +670,9 @@ interface GroupInfo {
      */
     groupIds?: string[];
 }
+/** Tags assigned to an entity that require an additional permission to access. */
 interface PrivateTags {
-    /** Tags that are exposed to anyone with access to the entity. */
+    /** Tags that require an additional permission to access, normally not given to site members or visitors. */
     privateTags?: TagList;
 }
 interface TagList {
@@ -954,26 +957,26 @@ interface BulkUpdateContactSubscriptionsRequest {
     phoneSubscriptionStatus?: V5SubscriptionStatusWithLiterals;
 }
 interface SearchDetails {
-    /** Defines how separate search terms in `expression` are combined */
+    /** How separate search terms in `expression` are combined. */
     mode?: ModeWithLiterals;
     /**
-     * Search term or expression
+     * Search term or expression.
      * @maxLength 100
      */
     expression?: string | null;
     /**
-     * Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
+     * Fields to search in. If empty, searches all searchable fields. Use dot notation to specify the JSON path.
      * @maxLength 200
      * @maxSize 20
      */
     fields?: string[];
-    /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
+    /** Whether to use fuzzy search, which allows typos using a managed proximity algorithm. */
     fuzzy?: boolean;
 }
 declare enum Mode {
-    /** Any of the search terms must be present */
+    /** Any of the search terms must be present. */
     OR = "OR",
-    /** All search terms must be present */
+    /** All search terms must be present. */
     AND = "AND"
 }
 /** @enumType */
@@ -1064,16 +1067,16 @@ interface BulkDelete {
     items?: Delete[];
 }
 interface CreateContactRequest {
-    /** Contact to be created. */
+    /** Contact to create. */
     contact: Contact;
     /**
-     * Allows creating a duplicate contact.
+     * Whether to create the contact even if it duplicates an existing contact.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
 }
 interface CreateContactResponse {
-    /** The created Contact. */
+    /** Created contact. */
     contact?: Contact;
     /**
      * The upload ID of the image upload process.
@@ -1083,11 +1086,11 @@ interface CreateContactResponse {
 }
 interface DuplicateContactExists {
     /**
-     * The ID of an existing contact that matches a duplicate in the request.
+     * ID of an existing contact that matches a duplicate in the request.
      * @format GUID
      */
     matchingContactId?: string | null;
-    /** The field(s) of an existing contact that match a duplicate in the request. */
+    /** Field or fields of an existing contact that match a duplicate in the request. */
     matchType?: MatchTypeWithLiterals;
 }
 declare enum MatchType {
@@ -1100,26 +1103,26 @@ declare enum MatchType {
 type MatchTypeWithLiterals = MatchType | 'EMAIL' | 'PHONE' | 'EXTERNAL_ID' | 'EMAIL_AND_PHONE';
 interface GetContactRequest {
     /**
-     * ID of the Contact to retrieve.
+     * ID of the contact to retrieve.
      * @format GUID
      */
     contactId: string;
 }
 interface GetContactResponse {
-    /** The requested Contact. */
+    /** Retrieved contact. */
     contact?: Contact;
 }
 interface UpdateContactRequest {
-    /** Contact to be updated, may be partial. */
+    /** Contact to update. May be partial. */
     contact: Contact;
     /**
-     * Allows updating the contact even if it becomes a duplicate of another contact.
+     * Whether to update the contact even if it becomes a duplicate of another contact.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
 }
 interface UpdateContactResponse {
-    /** Updated Contact. */
+    /** Updated contact. */
     contact?: Contact;
     /**
      * The upload ID of the image upload process.
@@ -1128,19 +1131,19 @@ interface UpdateContactResponse {
     imageUploadId?: string | null;
 }
 interface UpsertContactRequest {
-    /** Contact to be upserted. */
+    /** Contact to upsert. */
     contact: Contact;
-    /** The mode in which the upsert should work in. */
+    /** Mode that determines how an existing contact is updated when a match is found. See the endpoint description for the supported modes. */
     upsertMode?: UpsertModeWithLiterals;
-    /** Indicates whether to update the contact even if it is a site member. */
+    /** Whether to update the contact even if it's a site member. */
     updateMember?: boolean | null;
 }
 declare enum UpsertMode {
-    /** Fields will be overwritten (default). */
+    /** Replaces existing field values. Default value. */
     OVERWRITE = "OVERWRITE",
-    /** Fields will be appended. Non-array fields will be set only if it does not have an existing value. */
+    /** Sets a non-array field only if it doesn't already have a value, and appends to array fields. */
     APPEND = "APPEND",
-    /** Array fields, will be appended. Non-array fields will be overwritten. */
+    /** Overwrites non-array fields and appends to array fields. */
     OVERWRITE_APPEND_ARRAYS = "OVERWRITE_APPEND_ARRAYS"
 }
 /** @enumType */
@@ -1171,17 +1174,17 @@ interface FailedMemberUpdate {
 }
 interface UpdateContactTagsRequest {
     /**
-     * The contact from which to add or remove tags.
+     * ID of the contact whose tags to update.
      * @format GUID
      */
     contactId: string;
-    /** The tags to add. */
+    /** Tags to assign. */
     assignTags?: PrivateTags;
-    /** The tags to remove. */
+    /** Tags to unassign. */
     unassignTags?: PrivateTags;
 }
 interface UpdateContactTagsResponse {
-    /** Updated Contact. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface MergeContactsRequest {
@@ -1190,9 +1193,12 @@ interface MergeContactsRequest {
      * @format GUID
      */
     targetContactId: string;
-    /** Target contact revision number, which increments by 1 each time the contact is updated to prevent conflicting changes. */
+    /**
+     * Revision number of the target contact, which increments by 1 each time the contact is updated.
+     * The current revision must be passed to prevent conflicting changes.
+     */
     targetContactRevision: string | null;
-    /** When the target contact is provided, the merged result will be overwritten. */
+    /** Contact to overwrite the target with, instead of merging in the source contacts' data. See the endpoint description for details. */
     targetContact?: Contact;
     /**
      * IDs of up to 5 contacts to merge into the target contact.
@@ -1203,11 +1209,14 @@ interface MergeContactsRequest {
      * @format GUID
      */
     sourceContactIds?: string[];
-    /** Indicates whether to only return a preview of the merged contact or perform the actual merge. */
+    /**
+     * Whether to return a preview of the merged contact instead of performing the actual merge.
+     *
+     * Default: `false`
+     */
     preview?: boolean | null;
     /**
-     * Allows updating the target contact even if it becomes a duplicate of another contact.
-     * This can happen only where the target contact is provided.
+     * Whether to update the target contact even if it becomes a duplicate of another contact. Relevant only when `targetContact` is provided.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
@@ -1218,13 +1227,14 @@ interface MergeContactsResponse {
 }
 interface DeleteContactRequest {
     /**
-     * Id of the Contact to delete.
+     * ID of the contact to delete.
      * @format GUID
      */
     contactId: string;
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the contact even if it's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMember?: boolean | null;
 }
@@ -1232,7 +1242,7 @@ interface DeleteContactResponse {
 }
 interface FindMatchingContactsRequest {
     /**
-     * Contact External ID.
+     * Contact external ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -1250,7 +1260,7 @@ interface FindMatchingContactsRequest {
     phone?: string | null;
 }
 interface FindMatchingContactsResponse {
-    /** List of Contacts. At most 100 contacts are returned. */
+    /** Matching contacts, ordered by match strength. At most 100 contacts are returned. */
     contacts?: Contact[];
 }
 interface QueryContactsRequest {
@@ -1318,13 +1328,14 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QueryContactsResponse {
-    /** List of Contacts. */
+    /** Retrieved contacts. */
     contacts?: Contact[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
+/** Paging metadata for cursor-based pagination. */
 interface CursorPagingMetadata {
-    /** Number of items returned in current page. */
+    /** Number of items returned in the current page. */
     count?: number | null;
     /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors;
@@ -1337,8 +1348,8 @@ interface CursorPagingMetadata {
     hasNext?: boolean | null;
     /**
      * Total number of items matching the filter.
-     * Available only on the first page of *Search* results, not included in *Query* or *List* results.
-     * If the Search results span multiple pages, the value of `total` will exceed the number of items returned on the first page.
+     * Available only on the first page of Search results, not included in Query or List results.
+     * If the Search results span multiple pages, the value of `total` can exceed the number of items returned on the first page.
      */
     total?: number | null;
 }
@@ -1355,7 +1366,7 @@ interface Cursors {
     prev?: string | null;
 }
 interface SearchContactsRequest {
-    /** WQL search expression */
+    /** WQL search expression. */
     search?: CursorSearch;
     /**
      * Name Format for sorting and searching.
@@ -1389,7 +1400,7 @@ interface CursorSearch extends CursorSearchPagingMethodOneOf {
      */
     sort?: Sorting[];
     /**
-     * Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+     * Aggregations, also known as faceted search. Lets you explore large amounts of data by displaying summaries about different partitions of the data, and narrow the navigation to a specific partition.
      * @maxSize 10
      */
     aggregations?: Aggregation[];
@@ -1398,11 +1409,11 @@ interface CursorSearch extends CursorSearchPagingMethodOneOf {
     /**
      * UTC offset or IANA time zone. Valid values are
      * ISO 8601 UTC offsets, such as +02:00 or -06:00,
-     * and IANA time zone IDs, such as Europe/Rome
+     * and IANA time zone IDs, such as Europe/Rome.
      *
-     * Affects all filters and aggregations returned values.
-     * You may override this behavior in a specific filter by providing
-     * timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+     * Affects the values returned by all filters and aggregations.
+     * You can override this behavior in a specific filter by providing
+     * timestamps that include a time zone. For example, `"2023-12-20T10:52:34.795Z"`.
      * @maxLength 50
      */
     timeZone?: string | null;
@@ -1417,202 +1428,212 @@ interface CursorSearchPagingMethodOneOf {
     cursorPaging?: CursorPaging;
 }
 interface Aggregation extends AggregationKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation. */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation */
+    /** Nested aggregation. */
     nested?: NestedAggregation;
     /**
-     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * User-defined name for the aggregation. Must be unique. Appears in the aggregation results.
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation, client must provide matching aggregation field below */
+    /** Type of aggregation. Must match the aggregation type provided in the `kind` field. */
     type?: AggregationTypeWithLiterals;
     /**
-     * Field to aggregate by, use dot notation to specify json path
+     * Field to aggregate by. Use dot notation to specify the JSON path.
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface AggregationKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation. */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation */
+    /** Nested aggregation. */
     nested?: NestedAggregation;
 }
 interface RangeBucket {
-    /** Inclusive lower bound of the range. Required if to is not given */
+    /** Inclusive lower bound of the range. Required if `to` isn't given. */
     from?: number | null;
-    /** Exclusive upper bound of the range. Required if from is not given */
+    /** Exclusive upper bound of the range. Required if `from` isn't given. */
     to?: number | null;
 }
 declare enum SortType {
-    /** Should sort by number of matches */
+    /** Sorts by number of matches. */
     COUNT = "COUNT",
-    /** Should sort by value of the field alphabetically */
+    /** Sorts by the field's value, alphabetically. */
     VALUE = "VALUE"
 }
 /** @enumType */
 type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
 declare enum SortDirection {
-    /** Should sort in descending order */
+    /** Sorts in descending order. */
     DESC = "DESC",
-    /** Should sort in ascending order */
+    /** Sorts in ascending order. */
     ASC = "ASC"
 }
 /** @enumType */
 type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
 declare enum MissingValues {
-    /** Should missing values be excluded from the aggregation results */
+    /** Missing values are excluded from the aggregation results. */
     EXCLUDE = "EXCLUDE",
-    /** Should missing values be included in the aggregation results */
+    /** Missing values are included in the aggregation results. */
     INCLUDE = "INCLUDE"
 }
 /** @enumType */
 type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
 interface IncludeMissingValuesOptions {
     /**
-     * Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
+     * Custom name for the bucket that holds missing values.
+     *
+     * Default: `"N/A"` for string fields, `"0"` for integer fields, `"false"` for boolean fields.
      * @maxLength 20
      */
     addToBucket?: string;
 }
 declare enum ScalarType {
-    /** Count of distinct values */
+    /** Count of distinct values. */
     COUNT_DISTINCT = "COUNT_DISTINCT",
-    /** Minimum value */
+    /** Minimum value. */
     MIN = "MIN",
-    /** Maximum value */
+    /** Maximum value. */
     MAX = "MAX"
 }
 /** @enumType */
 type ScalarTypeWithLiterals = ScalarType | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
 declare enum NestedAggregationType {
-    /** An aggregation where result buckets are dynamically built - one per unique value */
+    /** An aggregation where result buckets are dynamically built, one per unique value. */
     VALUE = "VALUE",
-    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    /** An aggregation where you can define a set of ranges, each representing a bucket. */
     RANGE = "RANGE",
-    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    /** A single-value metric aggregation, such as min, max, sum, or avg. */
     SCALAR = "SCALAR",
-    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    /** An aggregation where result buckets are dynamically built, one per time interval (hour, day, week, and so on). */
     DATE_HISTOGRAM = "DATE_HISTOGRAM"
 }
 /** @enumType */
 type NestedAggregationTypeWithLiterals = NestedAggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
 interface ValueAggregation extends ValueAggregationOptionsOneOf {
-    /** Options for including missing values */
+    /** Options for including missing values. Used only when `missingValues` is `INCLUDE`. */
     includeOptions?: IncludeMissingValuesOptions;
-    /** Should sort by number of matches or value of the field */
+    /** How to sort the aggregation results: by number of matches or by field value. */
     sortType?: SortTypeWithLiterals;
-    /** Should sort in ascending or descending order */
+    /** Sort direction: ascending or descending. */
     sortDirection?: SortDirectionWithLiterals;
-    /** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
+    /**
+     * Number of aggregations to return.
+     *
+     * Default: `10`
+     */
     limit?: number | null;
-    /** Should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
+    /**
+     * Whether to include missing values in the aggregation results.
+     *
+     * Default: `EXCLUDE`
+     */
     missingValues?: MissingValuesWithLiterals;
 }
 /** @oneof */
 interface ValueAggregationOptionsOneOf {
-    /** Options for including missing values */
+    /** Options for including missing values. Used only when `missingValues` is `INCLUDE`. */
     includeOptions?: IncludeMissingValuesOptions;
 }
 interface RangeAggregation {
     /**
-     * List of range buckets, where during aggregation each entity will be placed in the first bucket where its value falls into based on provided range bounds
+     * Range buckets used for the aggregation. Each entity is placed in the first bucket whose range its value falls into.
      * @maxSize 50
      */
     buckets?: RangeBucket[];
 }
 interface ScalarAggregation {
-    /** Define the operator for the scalar aggregation */
+    /** Operator for the scalar aggregation. */
     type?: ScalarTypeWithLiterals;
 }
 interface DateHistogramAggregation {
-    /** Interval for date histogram aggregation */
+    /** Interval for the date histogram aggregation. */
     interval?: IntervalWithLiterals;
 }
 declare enum Interval {
-    /** Yearly interval */
+    /** Yearly interval. */
     YEAR = "YEAR",
-    /** Monthly interval */
+    /** Monthly interval. */
     MONTH = "MONTH",
-    /** Weekly interval */
+    /** Weekly interval. */
     WEEK = "WEEK",
-    /** Daily interval */
+    /** Daily interval. */
     DAY = "DAY",
-    /** Hourly interval */
+    /** Hourly interval. */
     HOUR = "HOUR",
-    /** Minute interval */
+    /** Minute interval. */
     MINUTE = "MINUTE",
-    /** Second interval */
+    /** Second interval. */
     SECOND = "SECOND"
 }
 /** @enumType */
 type IntervalWithLiterals = Interval | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
 interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation. */
     dateHistogram?: DateHistogramAggregation;
     /**
-     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * User-defined name for the aggregation. Must be unique. Appears in the aggregation results.
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation, client must provide matching aggregation field below */
+    /** Type of aggregation. Must match the aggregation type provided in the `kind` field. */
     type?: NestedAggregationTypeWithLiterals;
     /**
-     * Field to aggregate by, use dont notation to specify json path
+     * Field to aggregate by. Use dot notation to specify the JSON path.
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface NestedAggregationItemKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation. */
     dateHistogram?: DateHistogramAggregation;
 }
 declare enum AggregationType {
-    /** An aggregation where result buckets are dynamically built - one per unique value */
+    /** An aggregation where result buckets are dynamically built, one per unique value. */
     VALUE = "VALUE",
-    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    /** An aggregation where you can define a set of ranges, each representing a bucket. */
     RANGE = "RANGE",
-    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    /** A single-value metric aggregation, such as min, max, sum, or avg. */
     SCALAR = "SCALAR",
-    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    /** An aggregation where result buckets are dynamically built, one per time interval (hour, day, week, and so on). */
     DATE_HISTOGRAM = "DATE_HISTOGRAM",
-    /** Multi-level aggregation, where each next aggregation is nested within previous one */
+    /** Multi-level aggregation, where each next aggregation is nested within the previous one. */
     NESTED = "NESTED"
 }
 /** @enumType */
 type AggregationTypeWithLiterals = AggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
-/** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one */
+/** Nested aggregation expressed as a list of aggregations, where each next aggregation is nested within the previous one. */
 interface NestedAggregation {
     /**
-     * Flattened list of aggregations, where each next aggregation is nested within previous one
+     * Flattened list of aggregations, where each next aggregation is nested within the previous one.
      * @minSize 2
      * @maxSize 3
      */
@@ -1628,165 +1649,162 @@ declare enum NameFormat {
 /** @enumType */
 type NameFormatWithLiterals = NameFormat | 'BY_FIRST_NAME' | 'BY_LAST_NAME';
 interface SearchContactsResponse {
-    /** List of Contacts. */
+    /** Retrieved contacts. */
     contacts?: Contact[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
-    /** Aggregation data */
+    /** Aggregation data. */
     aggregationData?: AggregationData;
 }
 interface AggregationData {
     /**
-     * key = aggregation name (as derived from search request)
+     * Results of the requested aggregations.
      * @maxSize 10000
      */
     results?: AggregationResults[];
 }
 interface ValueAggregationResult {
     /**
-     * Value of the field
+     * Value of the field.
      * @maxLength 100
      */
     value?: string;
-    /** Count of entities with this value */
+    /** Count of entities with this value. */
     count?: number;
 }
 interface RangeAggregationResult {
-    /** Inclusive lower bound of the range */
+    /** Inclusive lower bound of the range. */
     from?: number | null;
-    /** Exclusive upper bound of the range */
+    /** Exclusive upper bound of the range. */
     to?: number | null;
-    /** Count of entities in this range */
+    /** Count of entities in this range. */
     count?: number;
 }
 interface ValueResults {
     /**
-     * List of value aggregations
+     * Value aggregation results.
      * @maxSize 250
      */
     results?: ValueAggregationResult[];
 }
 interface RangeResults {
     /**
-     * List of ranges returned in same order as requested
+     * Range results, returned in the same order as requested.
      * @maxSize 50
      */
     results?: RangeAggregationResult[];
 }
 interface AggregationResultsScalarResult {
-    /** Type of scalar aggregation */
+    /** Type of scalar aggregation. */
     type?: ScalarTypeWithLiterals;
-    /** Value of the scalar aggregation */
+    /** Value of the scalar aggregation. */
     value?: number;
 }
 interface ValueResult {
     /**
-     * Value of the field
+     * Value of the field.
      * @maxLength 1000
      */
     value?: string;
-    /** Count of entities with this value */
+    /** Count of entities with this value. */
     count?: number | null;
 }
 interface RangeResult {
-    /** Inclusive lower bound of the range */
+    /** Inclusive lower bound of the range. */
     from?: number | null;
-    /** Exclusive upper bound of the range */
+    /** Exclusive upper bound of the range. */
     to?: number | null;
-    /** Count of entities in this range */
+    /** Count of entities in this range. */
     count?: number | null;
 }
 interface ScalarResult {
-    /** Value of the scalar aggregation */
+    /** Value of the scalar aggregation. */
     value?: number;
 }
 interface NestedResultValue extends NestedResultValueResultOneOf {
-    /** Value aggregation result */
+    /** Value aggregation result. */
     value?: ValueResult;
-    /** Range aggregation result */
+    /** Range aggregation result. */
     range?: RangeResult;
-    /** Scalar aggregation result */
+    /** Scalar aggregation result. */
     scalar?: ScalarResult;
-    /** Date histogram aggregation result */
+    /** Date histogram aggregation result. */
     dateHistogram?: ValueResult;
 }
 /** @oneof */
 interface NestedResultValueResultOneOf {
-    /** Value aggregation result */
+    /** Value aggregation result. */
     value?: ValueResult;
-    /** Range aggregation result */
+    /** Range aggregation result. */
     range?: RangeResult;
-    /** Scalar aggregation result */
+    /** Scalar aggregation result. */
     scalar?: ScalarResult;
-    /** Date histogram aggregation result */
+    /** Date histogram aggregation result. */
     dateHistogram?: ValueResult;
 }
 interface Results {
-    /** List of nested aggregations */
+    /** Nested aggregation results, keyed by aggregation name. */
     results?: Record<string, NestedResultValue>;
 }
 interface DateHistogramResult {
     /**
-     * Date in ISO 8601 format
+     * Date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      * @maxLength 100
      */
     value?: string;
-    /** Count of documents in the bucket */
+    /** Count of documents in the bucket. */
     count?: number;
 }
 interface DateHistogramResults {
     /**
-     * List of date histogram aggregations
+     * Date histogram aggregation results.
      * @maxSize 200
      */
     results?: DateHistogramResult[];
 }
-/**
- * Results of `NESTED` aggregation type in a flattened form
- * aggregations in resulting array are keyed by requested aggregation `name`.
- */
+/** Results of the `NESTED` aggregation type in a flattened form. Entries in the resulting array are keyed by the requested aggregation's `name`. */
 interface NestedResults {
     /**
-     * List of nested aggregations
+     * Nested aggregation results.
      * @maxSize 1000
      */
     results?: Results[];
 }
 interface AggregationResults extends AggregationResultsResultOneOf {
-    /** Value aggregation results */
+    /** Value aggregation results. */
     values?: ValueResults;
-    /** Range aggregation results */
+    /** Range aggregation results. */
     ranges?: RangeResults;
-    /** Scalar aggregation results */
+    /** Scalar aggregation results. */
     scalar?: AggregationResultsScalarResult;
-    /** Date histogram aggregation results */
+    /** Date histogram aggregation results. */
     dateHistogram?: DateHistogramResults;
-    /** Nested aggregation results */
+    /** Nested aggregation results. */
     nested?: NestedResults;
     /**
-     * User-defined name of aggregation as derived from search request
+     * User-defined name of the aggregation, as provided in the search request.
      * @maxLength 100
      */
     name?: string;
-    /** Type of aggregation that must match provided kind as derived from search request */
+    /** Type of aggregation. Matches the `kind` provided in the search request. */
     type?: AggregationTypeWithLiterals;
     /**
-     * Field to aggregate by as derived from search request
+     * Field to aggregate by, as provided in the search request.
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface AggregationResultsResultOneOf {
-    /** Value aggregation results */
+    /** Value aggregation results. */
     values?: ValueResults;
-    /** Range aggregation results */
+    /** Range aggregation results. */
     ranges?: RangeResults;
-    /** Scalar aggregation results */
+    /** Scalar aggregation results. */
     scalar?: AggregationResultsScalarResult;
-    /** Date histogram aggregation results */
+    /** Date histogram aggregation results. */
     dateHistogram?: DateHistogramResults;
-    /** Nested aggregation results */
+    /** Nested aggregation results. */
     nested?: NestedResults;
 }
 interface CountContactsRequest {
@@ -1821,7 +1839,7 @@ interface CountContactsResponse {
 }
 interface GenerateContactImageUploadUrlRequest {
     /**
-     * ID of the contact whose picture is being updated.
+     * ID of the contact to generate an image upload URL for.
      * @format GUID
      */
     contactId: string;
@@ -1840,59 +1858,59 @@ interface GenerateContactImageUploadUrlResponse {
      */
     uploadUrl?: string;
     /**
-     * The upload id.
+     * Upload ID. Pass this ID to [Get Contact Image Upload Status](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/get-contact-image-upload-status) to check the status of the upload.
      * @format GUID
      */
     imageUploadId?: string;
 }
 interface AddContactAdditionalEmailRequest {
     /**
-     * ID of the Contact to add an email.
+     * ID of the contact to add an email to.
      * @format GUID
      */
     contactId: string;
-    /** The email to add. */
+    /** Email to add. */
     email: AdditionalEmail;
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 interface AddContactAdditionalEmailResponse {
-    /** Updated Contact. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface AddContactAdditionalPhoneRequest {
     /**
-     * ID of the Contact to add a phone.
+     * ID of the contact to add a phone to.
      * @format GUID
      */
     contactId: string;
-    /** The phone to add. */
+    /** Phone to add. */
     phone: AdditionalPhone;
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 interface AddContactAdditionalPhoneResponse {
-    /** Updated Contact. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface AddContactAddressRequest {
     /**
-     * ID of the Contact to add an address.
+     * ID of the contact to add an address to.
      * @format GUID
      */
     contactId: string;
-    /** The address to add. */
+    /** Address to add. */
     address: ContactAddress;
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 interface AddContactAddressResponse {
-    /** Updated Contact. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface DeleteContactAddressRequest {
     /**
-     * ID of the Contact from which to delete an address.
+     * ID of the contact to delete the address from.
      * @format GUID
      */
     contactId: string;
@@ -1901,48 +1919,48 @@ interface DeleteContactAddressRequest {
      * @format GUID
      */
     addressId: string;
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 interface DeleteContactAddressResponse {
-    /** Updated Contact after address deletion. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface UpdateContactAddressRequest {
     /**
-     * ID of the Contact to update address on.
+     * ID of the contact to update the address on.
      * @format GUID
      */
     contactId: string;
-    /** The updated address (must include address.id). */
+    /** Address to update. Must include `address.id`. */
     address: ContactAddress;
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 interface UpdateContactAddressResponse {
-    /** Updated Contact after address update. */
+    /** Updated contact. */
     contact?: Contact;
 }
 interface BulkCreateContactsRequest {
     /**
-     * List of Contacts to be created
+     * Contacts to create.
      * @minSize 1
      * @maxSize 100
      */
     contacts: Contact[];
     /** Whether to include the created contacts in the response. */
     returnEntity?: boolean;
-    /** Allows creating the contact even if a duplicate already exists. */
+    /** Whether to create the contact even if it duplicates an existing contact. */
     allowDuplicates?: boolean;
 }
 interface BulkCreateContactsResponse {
     /**
-     * List of the bulk create operation results including the Contacts and metadata.
+     * Results of the bulk create operation, including the created contacts and metadata.
      * @minSize 1
      * @maxSize 100
      */
     results?: BulkContactResult[];
-    /** Metadata regarding the bulk create operation */
+    /** Metadata regarding the bulk create operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface ItemMetadata {
@@ -1967,9 +1985,9 @@ interface ApplicationError {
     data?: Record<string, any> | null;
 }
 interface BulkContactResult {
-    /** Metadata regarding the specific single create operation */
+    /** Metadata regarding the creation of this specific contact. */
     itemMetadata?: ItemMetadata;
-    /** Only exists if `returnEntity` was set to true in the request */
+    /** Returned only when `returnEntity` is `true` in the request. */
     item?: Contact;
 }
 interface BulkActionMetadata {
@@ -1982,39 +2000,39 @@ interface BulkActionMetadata {
 }
 interface BulkUpdateContactsRequest {
     /**
-     * List of Contacts to be updated.
+     * Contacts to update.
      * @minSize 1
      * @maxSize 100
      */
     contacts: MaskedContact[];
     /** Whether to include the updated contacts in the response. */
     returnEntity?: boolean;
-    /** Allows updating the contact even if it becomes a duplicate of another contact. */
+    /** Whether to update the contact even if it becomes a duplicate of another contact. */
     allowDuplicates?: boolean;
 }
 interface MaskedContact {
-    /** Contact to be updated, may be partial */
+    /** Contact to update. May be partial. */
     contact?: Contact;
 }
 interface BulkUpdateContactsResponse {
     /**
-     * Results
+     * Results of the update for each contact.
      * @minSize 1
      * @maxSize 100
      */
     results?: BulkUpdateContactsResponseBulkContactResult[];
-    /** Metadata regarding the bulk update operation */
+    /** Metadata regarding the bulk update operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkUpdateContactsResponseBulkContactResult {
-    /** Metadata regarding the specific single update operation */
+    /** Metadata regarding the update of this specific contact. */
     itemMetadata?: ItemMetadata;
-    /** Only exists if `returnEntity` was set to true in the request */
+    /** Returned only when `returnEntity` is `true` in the request. */
     item?: Contact;
 }
 interface BulkUpdateContactTagsRequest {
     /**
-     * The contacts from which to add or remove tags.
+     * IDs of the contacts to add or remove tags on.
      * @minSize 1
      * @maxSize 100
      * @format GUID
@@ -2022,14 +2040,14 @@ interface BulkUpdateContactTagsRequest {
     contactIds: string[];
     /** Whether to include the updated contacts in the response. */
     returnEntity?: boolean;
-    /** The tags to add. */
+    /** Tags to assign. */
     assignTags?: PrivateTags;
-    /** The tags to remove. */
+    /** Tags to unassign. */
     unassignTags?: PrivateTags;
 }
 interface BulkUpdateContactTagsResponse {
     /**
-     * The results of the update for all contacts in the request.
+     * Results of the tag update for each contact.
      * @minSize 1
      * @maxSize 100
      */
@@ -2038,19 +2056,19 @@ interface BulkUpdateContactTagsResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkUpdateContactTagsResult {
-    /** Metadata regarding the specific single update operation */
+    /** Metadata regarding the tag update for this specific contact. */
     itemMetadata?: ItemMetadata;
-    /** Only exists if `returnEntity` was set to true in the request */
+    /** Returned only when `returnEntity` is `true` in the request. */
     item?: Contact;
 }
 interface BulkUpdateContactTagsByFilterRequest {
-    /** A filter object. See documentation [here](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language#filters) */
+    /** Filter object. See documentation [here](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language#filters). */
     filter: Record<string, any> | null;
     /** Free text to match in searchable fields. */
     search?: SearchDetails;
-    /** Tag ids to add to the contact. */
+    /** Tags to assign to the matching contacts. */
     assignTags?: PrivateTags;
-    /** Tag ids to remove from the contact. */
+    /** Tags to unassign from the matching contacts. */
     unassignTags?: PrivateTags;
 }
 interface BulkUpdateContactTagsByFilterResponse {
@@ -2062,30 +2080,30 @@ interface BulkUpdateContactTagsByFilterResponse {
 }
 interface BulkUpsertContactsRequest {
     /**
-     * List of Contacts to be updated.
+     * Contacts to create or update.
      * @minSize 1
      * @maxSize 100
      */
     contacts: BulkUpsertContactsRequestMaskedContact[];
     /** Whether to include the upserted contacts in the response. */
     returnEntity?: boolean;
-    /** The mode in which the upsert should work in. */
+    /** Mode that determines how an existing contact is updated when a match is found. See the endpoint description for the supported modes. */
     upsertMode?: UpsertModeWithLiterals;
-    /** Indicates whether to update a contact even if it is a site member. */
+    /** Whether to update a contact even if it's a site member. */
     updateMember?: boolean | null;
 }
 interface BulkUpsertContactsRequestMaskedContact {
-    /** Contact to be updated, may be partial */
+    /** Contact to create or update. May be partial. */
     contact?: Contact;
 }
 interface BulkUpsertContactsResponse {
     /**
-     * Results
+     * Results of the upsert for each contact.
      * @minSize 1
      * @maxSize 100
      */
     results?: BulkUpsertContactsResponseBulkContactResult[];
-    /** Metadata regarding the bulk update operation */
+    /** Metadata regarding the bulk upsert operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 declare enum Action {
@@ -2096,39 +2114,40 @@ declare enum Action {
 /** @enumType */
 type ActionWithLiterals = Action | 'UNKNOWN_ACTION' | 'UPDATED' | 'CREATED';
 interface BulkUpsertContactsResponseBulkContactResult {
-    /** Metadata regarding the specific single update operation */
+    /** Metadata regarding the upsert of this specific contact. */
     itemMetadata?: ItemMetadata;
-    /** Only exists if `returnEntity` was set to true in the request */
+    /** Returned only when `returnEntity` is `true` in the request. */
     item?: Contact;
     /** The action performed on the contact. */
     action?: ActionWithLiterals;
 }
 interface BulkDeleteContactsRequest {
     /**
-     * Contact ids to be deleted
+     * IDs of the contacts to delete.
      * @minSize 1
      * @maxSize 100
      * @format GUID
      */
     contactIds: string[];
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the associated site member for any contact that's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMembers?: boolean | null;
 }
 interface BulkDeleteContactsResponse {
     /**
-     * Results
+     * Results of the delete operation for each contact.
      * @minSize 1
      * @maxSize 100
      */
     results?: BulkDeleteContactsResponseBulkContactResult[];
-    /** Metadata regarding the bulk delete operation */
+    /** Metadata regarding the bulk delete operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkDeleteContactsResponseBulkContactResult {
-    /** Metadata regarding the specific single delete operation */
+    /** Metadata regarding the deletion of this specific contact. */
     itemMetadata?: ItemMetadata;
 }
 interface BulkDeleteContactsByFilterRequest {
@@ -2139,11 +2158,12 @@ interface BulkDeleteContactsByFilterRequest {
      * `{ "filter": { "name.last": "Smith" } }`
      */
     filter: Record<string, any> | null;
-    /** Free text to match in searchable fields */
+    /** Free text to match in searchable fields. */
     search?: SearchDetails;
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the associated site member for any contact that's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMembers?: boolean | null;
 }
@@ -2156,7 +2176,7 @@ interface BulkDeleteContactsByFilterResponse {
 }
 interface RemoveContactFromTrashBinRequest {
     /**
-     * Id of the Contact to remove from trashbin.
+     * ID of the contact to permanently delete from the trash bin.
      * @format GUID
      */
     contactId: string;
@@ -2165,18 +2185,18 @@ interface RemoveContactFromTrashBinResponse {
 }
 interface RestoreContactFromTrashBinRequest {
     /**
-     * Id of the Contact to restore from trashbin.
+     * ID of the contact to restore from the trash bin.
      * @format GUID
      */
     contactId: string;
 }
 interface RestoreContactFromTrashBinResponse {
-    /** The restored Contact. */
+    /** Restored contact. */
     contact?: Contact;
 }
 interface BulkRestoreContactsFromTrashBinRequest {
     /**
-     * List of Contacts to be restored
+     * IDs of the contacts to restore from the trash bin.
      * @minSize 1
      * @maxSize 100
      * @format GUID
@@ -2187,34 +2207,34 @@ interface BulkRestoreContactsFromTrashBinRequest {
 }
 interface BulkRestoreContactsFromTrashBinResponse {
     /**
-     * Results
+     * Results of the restore operation for each contact.
      * @minSize 1
      * @maxSize 100
      */
     results?: BulkRestoreContactsFromTrashBinResponseBulkContactResult[];
-    /** Metadata regarding the bulk delete operation */
+    /** Metadata regarding the bulk restore operation. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkRestoreContactsFromTrashBinResponseBulkContactResult {
-    /** Metadata regarding the specific single restore operation */
+    /** Metadata regarding the restoration of this specific contact. */
     itemMetadata?: ItemMetadata;
-    /** Only exists if returnEntity was set to true in the request */
+    /** Returned only when `returnEntity` is `true` in the request. */
     item?: Contact;
 }
 interface GetDeletedContactRequest {
     /**
-     * Id of the Contact to retrieve from trashbin.
+     * ID of the contact to retrieve from the trash bin.
      * @format GUID
      */
     contactId: string;
 }
 interface GetDeletedContactResponse {
-    /** The requested Contact. */
+    /** Retrieved contact. */
     contact?: Contact;
 }
 interface ListDeletedContactsRequest {
     /**
-     * External ID
+     * External ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -2236,53 +2256,53 @@ interface ListDeletedContactsRequest {
      * @format GUID
      */
     contactIds?: string[];
-    /** From date and time that contact was deleted. */
+    /** Filters to contacts deleted on or after this date and time. */
     deletedFromDate?: Date | null;
-    /** Until date and time that contact was deleted. */
+    /** Filters to contacts deleted on or before this date and time. */
     deletedToDate?: Date | null;
     /** Cursor paging. */
     paging?: CursorPaging;
 }
 interface ListDeletedContactsResponse {
-    /** List of Contacts. */
+    /** Retrieved contacts. */
     contacts?: Contact[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface BulkAddSegmentToContactsRequest {
     /**
-     * Segment id
+     * Segment ID.
      * @format GUID
      */
     segmentId?: string;
     /**
-     * List of Contact ids
+     * IDs of the contacts to add the segment to.
      * @format GUID
      * @minSize 1
      * @maxSize 100
      */
     contactIds?: string[];
     /**
-     * List of existing segment ids. It is used to remove segments that no longer exist that are still on the contact.
+     * IDs of segments on the contact that no longer exist, used to remove them from the contact.
      * @format GUID
      * @maxSize 100
      */
     existingSegmentIds?: string[];
 }
 interface BulkAddSegmentToContactsResponse {
-    /** List of action results */
+    /** Results of the action for each contact. */
     results?: ItemMetadata[];
-    /** Metadata on the bulk action */
+    /** Metadata regarding the bulk action. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkRemoveSegmentFromContactsRequest {
     /**
-     * Segment id
+     * Segment ID.
      * @format GUID
      */
     segmentId?: string;
     /**
-     * List of Contact ids
+     * IDs of the contacts to remove the segment from.
      * @format GUID
      * @minSize 1
      * @maxSize 100
@@ -2290,9 +2310,9 @@ interface BulkRemoveSegmentFromContactsRequest {
     contactIds?: string[];
 }
 interface BulkRemoveSegmentFromContactsResponse {
-    /** List of action results */
+    /** Results of the action for each contact. */
     results?: ItemMetadata[];
-    /** Metadata on the bulk action */
+    /** Metadata regarding the bulk action. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface QueryContactsByOffsetInternalRequest {
@@ -2345,13 +2365,13 @@ interface QueryV2 extends QueryV2PagingMethodOneOf {
      */
     sort?: Sorting[];
     /**
-     * Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned.
+     * Projected fields to return. If `fieldsets` is also specified, the union of `fieldsets` and `fields` is returned.
      * @maxSize 1000
      * @maxLength 100
      */
     fields?: string[];
     /**
-     * Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned.
+     * Predefined, named sets of projected fields to return. Specifying multiple `fieldsets` returns the union of fields from all sets. If `fields` is also specified, the union of `fieldsets` and `fields` is returned.
      * @maxSize 100
      * @maxLength 100
      */
@@ -2381,9 +2401,9 @@ declare enum QueryContactsByOffsetInternalRequestNameFormat {
 /** @enumType */
 type QueryContactsByOffsetInternalRequestNameFormatWithLiterals = QueryContactsByOffsetInternalRequestNameFormat | 'BY_FIRST_NAME' | 'BY_LAST_NAME';
 interface QueryContactsByOffsetInternalResponse {
-    /** List of Contacts. */
+    /** Retrieved contacts. */
     contacts?: Contact[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: PagingMetadataV2;
 }
 interface PagingMetadataV2 {
@@ -2393,20 +2413,19 @@ interface PagingMetadataV2 {
     offset?: number | null;
     /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
     total?: number | null;
-    /** Flag that indicates the server failed to calculate the `total` field. */
+    /** Whether the server failed to calculate the `total` field. */
     tooManyToCount?: boolean | null;
     /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
     cursors?: Cursors;
 }
 interface GetContactImageUploadStatusRequest {
     /**
-     * Id of the contact for which to retrieve the image upload status.
+     * ID of the contact whose image upload status to retrieve.
      * @format GUID
      */
     contactId: string;
     /**
-     * The upload ID of the image upload process. Returned in case an image URL was provided when creating or
-     * updating a contact. It is also returned from the GenerateContactImageUploadUrl endpoint.
+     * The upload ID of the image upload process. Returned when an image URL is provided while creating or updating a contact, or from [Generate Contact Image Upload Url](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/generate-contact-image-upload-url).
      * @maxLength 100
      */
     imageUploadId: string;
@@ -2437,7 +2456,8 @@ interface BulkUpdatePhoneCountryCodeByFilterRequest {
     search?: SearchDetails;
     /**
      * [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code to apply.
-     * The country code will be added to the contacts main phone number, when adding it the phone, makes it a valid phone number.
+     *
+     * Applied only to contacts whose phone number isn't already in [ITU E.164 international](https://www.itu.int/rec/T-REC-E.164/) format. If the phone number still can't be converted to E.164 format after applying the country code, that contact fails with `PHONE_CANNOT_BE_FIXED_WITH_COUNTRY_CODE`.
      * @format COUNTRY
      */
     countryCode: string;
@@ -2852,13 +2872,13 @@ interface BulkUpdateContactSubscriptionsOptions {
  * Image upload: When you provide an image URL, the image is uploaded asynchronously and an `imageUploadId` is returned for tracking upload progress. Call [Get Contact Image Upload Status](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/get-contact-image-upload-status) to monitor the upload.
  *
  * To create multiple contacts in a single request, call [Bulk Create Contacts](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts/contact-v5/bulk-create-contacts).
- * @param contact - Contact to be created.
+ * @param contact - Contact to create.
  * @public
  * @documentationMaturity preview
  * @requiredField contact
  * @permissionId CONTACTS.CONTACT_CREATE
  * @applicableIdentity APP
- * @returns The created Contact.
+ * @returns Created contact.
  * @fqn wix.contacts.v5.Contacts.CreateContact
  */
 declare function createContact(contact: Contact, options?: CreateContactOptions): Promise<NonNullablePaths<Contact, `email.email` | `email.subscriptionStatus.status` | `email.deliverabilityStatus` | `additionalEmails` | `additionalEmails.${number}.email` | `phone.tag` | `phone.phone` | `phone.deliverabilityStatus` | `additionalPhones` | `additionalPhones.${number}.tag` | `additionalPhones.${number}.phone` | `addresses` | `addresses.${number}.tag` | `addresses.${number}.address.streetAddress.number` | `addresses.${number}.address.streetAddress.name` | `addresses.${number}.address.streetAddress.apt` | `locationIds` | `segmentIds` | `memberInfo.status` | `memberInfo.profileInfo.privacyStatus` | `memberInfo.userInfo.userId` | `memberInfo.userInfo.role` | `memberInfo.sessionInfo.mobileAppNames` | `memberInfo.groupInfo.groupIds` | `tags.privateTags.tagIds`, 6> & {
@@ -2866,20 +2886,20 @@ declare function createContact(contact: Contact, options?: CreateContactOptions)
 }>;
 interface CreateContactOptions {
     /**
-     * Allows creating a duplicate contact.
+     * Whether to create the contact even if it duplicates an existing contact.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
 }
 /**
  * Retrieves a single contact by ID.
- * @param contactId - ID of the Contact to retrieve.
+ * @param contactId - ID of the contact to retrieve.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
  * @permissionId CONTACTS.CONTACT_READ
  * @applicableIdentity APP
- * @returns The requested Contact.
+ * @returns Retrieved contact.
  * @fqn wix.contacts.v5.Contacts.GetContact
  */
 declare function getContact(contactId: string): Promise<NonNullablePaths<Contact, `email.email` | `email.subscriptionStatus.status` | `email.deliverabilityStatus` | `additionalEmails` | `additionalEmails.${number}.email` | `phone.tag` | `phone.phone` | `phone.deliverabilityStatus` | `additionalPhones` | `additionalPhones.${number}.tag` | `additionalPhones.${number}.phone` | `addresses` | `addresses.${number}.tag` | `addresses.${number}.address.streetAddress.number` | `addresses.${number}.address.streetAddress.name` | `addresses.${number}.address.streetAddress.apt` | `locationIds` | `segmentIds` | `memberInfo.status` | `memberInfo.profileInfo.privacyStatus` | `memberInfo.userInfo.userId` | `memberInfo.userInfo.role` | `memberInfo.sessionInfo.mobileAppNames` | `memberInfo.groupInfo.groupIds` | `tags.privateTags.tagIds`, 6>>;
@@ -2905,7 +2925,7 @@ declare function getContact(contactId: string): Promise<NonNullablePaths<Contact
  * @permissionId CONTACTS.CONTACT_UPDATE
  * @permissionId CONTACTS.CONTACT_MEMBER_EMAIL_UPDATE
  * @applicableIdentity APP
- * @returns Updated Contact.
+ * @returns Updated contact.
  * @fqn wix.contacts.v5.Contacts.UpdateContact
  */
 declare function updateContact(_id: string, contact: NonNullablePaths<UpdateContact, `revision`, 2>, options?: UpdateContactOptions): Promise<NonNullablePaths<Contact, `email.email` | `email.subscriptionStatus.status` | `email.deliverabilityStatus` | `additionalEmails` | `additionalEmails.${number}.email` | `phone.tag` | `phone.phone` | `phone.deliverabilityStatus` | `additionalPhones` | `additionalPhones.${number}.tag` | `additionalPhones.${number}.phone` | `addresses` | `addresses.${number}.tag` | `addresses.${number}.address.streetAddress.number` | `addresses.${number}.address.streetAddress.name` | `addresses.${number}.address.streetAddress.apt` | `locationIds` | `segmentIds` | `memberInfo.status` | `memberInfo.profileInfo.privacyStatus` | `memberInfo.userInfo.userId` | `memberInfo.userInfo.role` | `memberInfo.sessionInfo.mobileAppNames` | `memberInfo.groupInfo.groupIds` | `tags.privateTags.tagIds`, 6> & {
@@ -2929,19 +2949,19 @@ interface UpdateContact {
      */
     revision?: string | null;
     /**
-     * Date and time the Contact was created.
+     * Date and time the contact was created.
      * @readonly
      * @immutable
      */
     _createdDate?: Date | null;
     /**
-     * Date and time the Contact was last updated.
+     * Date and time the contact was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Contact External ID. Used to identify contacts from external systems.
-     * This field can only be set once and cannot be updated after creation.
+     * Contact external ID. Used to identify contacts from external systems.
+     * This field can only be set once and can't be updated after creation.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -3031,7 +3051,7 @@ interface UpdateContact {
      */
     lastActivity?: ContactActivity;
     /**
-     * List of Contact segment IDs that this contact belongs to.
+     * IDs of the segments the contact belongs to.
      * Segments are used for organizing and targeting groups of contacts.
      * @maxSize 60
      * @readonly
@@ -3057,7 +3077,7 @@ interface UpdateContact {
 }
 interface UpdateContactOptions {
     /**
-     * Allows updating the contact even if it becomes a duplicate of another contact.
+     * Whether to update the contact even if it becomes a duplicate of another contact.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
@@ -3079,7 +3099,7 @@ interface UpdateContactOptions {
  * Image upload: When you provide an image URL, the image is uploaded asynchronously and an `imageUploadId` is returned for tracking upload progress. Call [Get Contact Image Upload Status](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/get-contact-image-upload-status) to monitor the upload.
  *
  * To create or update multiple contacts in a single request, call [Bulk Upsert Contacts](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/bulk-upsert-contacts).
- * @param contact - Contact to be upserted.
+ * @param contact - Contact to upsert.
  * @public
  * @documentationMaturity preview
  * @requiredField contact
@@ -3092,9 +3112,9 @@ declare function upsertContact(contact: Contact, options?: UpsertContactOptions)
     __applicationErrorsType?: UpsertContactApplicationErrors;
 }>;
 interface UpsertContactOptions {
-    /** The mode in which the upsert should work in. */
+    /** Mode that determines how an existing contact is updated when a match is found. See the endpoint description for the supported modes. */
     upsertMode?: UpsertModeWithLiterals;
-    /** Indicates whether to update the contact even if it is a site member. */
+    /** Whether to update the contact even if it's a site member. */
     updateMember?: boolean | null;
 }
 /**
@@ -3103,7 +3123,7 @@ interface UpsertContactOptions {
  * Specify which tags to assign and which to unassign. A tag that appears in both the list to assign and the list to unassign is assigned. At least one tag must be specified to assign or unassign.
  *
  * To update tags on multiple contacts, call [Bulk Update Contact Tags](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/bulk-update-contact-tags).
- * @param contactId - The contact from which to add or remove tags.
+ * @param contactId - ID of the contact whose tags to update.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -3115,9 +3135,9 @@ declare function updateContactTags(contactId: string, options?: UpdateContactTag
     __applicationErrorsType?: UpdateContactTagsApplicationErrors;
 }>;
 interface UpdateContactTagsOptions {
-    /** The tags to add. */
+    /** Tags to assign. */
     assignTags?: PrivateTags;
-    /** The tags to remove. */
+    /** Tags to unassign. */
     unassignTags?: PrivateTags;
 }
 /**
@@ -3139,7 +3159,8 @@ interface UpdateContactTagsOptions {
  * - `externalId` can be set only once and can't be changed if it already has a value.
  * - The target contact must remain valid after the merge, keeping at least one of `name`, `email`, or `phone`.
  * @param targetContactId - Target contact ID.
- * @param targetContactRevision - Target contact revision number, which increments by 1 each time the contact is updated to prevent conflicting changes.
+ * @param targetContactRevision - Revision number of the target contact, which increments by 1 each time the contact is updated.
+ * The current revision must be passed to prevent conflicting changes.
  * @public
  * @documentationMaturity preview
  * @requiredField targetContactId
@@ -3152,7 +3173,7 @@ declare function mergeContacts(targetContactId: string, targetContactRevision: s
     __applicationErrorsType?: MergeContactsApplicationErrors;
 }>;
 interface MergeContactsOptions {
-    /** When the target contact is provided, the merged result will be overwritten. */
+    /** Contact to overwrite the target with, instead of merging in the source contacts' data. See the endpoint description for details. */
     targetContact?: Contact;
     /**
      * IDs of up to 5 contacts to merge into the target contact.
@@ -3163,11 +3184,14 @@ interface MergeContactsOptions {
      * @format GUID
      */
     sourceContactIds?: string[];
-    /** Indicates whether to only return a preview of the merged contact or perform the actual merge. */
+    /**
+     * Whether to return a preview of the merged contact instead of performing the actual merge.
+     *
+     * Default: `false`
+     */
     preview?: boolean | null;
     /**
-     * Allows updating the target contact even if it becomes a duplicate of another contact.
-     * This can happen only where the target contact is provided.
+     * Whether to update the target contact even if it becomes a duplicate of another contact. Relevant only when `targetContact` is provided.
      * More about duplicate contacts can be found [here](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/matching-contacts).
      */
     allowDuplicates?: boolean;
@@ -3184,7 +3208,7 @@ interface MergeContactsOptions {
  * - A site owner or contributor can't be deleted.
  *
  * To delete multiple contacts in a single request, call [Bulk Delete Contacts](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/bulk-delete-contacts).
- * @param contactId - Id of the Contact to delete.
+ * @param contactId - ID of the contact to delete.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -3198,8 +3222,9 @@ declare function deleteContact(contactId: string, options?: DeleteContactOptions
 }>;
 interface DeleteContactOptions {
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the contact even if it's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMember?: boolean | null;
 }
@@ -3222,7 +3247,7 @@ declare function findMatchingContacts(options?: FindMatchingContactsOptions): Pr
 }>;
 interface FindMatchingContactsOptions {
     /**
-     * Contact External ID.
+     * Contact external ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -3621,41 +3646,41 @@ type ContactSearch = {
         order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
     }[];
     /**
-    Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+    Aggregations, also known as faceted search. Lets you explore large amounts of data by displaying summaries about different partitions of the data, and narrow the navigation to a specific partition.
     @maxSize: 10
     */
     aggregations?: {
         /**
-      Value aggregation
+      Value aggregation.
       */
         value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
         /**
-      Range aggregation
+      Range aggregation.
       */
         range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
         /**
-      Scalar aggregation
+      Scalar aggregation.
       */
         scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
         /**
-      Date histogram aggregation
+      Date histogram aggregation.
       */
         dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
         /**
-      Nested aggregation
+      Nested aggregation.
       */
         nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
         /**
-      User-defined name of aggregation, should be unique, will appear in aggregation results
+      User-defined name for the aggregation. Must be unique. Appears in the aggregation results.
       @maxLength: 100
       */
         name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
         /**
-      Type of aggregation, client must provide matching aggregation field below
+      Type of aggregation. Must match the aggregation type provided in the `kind` field.
       */
         type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
         /**
-      Field to aggregate by, use dot notation to specify json path
+      Field to aggregate by. Use dot notation to specify the JSON path.
       @maxLength: 200
       */
         fieldPath?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['fieldPath'];
@@ -3665,33 +3690,33 @@ type ContactSearch = {
     */
     search?: {
         /**
-      Defines how separate search terms in `expression` are combined
+      How separate search terms in `expression` are combined.
       */
         mode?: NonNullable<CommonSearchWithEntityContext['search']>['mode'];
         /**
-      Search term or expression
+      Search term or expression.
       @maxLength: 100
       */
         expression?: NonNullable<CommonSearchWithEntityContext['search']>['expression'] | null;
         /**
-      Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
+      Fields to search in. If empty, searches all searchable fields. Use dot notation to specify the JSON path.
       @maxLength: 200,
       @maxSize: 20
       */
         fields?: NonNullable<CommonSearchWithEntityContext['search']>['fields'];
         /**
-      Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm)
+      Whether to use fuzzy search, which allows typos using a managed proximity algorithm.
       */
         fuzzy?: NonNullable<CommonSearchWithEntityContext['search']>['fuzzy'];
     };
     /**
     UTC offset or IANA time zone. Valid values are
     ISO 8601 UTC offsets, such as +02:00 or -06:00,
-    and IANA time zone IDs, such as Europe/Rome
+    and IANA time zone IDs, such as Europe/Rome.
   
-    Affects all filters and aggregations returned values.
-    You may override this behavior in a specific filter by providing
-    timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+    Affects the values returned by all filters and aggregations.
+    You can override this behavior in a specific filter by providing
+    timestamps that include a time zone. For example, `"2023-12-20T10:52:34.795Z"`.
     @maxLength: 50
     */
     timeZone?: CommonSearchWithEntityContext['timeZone'] | null;
@@ -3737,7 +3762,7 @@ interface CountContactsOptions {
  * see the [Upload API](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/upload-api) article.
  *
  * You can call [Get Contact Image Upload Status](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/get-contact-image-upload-status) to query the status of the image upload.
- * @param contactId - ID of the contact whose picture is being updated.
+ * @param contactId - ID of the contact to generate an image upload URL for.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -3763,8 +3788,8 @@ interface GenerateContactImageUploadUrlOptions {
  * The contact must have a main email (`email.email`) before an additional email can be added.
  *
  * Each time the contact is updated, `revision` increments by 1. The current `revision` must be passed. This ensures you're working with the latest contact and prevents unintended overwrites.
- * @param contactId - ID of the Contact to add an email.
- * @param email - The email to add.
+ * @param contactId - ID of the contact to add an email to.
+ * @param email - Email to add.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -3779,7 +3804,7 @@ declare function addContactAdditionalEmail(contactId: string, email: AdditionalE
     __applicationErrorsType?: AddContactAdditionalEmailApplicationErrors;
 }>;
 interface AddContactAdditionalEmailOptions {
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 /**
@@ -3788,8 +3813,8 @@ interface AddContactAdditionalEmailOptions {
  * The contact must have a main phone (`phone.phone`) before an additional phone can be added. If the contact already has the same phone number with the same tag, the request is ignored.
  *
  * Each time the contact is updated, `revision` increments by 1. The current `revision` must be passed. This ensures you're working with the latest contact and prevents unintended overwrites.
- * @param contactId - ID of the Contact to add a phone.
- * @param phone - The phone to add.
+ * @param contactId - ID of the contact to add a phone to.
+ * @param phone - Phone to add.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -3804,7 +3829,7 @@ declare function addContactAdditionalPhone(contactId: string, phone: AdditionalP
     __applicationErrorsType?: AddContactAdditionalPhoneApplicationErrors;
 }>;
 interface AddContactAdditionalPhoneOptions {
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 /**
@@ -3813,8 +3838,8 @@ interface AddContactAdditionalPhoneOptions {
  * The address is appended to the contact's list of addresses. If the contact already has the same address with the same tag, the request is ignored.
  *
  * Each time the contact is updated, `revision` increments by 1. The current `revision` must be passed. This ensures you're working with the latest contact and prevents unintended overwrites.
- * @param contactId - ID of the Contact to add an address.
- * @param address - The address to add.
+ * @param contactId - ID of the contact to add an address to.
+ * @param address - Address to add.
  * @public
  * @documentationMaturity preview
  * @requiredField address
@@ -3829,14 +3854,14 @@ declare function addContactAddress(contactId: string, address: ContactAddress, o
     __applicationErrorsType?: AddContactAddressApplicationErrors;
 }>;
 interface AddContactAddressOptions {
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 /**
  * Deletes an address from a contact by address ID.
  *
  * Each time the contact is updated, `revision` increments by 1. The current `revision` must be passed. This ensures you're working with the latest contact and prevents unintended overwrites.
- * @param revision - Contact revision number for optimistic concurrency control.
+ * @param revision - Contact revision number.
  * @public
  * @documentationMaturity preview
  * @requiredField identifiers
@@ -3852,7 +3877,7 @@ declare function deleteContactAddress(identifiers: NonNullablePaths<DeleteContac
 }>;
 interface DeleteContactAddressIdentifiers {
     /**
-     * ID of the Contact from which to delete an address.
+     * ID of the contact to delete the address from.
      * @format GUID
      */
     contactId: string;
@@ -3866,7 +3891,7 @@ interface DeleteContactAddressIdentifiers {
  * Updates an address on a contact.
  *
  * Each time the contact is updated, `revision` increments by 1. The current `revision` must be passed. This ensures you're working with the latest contact and prevents unintended overwrites.
- * @param address - The updated address (must include address.id).
+ * @param address - Address to update. Must include `address.id`.
  * @public
  * @documentationMaturity preview
  * @requiredField address
@@ -3883,13 +3908,13 @@ declare function updateContactAddress(identifiers: NonNullablePaths<UpdateContac
 }>;
 interface UpdateContactAddressIdentifiers {
     /**
-     * ID of the Contact to update address on.
+     * ID of the contact to update the address on.
      * @format GUID
      */
     contactId: string;
 }
 interface UpdateContactAddressOptions {
-    /** Contact revision number for optimistic concurrency control. */
+    /** Contact revision number. */
     revision: string | null;
 }
 /**
@@ -3898,7 +3923,7 @@ interface UpdateContactAddressOptions {
  * When you provide an image URL for a contact, the image is uploaded in the background and the returned contact temporarily has no image. Once the upload succeeds, the contact's image is updated.
  *
  * To create a single contact, call [Create Contact](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/create-contact).
- * @param contacts - List of Contacts to be created
+ * @param contacts - Contacts to create.
  * @public
  * @documentationMaturity preview
  * @requiredField contacts
@@ -3910,7 +3935,7 @@ declare function bulkCreateContacts(contacts: Contact[], options?: BulkCreateCon
 interface BulkCreateContactsOptions {
     /** Whether to include the created contacts in the response. */
     returnEntity?: boolean;
-    /** Allows creating the contact even if a duplicate already exists. */
+    /** Whether to create the contact even if it duplicates an existing contact. */
     allowDuplicates?: boolean;
 }
 /**
@@ -3921,7 +3946,7 @@ interface BulkCreateContactsOptions {
  * `externalId` can be set only once. If it already has a value, it can't be updated.
  *
  * To update a single contact, call [Update Contact](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/update-contact).
- * @param contacts - List of Contacts to be updated.
+ * @param contacts - Contacts to update.
  * @public
  * @documentationMaturity preview
  * @requiredField contacts
@@ -3935,7 +3960,7 @@ declare function bulkUpdateContacts(contacts: NonNullablePaths<MaskedContact, `c
 interface BulkUpdateContactsOptions {
     /** Whether to include the updated contacts in the response. */
     returnEntity?: boolean;
-    /** Allows updating the contact even if it becomes a duplicate of another contact. */
+    /** Whether to update the contact even if it becomes a duplicate of another contact. */
     allowDuplicates?: boolean;
 }
 /**
@@ -3944,7 +3969,7 @@ interface BulkUpdateContactsOptions {
  * Specify which tags to assign and which to unassign. A tag that appears in both the list to assign and the list to unassign is assigned. At least one tag must be specified to assign or unassign.
  *
  * To update tags for a single contact, call [Update Contact Tags](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/update-contact-tags).
- * @param contactIds - The contacts from which to add or remove tags.
+ * @param contactIds - IDs of the contacts to add or remove tags on.
  * @public
  * @documentationMaturity preview
  * @requiredField contactIds
@@ -3958,9 +3983,9 @@ declare function bulkUpdateContactTags(contactIds: string[], options?: BulkUpdat
 interface BulkUpdateContactTagsOptions {
     /** Whether to include the updated contacts in the response. */
     returnEntity?: boolean;
-    /** The tags to add. */
+    /** Tags to assign. */
     assignTags?: PrivateTags;
-    /** The tags to remove. */
+    /** Tags to unassign. */
     unassignTags?: PrivateTags;
 }
 /**
@@ -3971,7 +3996,7 @@ interface BulkUpdateContactTagsOptions {
  * To check the status of the bulk update, pass the returned `jobId` to [Get Async Job](https://dev.wix.com/docs/api-reference/business-management/async-job/get-async-job).
  *
  * To update tags for a single contact, call [Update Contact Tags](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/update-contact-tags).
- * @param filter - A filter object. See documentation [here](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language#filters)
+ * @param filter - Filter object. See documentation [here](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language#filters).
  * @public
  * @documentationMaturity preview
  * @requiredField filter
@@ -3985,9 +4010,9 @@ declare function bulkUpdateContactTagsByFilter(filter: Record<string, any>, opti
 interface BulkUpdateContactTagsByFilterOptions {
     /** Free text to match in searchable fields. */
     search?: SearchDetails;
-    /** Tag ids to add to the contact. */
+    /** Tags to assign to the matching contacts. */
     assignTags?: PrivateTags;
-    /** Tag ids to remove from the contact. */
+    /** Tags to unassign from the matching contacts. */
     unassignTags?: PrivateTags;
 }
 /**
@@ -4005,7 +4030,7 @@ interface BulkUpdateContactTagsByFilterOptions {
  * When you provide an image URL and the upsert mode allows the image to be updated, the image is uploaded in the background. The returned contact temporarily has no image if it was created, or its previous image if it was updated. Once the upload succeeds, the contact's image is updated.
  *
  * To create or update a single contact, call [Upsert Contact](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/upsert-contact).
- * @param contacts - List of Contacts to be updated.
+ * @param contacts - Contacts to create or update.
  * @public
  * @documentationMaturity preview
  * @requiredField contacts
@@ -4018,9 +4043,9 @@ declare function bulkUpsertContacts(contacts: BulkUpsertContactsRequestMaskedCon
 interface BulkUpsertContactsOptions {
     /** Whether to include the upserted contacts in the response. */
     returnEntity?: boolean;
-    /** The mode in which the upsert should work in. */
+    /** Mode that determines how an existing contact is updated when a match is found. See the endpoint description for the supported modes. */
     upsertMode?: UpsertModeWithLiterals;
-    /** Indicates whether to update a contact even if it is a site member. */
+    /** Whether to update a contact even if it's a site member. */
     updateMember?: boolean | null;
 }
 /**
@@ -4029,7 +4054,7 @@ interface BulkUpsertContactsOptions {
  * Deleted contacts are moved to the trash bin and can be restored within 90 days by calling [Restore Contact From Trash Bin](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/restore-contact-from-trash-bin) or [Bulk Restore Contacts From Trash Bin](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/bulk-restore-contacts-from-trash-bin).
  *
  * To delete a single contact, call [Delete Contact](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/delete-contact).
- * @param contactIds - Contact ids to be deleted
+ * @param contactIds - IDs of the contacts to delete.
  * @public
  * @documentationMaturity preview
  * @requiredField contactIds
@@ -4043,8 +4068,9 @@ declare function bulkDeleteContacts(contactIds: string[], options?: BulkDeleteCo
 }>;
 interface BulkDeleteContactsOptions {
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the associated site member for any contact that's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMembers?: boolean | null;
 }
@@ -4079,11 +4105,12 @@ declare function bulkDeleteContactsByFilter(filter: Record<string, any>, options
     __applicationErrorsType?: BulkDeleteContactsByFilterApplicationErrors;
 }>;
 interface BulkDeleteContactsByFilterOptions {
-    /** Free text to match in searchable fields */
+    /** Free text to match in searchable fields. */
     search?: SearchDetails;
     /**
-     * Indicates whether to delete the contact that is a site member. If set to `true`, the contact is deleted even
-     * if it is a site member and the site member is also deleted. Default: `false`
+     * Whether to delete the associated site member for any contact that's a site member. If `true`, the site member is also deleted.
+     *
+     * Default: `false`
      */
     deleteMembers?: boolean | null;
 }
@@ -4091,7 +4118,7 @@ interface BulkDeleteContactsByFilterOptions {
  * Permanently deletes a contact from the trash bin.
  *
  * After removal, the contact can no longer be restored.
- * @param contactId - Id of the Contact to remove from trashbin.
+ * @param contactId - ID of the contact to permanently delete from the trash bin.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -4104,7 +4131,7 @@ declare function removeContactFromTrashBin(contactId: string): Promise<void>;
  * Restores a soft-deleted contact from the trash bin.
  *
  * To restore multiple contacts in a single request, call [Bulk Restore Contacts From Trash Bin](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/bulk-restore-contacts-from-trash-bin).
- * @param contactId - Id of the Contact to restore from trashbin.
+ * @param contactId - ID of the contact to restore from the trash bin.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -4126,7 +4153,7 @@ declare function restoreContactFromTrashBin(contactId: string): Promise<NonNulla
 declare function bulkRestoreContactsFromTrashBin(options?: BulkRestoreContactsFromTrashBinOptions): Promise<NonNullablePaths<BulkRestoreContactsFromTrashBinResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.email.email` | `results.${number}.item.email.deliverabilityStatus` | `results.${number}.item.phone.tag` | `results.${number}.item.phone.phone` | `results.${number}.item.phone.deliverabilityStatus` | `results.${number}.item.memberInfo.status` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
 interface BulkRestoreContactsFromTrashBinOptions {
     /**
-     * List of Contacts to be restored
+     * IDs of the contacts to restore from the trash bin.
      * @minSize 1
      * @maxSize 100
      * @format GUID
@@ -4137,7 +4164,7 @@ interface BulkRestoreContactsFromTrashBinOptions {
 }
 /**
  * Retrieves a soft-deleted contact from the trash bin by ID.
- * @param contactId - Id of the Contact to retrieve from trashbin.
+ * @param contactId - ID of the contact to retrieve from the trash bin.
  * @public
  * @documentationMaturity preview
  * @requiredField contactId
@@ -4157,7 +4184,7 @@ declare function getDeletedContact(contactId: string): Promise<NonNullablePaths<
 declare function listDeletedContacts(options?: ListDeletedContactsOptions): Promise<NonNullablePaths<ListDeletedContactsResponse, `contacts` | `contacts.${number}.email.email` | `contacts.${number}.email.subscriptionStatus.status` | `contacts.${number}.email.deliverabilityStatus` | `contacts.${number}.phone.tag` | `contacts.${number}.phone.phone` | `contacts.${number}.phone.deliverabilityStatus` | `contacts.${number}.memberInfo.status` | `contacts.${number}.memberInfo.profileInfo.privacyStatus` | `contacts.${number}.memberInfo.userInfo.userId` | `contacts.${number}.memberInfo.userInfo.role`, 6>>;
 interface ListDeletedContactsOptions {
     /**
-     * External ID
+     * External ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -4179,9 +4206,9 @@ interface ListDeletedContactsOptions {
      * @format GUID
      */
     contactIds?: string[];
-    /** From date and time that contact was deleted. */
+    /** Filters to contacts deleted on or after this date and time. */
     deletedFromDate?: Date | null;
-    /** Until date and time that contact was deleted. */
+    /** Filters to contacts deleted on or before this date and time. */
     deletedToDate?: Date | null;
     /** Cursor paging. */
     paging?: CursorPaging;
@@ -4202,13 +4229,12 @@ declare function getContactImageUploadStatus(identifiers: NonNullablePaths<GetCo
 }>;
 interface GetContactImageUploadStatusIdentifiers {
     /**
-     * Id of the contact for which to retrieve the image upload status.
+     * ID of the contact whose image upload status to retrieve.
      * @format GUID
      */
     contactId: string;
     /**
-     * The upload ID of the image upload process. Returned in case an image URL was provided when creating or
-     * updating a contact. It is also returned from the GenerateContactImageUploadUrl endpoint.
+     * The upload ID of the image upload process. Returned when an image URL is provided while creating or updating a contact, or from [Generate Contact Image Upload Url](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts-v5/generate-contact-image-upload-url).
      * @maxLength 100
      */
     imageUploadId: string;
@@ -4239,7 +4265,8 @@ interface BulkUpdatePhoneCountryCodeByFilterOptions {
     search?: SearchDetails;
     /**
      * [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code to apply.
-     * The country code will be added to the contacts main phone number, when adding it the phone, makes it a valid phone number.
+     *
+     * Applied only to contacts whose phone number isn't already in [ITU E.164 international](https://www.itu.int/rec/T-REC-E.164/) format. If the phone number still can't be converted to E.164 format after applying the country code, that contact fails with `PHONE_CANNOT_BE_FIXED_WITH_COUNTRY_CODE`.
      * @format COUNTRY
      */
     countryCode: string;