@wix/auto_sdk_crm_contacts-v-5 1.0.5 → 1.0.6

package/build/cjs/{contacts-v5-contact-contacts-v-5.universal-Bkb1VwgJ.d.ts → contacts-v5-contact-contacts-v-5.universal-CehUMnuf.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 {
@@ -1064,16 +1066,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 +1085,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 +1102,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 +1130,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 +1173,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 +1192,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 +1208,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 +1226,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 +1241,7 @@ interface DeleteContactResponse {
 }
 interface FindMatchingContactsRequest {
     /**
-     * Contact External ID.
+     * Contact external ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -1250,7 +1259,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,9 +1327,9 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QueryContactsResponse {
-    /** List of Contacts. */
+    /** Retrieved contacts. */
     contacts?: Contact[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
@@ -1355,7 +1364,7 @@ interface Cursors {
     prev?: string | null;
 }
 interface SearchContactsRequest {
-    /** WQL search expression */
+    /** WQL search expression. */
     search?: CursorSearch;
     /**
      * Name Format for sorting and searching.
@@ -1628,11 +1637,11 @@ 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 {
@@ -1821,7 +1830,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 +1849,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 +1910,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 +1976,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 +1991,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 +2031,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 +2047,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 +2071,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 +2105,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 +2149,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 +2167,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 +2176,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 +2198,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 +2247,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 +2301,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 {
@@ -2381,9 +2392,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 {
@@ -2400,13 +2411,12 @@ interface PagingMetadataV2 {
 }
 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 +2447,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 +2863,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 +2877,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 +2916,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 +2940,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 +3042,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 +3068,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 +3090,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 +3103,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 +3114,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 +3126,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 +3150,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 +3164,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 +3175,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 +3199,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 +3213,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 +3238,7 @@ declare function findMatchingContacts(options?: FindMatchingContactsOptions): Pr
 }>;
 interface FindMatchingContactsOptions {
     /**
-     * Contact External ID.
+     * Contact external ID.
      * @maxLength 100
      */
     externalId?: string | null;
@@ -3737,7 +3753,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 +3779,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 +3795,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 +3804,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 +3820,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 +3829,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 +3845,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 +3868,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 +3882,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 +3899,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 +3914,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 +3926,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 +3937,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 +3951,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 +3960,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 +3974,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 +3987,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 +4001,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 +4021,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 +4034,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 +4045,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 +4059,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 +4096,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 +4109,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 +4122,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 +4144,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 +4155,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 +4175,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 +4197,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 +4220,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 +4256,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;