@wix/auto_sdk_crm_contacts 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,7 @@
1
1
  export interface Contact {
2
2
  /**
3
3
  * Contact ID.
4
+ * @format GUID
4
5
  * @readonly
5
6
  */
6
7
  _id?: string;
@@ -57,6 +58,7 @@ export interface ContactSource {
57
58
  sourceType?: ContactSourceType;
58
59
  /**
59
60
  * App ID, if the contact was created by an app.
61
+ * @format GUID
60
62
  * @readonly
61
63
  */
62
64
  appId?: string | null;
@@ -173,9 +175,15 @@ export declare enum ContactActivityType {
173
175
  PHONE_SUBSCRIPTION_UNSUBSCRIBE = "PHONE_SUBSCRIPTION_UNSUBSCRIBE"
174
176
  }
175
177
  export interface ActivityIcon {
176
- /** Icon name */
178
+ /**
179
+ * Icon name
180
+ * @maxLength 50
181
+ */
177
182
  name?: string | null;
178
- /** Icon url */
183
+ /**
184
+ * Icon url
185
+ * @format WEB_URL
186
+ */
179
187
  url?: string | null;
180
188
  }
181
189
  export interface PrimaryContactInfo {
@@ -184,6 +192,7 @@ export interface PrimaryContactInfo {
184
192
  *
185
193
  * This property reflects the email address in `info.emails`
186
194
  * where `primary` is `true`.
195
+ * @format EMAIL
187
196
  * @readonly
188
197
  */
189
198
  email?: string | null;
@@ -205,11 +214,20 @@ export interface ContactInfo {
205
214
  phones?: ContactPhonesWrapper;
206
215
  /** Contact's street addresses. */
207
216
  addresses?: ContactAddressesWrapper;
208
- /** Contact's company name. */
217
+ /**
218
+ * Contact's company name.
219
+ * @maxLength 1000
220
+ */
209
221
  company?: string | null;
210
- /** Contact's job title. */
222
+ /**
223
+ * Contact's job title.
224
+ * @maxLength 1000
225
+ */
211
226
  jobTitle?: string | null;
212
- /** Birth date in `YYYY-MM-DD` format. For example, `2020-03-15`. */
227
+ /**
228
+ * Birth date in `YYYY-MM-DD` format. For example, `2020-03-15`.
229
+ * @format LOCAL_DATE
230
+ */
213
231
  birthdate?: string | null;
214
232
  /**
215
233
  * Locale in
@@ -217,6 +235,7 @@ export interface ContactInfo {
217
235
  * Typically, this is a lowercase 2-letter language code,
218
236
  * followed by a hyphen, followed by an uppercase 2-letter country code.
219
237
  * For example, `en-US` for U.S. English, and `de-DE` for Germany German.
238
+ * @format LANGUAGE_TAG
220
239
  */
221
240
  locale?: string | null;
222
241
  /**
@@ -238,18 +257,28 @@ export interface ContactInfo {
238
257
  picture?: ContactPicture;
239
258
  }
240
259
  export interface ContactName {
241
- /** Contact's first name. */
260
+ /**
261
+ * Contact's first name.
262
+ * @maxLength 1000
263
+ */
242
264
  first?: string | null;
243
- /** Contact's last name. */
265
+ /**
266
+ * Contact's last name.
267
+ * @maxLength 1000
268
+ */
244
269
  last?: string | null;
245
270
  }
246
271
  export interface ContactEmailsWrapper {
247
- /** List of up to 50 email addresses. */
272
+ /**
273
+ * List of up to 50 email addresses.
274
+ * @maxSize 50
275
+ */
248
276
  items?: ContactEmail[];
249
277
  }
250
278
  export interface ContactEmail {
251
279
  /**
252
280
  * Email ID.
281
+ * @format GUID
253
282
  * @readonly
254
283
  */
255
284
  _id?: string | null;
@@ -259,7 +288,11 @@ export interface ContactEmail {
259
288
  * `UNTAGGED` is shown as "Other" in the Contact List.
260
289
  */
261
290
  tag?: EmailTag;
262
- /** Email address. */
291
+ /**
292
+ * Email address.
293
+ * @minLength 1
294
+ * @maxLength 320
295
+ */
263
296
  email?: string;
264
297
  /**
265
298
  * Indicates whether this is the contact's primary email address.
@@ -276,12 +309,16 @@ export declare enum EmailTag {
276
309
  WORK = "WORK"
277
310
  }
278
311
  export interface ContactPhonesWrapper {
279
- /** List of up to 50 phone numbers. */
312
+ /**
313
+ * List of up to 50 phone numbers.
314
+ * @maxSize 50
315
+ */
280
316
  items?: ContactPhone[];
281
317
  }
282
318
  export interface ContactPhone {
283
319
  /**
284
320
  * Phone ID.
321
+ * @format GUID
285
322
  * @readonly
286
323
  */
287
324
  _id?: string | null;
@@ -291,9 +328,16 @@ export interface ContactPhone {
291
328
  * `UNTAGGED` is shown as "Other" in the Contact List.
292
329
  */
293
330
  tag?: PhoneTag;
294
- /** [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. */
331
+ /**
332
+ * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
333
+ * @format COUNTRY
334
+ */
295
335
  countryCode?: string | null;
296
- /** Phone number. */
336
+ /**
337
+ * Phone number.
338
+ * @minLength 1
339
+ * @maxLength 50
340
+ */
297
341
  phone?: string;
298
342
  /**
299
343
  * [ITU E.164-formatted](https://www.itu.int/rec/T-REC-E.164/)
@@ -319,12 +363,16 @@ export declare enum PhoneTag {
319
363
  FAX = "FAX"
320
364
  }
321
365
  export interface ContactAddressesWrapper {
322
- /** List of up to 50 addresses. */
366
+ /**
367
+ * List of up to 50 addresses.
368
+ * @maxSize 50
369
+ */
323
370
  items?: ContactAddress[];
324
371
  }
325
372
  export interface ContactAddress {
326
373
  /**
327
374
  * Street address ID.
375
+ * @format GUID
328
376
  * @readonly
329
377
  */
330
378
  _id?: string | null;
@@ -347,25 +395,37 @@ export declare enum AddressTag {
347
395
  export interface Address extends AddressStreetOneOf {
348
396
  /** Street address object, with number and name in separate fields. */
349
397
  streetAddress?: StreetAddress;
350
- /** Main address line, usually street and number, as free text. */
398
+ /**
399
+ * Main address line, usually street and number, as free text.
400
+ * @maxLength 1000
401
+ */
351
402
  addressLine1?: string | null;
352
403
  /**
353
404
  * 2-letter country code in an
354
405
  * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
406
+ * @format COUNTRY
355
407
  */
356
408
  country?: string | null;
357
409
  /**
358
410
  * Code for a subdivision (such as state, prefecture, or province) in an
359
411
  * [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) format.
412
+ * @maxLength 100
360
413
  */
361
414
  subdivision?: string | null;
362
- /** City name. */
415
+ /**
416
+ * City name.
417
+ * @maxLength 1000
418
+ */
363
419
  city?: string | null;
364
- /** Postal or zip code. */
420
+ /**
421
+ * Postal or zip code.
422
+ * @maxLength 100
423
+ */
365
424
  postalCode?: string | null;
366
425
  /**
367
426
  * Free text providing more detailed address information,
368
427
  * such as apartment, suite, or floor.
428
+ * @maxLength 1000
369
429
  */
370
430
  addressLine2?: string | null;
371
431
  }
@@ -373,13 +433,22 @@ export interface Address extends AddressStreetOneOf {
373
433
  export interface AddressStreetOneOf {
374
434
  /** Street address object, with number and name in separate fields. */
375
435
  streetAddress?: StreetAddress;
376
- /** Main address line, usually street and number, as free text. */
436
+ /**
437
+ * Main address line, usually street and number, as free text.
438
+ * @maxLength 1000
439
+ */
377
440
  addressLine?: string | null;
378
441
  }
379
442
  export interface StreetAddress {
380
- /** Street number. */
443
+ /**
444
+ * Street number.
445
+ * @maxLength 100
446
+ */
381
447
  number?: string;
382
- /** Street name. */
448
+ /**
449
+ * Street name.
450
+ * @maxLength 1000
451
+ */
383
452
  name?: string;
384
453
  }
385
454
  export interface AddressLocation {
@@ -410,7 +479,11 @@ export declare enum SubdivisionType {
410
479
  COUNTRY = "COUNTRY"
411
480
  }
412
481
  export interface AssigneesWrapper {
413
- /** List of site contributor user IDs. */
482
+ /**
483
+ * List of site contributor user IDs.
484
+ * @format GUID
485
+ * @maxSize 50
486
+ */
414
487
  items?: string[];
415
488
  }
416
489
  export interface LabelsWrapper {
@@ -419,6 +492,7 @@ export interface LabelsWrapper {
419
492
  *
420
493
  * Contact labels help categorize contacts. Label keys must exist to be added to the contact.
421
494
  * Contact labels can be created or retrieved with Find or Create Label or List Labels.
495
+ * @maxSize 2000
422
496
  */
423
497
  items?: string[];
424
498
  }
@@ -433,7 +507,11 @@ export interface ExtendedFieldsWrapper {
433
507
  items?: Record<string, any>;
434
508
  }
435
509
  export interface LocationsWrapper {
436
- /** List of location ids. */
510
+ /**
511
+ * List of location ids.
512
+ * @format GUID
513
+ * @maxSize 50
514
+ */
437
515
  items?: string[];
438
516
  }
439
517
  /** TEST contact picture description */
@@ -452,7 +530,11 @@ export declare enum ImageProvider {
452
530
  WIX_MEDIA = "WIX_MEDIA"
453
531
  }
454
532
  export interface SegmentsWrapper {
455
- /** List of Contact segment IDs */
533
+ /**
534
+ * List of Contact segment IDs
535
+ * @maxSize 60
536
+ * @format GUID
537
+ */
456
538
  items?: string[];
457
539
  }
458
540
  export interface PrimaryEmail {
@@ -461,6 +543,7 @@ export interface PrimaryEmail {
461
543
  *
462
544
  * This property reflects the email address in `info.emails`
463
545
  * where `primary` is `true`.
546
+ * @format EMAIL
464
547
  * @readonly
465
548
  */
466
549
  email?: string | null;
@@ -503,7 +586,10 @@ export declare enum EmailDeliverabilityStatus {
503
586
  INACTIVE = "INACTIVE"
504
587
  }
505
588
  export interface PrimaryPhone {
506
- /** [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the primary phone. */
589
+ /**
590
+ * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the primary phone.
591
+ * @format COUNTRY
592
+ */
507
593
  countryCode?: string | null;
508
594
  /**
509
595
  * [ITU E.164-formatted](https://www.itu.int/rec/T-REC-E.164/)
@@ -544,11 +630,17 @@ export declare enum PhoneDeliverabilityStatus {
544
630
  NOT_SET = "NOT_SET"
545
631
  }
546
632
  export interface MemberInfo {
547
- /** Member ID */
633
+ /**
634
+ * Member ID
635
+ * @format GUID
636
+ */
548
637
  memberId?: string | null;
549
638
  /** Signup date */
550
639
  signupDate?: Date | null;
551
- /** Login email */
640
+ /**
641
+ * Login email
642
+ * @format EMAIL
643
+ */
552
644
  email?: string | null;
553
645
  /** Indicate whether the email is verified */
554
646
  emailVerified?: boolean | null;
@@ -579,7 +671,10 @@ export declare enum MemberStatus {
579
671
  OFFLINE = "OFFLINE"
580
672
  }
581
673
  export interface ProfileInfo {
582
- /** Nickname */
674
+ /**
675
+ * Nickname
676
+ * @maxLength 255
677
+ */
583
678
  nickname?: string | null;
584
679
  /** Privacy status */
585
680
  privacyStatus?: PrivacyStatus;
@@ -595,7 +690,10 @@ export declare enum PrivacyStatus {
595
690
  PUBLIC = "PUBLIC"
596
691
  }
597
692
  export interface UserInfo {
598
- /** User ID */
693
+ /**
694
+ * User ID
695
+ * @format GUID
696
+ */
599
697
  userId?: string;
600
698
  /** The user's role on the website */
601
699
  role?: Role;
@@ -610,11 +708,19 @@ export interface SessionInfo {
610
708
  lastWebLogin?: Date | null;
611
709
  /** Last time the member logged in to one of the mobile apps */
612
710
  lastMobileLogin?: Date | null;
613
- /** List of mobile apps that the member has ever logged in to */
711
+ /**
712
+ * List of mobile apps that the member has ever logged in to
713
+ * @maxSize 50
714
+ * @maxLength 50
715
+ */
614
716
  mobileAppNames?: string[];
615
717
  }
616
718
  export interface GroupInfo {
617
- /** Group IDs */
719
+ /**
720
+ * Group IDs
721
+ * @format GUID
722
+ * @maxSize 1000
723
+ */
618
724
  groupIds?: string[];
619
725
  }
620
726
  export interface ContactSubmitted {
@@ -677,13 +783,22 @@ export interface PrimarySubscriptionStatus {
677
783
  * the update of the contact's last activity is done asynchronously.
678
784
  */
679
785
  export interface LastActivityUpdate {
680
- /** The contact ID. */
786
+ /**
787
+ * The contact ID.
788
+ * @format GUID
789
+ */
681
790
  contactId?: string;
682
791
  /** Activity date. */
683
792
  activityDate?: Date | null;
684
- /** Activity translation key. */
793
+ /**
794
+ * Activity translation key.
795
+ * @maxLength 100
796
+ */
685
797
  activityTranslationKey?: string;
686
- /** Activity icon. */
798
+ /**
799
+ * Activity icon.
800
+ * @maxLength 100
801
+ */
687
802
  icon?: string | null;
688
803
  }
689
804
  /** Contact creation options. */
@@ -710,12 +825,18 @@ export interface CreateContactResponse {
710
825
  contact?: Contact;
711
826
  }
712
827
  export interface DuplicateContactExists {
828
+ /** @format GUID */
713
829
  duplicateContactId?: string | null;
830
+ /** @format EMAIL */
714
831
  duplicateEmail?: string | null;
832
+ /** @format PHONE */
715
833
  duplicatePhone?: string | null;
716
834
  }
717
835
  export interface UpdateContactRequest {
718
- /** ID of the contact to update. */
836
+ /**
837
+ * ID of the contact to update.
838
+ * @format GUID
839
+ */
719
840
  contactId: string;
720
841
  /**
721
842
  * Revision number.
@@ -745,7 +866,10 @@ export interface UpdateContactResponse {
745
866
  contact?: Contact;
746
867
  }
747
868
  export interface MergeContactsRequest {
748
- /** Target contact ID. */
869
+ /**
870
+ * Target contact ID.
871
+ * @format GUID
872
+ */
749
873
  targetContactId: string;
750
874
  /**
751
875
  * Target contact revision number, which increments by 1 each time the contact is updated.
@@ -757,6 +881,8 @@ export interface MergeContactsRequest {
757
881
  * IDs of up to 5 contacts to merge into the target contact.
758
882
  * When you merge more than one source contact,
759
883
  * the first source is given precedence, then the second, and so on.
884
+ * @minSize 1
885
+ * @maxSize 5
760
886
  */
761
887
  sourceContactIds?: string[];
762
888
  }
@@ -773,12 +899,17 @@ export interface ContactMerged {
773
899
  targetContact?: Contact;
774
900
  }
775
901
  export interface PreviewMergeContactsRequest {
776
- /** Target contact ID. */
902
+ /**
903
+ * Target contact ID.
904
+ * @format GUID
905
+ */
777
906
  targetContactId?: string;
778
907
  /**
779
908
  * IDs of up to 5 contacts to merge into the target contact.
780
909
  * When you merge more than one source contact,
781
910
  * the first source is given precedence, then the second, and so on.
911
+ * @minSize 1
912
+ * @maxSize 5
782
913
  */
783
914
  sourceContactIds?: string[];
784
915
  }
@@ -787,19 +918,27 @@ export interface PreviewMergeContactsResponse {
787
918
  contact?: Contact;
788
919
  }
789
920
  export interface DeleteContactRequest {
790
- /** ID of the contact to delete. */
921
+ /**
922
+ * ID of the contact to delete.
923
+ * @format GUID
924
+ */
791
925
  contactId: string;
792
926
  }
793
927
  export interface DeleteContactResponse {
794
928
  }
795
929
  export interface LabelContactRequest {
796
- /** ID of the contact to add labels to. */
930
+ /**
931
+ * ID of the contact to add labels to.
932
+ * @format GUID
933
+ */
797
934
  contactId: string;
798
935
  /**
799
936
  * List of label keys to add to the contact.
800
937
  *
801
938
  * Label keys must exist to be added to the contact.
802
939
  * Use the Labels API to create or retrieve labels.
940
+ * @minSize 1
941
+ * @maxSize 100
803
942
  */
804
943
  labelKeys: string[];
805
944
  }
@@ -809,9 +948,16 @@ export interface LabelContactResponse {
809
948
  contact?: Contact;
810
949
  }
811
950
  export interface UnlabelContactRequest {
812
- /** ID of the contact to remove labels from. */
951
+ /**
952
+ * ID of the contact to remove labels from.
953
+ * @format GUID
954
+ */
813
955
  contactId: string;
814
- /** List of label keys to remove from the contact. */
956
+ /**
957
+ * List of label keys to remove from the contact.
958
+ * @minSize 1
959
+ * @maxSize 100
960
+ */
815
961
  labelKeys: string[];
816
962
  }
817
963
  /** Updated contact. */
@@ -820,7 +966,10 @@ export interface UnlabelContactResponse {
820
966
  contact?: Contact;
821
967
  }
822
968
  export interface LabelAndUnlabelContactRequest {
823
- /** Contact ID. */
969
+ /**
970
+ * Contact ID.
971
+ * @format GUID
972
+ */
824
973
  contactId?: string;
825
974
  /**
826
975
  * List of label keys to add to the contact.
@@ -830,9 +979,15 @@ export interface LabelAndUnlabelContactRequest {
830
979
  * [Find or Create Label](https://dev.wix.com/api/rest/contacts/labels/find-or-create-label)
831
980
  * or
832
981
  * [List Labels](https://dev.wix.com/api/rest/contacts/labels/list-labels).
982
+ * @minSize 1
983
+ * @maxSize 100
833
984
  */
834
985
  labelKeysToAdd?: string[];
835
- /** List of label keys to remove from the contact. */
986
+ /**
987
+ * List of label keys to remove from the contact.
988
+ * @minSize 1
989
+ * @maxSize 100
990
+ */
836
991
  labelKeysToRemove?: string[];
837
992
  }
838
993
  export interface LabelAndUnlabelContactResponse {
@@ -855,8 +1010,11 @@ export interface ListContactsRequest {
855
1010
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
856
1011
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
857
1012
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
1013
+ * @maxLength 100
1014
+ * @maxSize 100
858
1015
  */
859
1016
  fields?: string[];
1017
+ /** @maxSize 10 */
860
1018
  fieldsets?: ContactFieldSet[];
861
1019
  }
862
1020
  export interface Sorting {
@@ -866,6 +1024,7 @@ export interface Sorting {
866
1024
  * Supported properties:
867
1025
  * `createdDate`, `lastActivity.activityDate`, `primaryInfo.email`, `info.name.first`, `info.name.last`, `info.company`,
868
1026
  * `info.jobTitle`, `info.birthdate`
1027
+ * @maxLength 100
869
1028
  */
870
1029
  fieldName?: string;
871
1030
  /**
@@ -886,6 +1045,7 @@ export interface Paging {
886
1045
  *
887
1046
  * Default: `50`. <br>
888
1047
  * Maximum: `1000`.
1048
+ * @max 1000
889
1049
  */
890
1050
  limit?: number | null;
891
1051
  /** Number of items to skip in the current sort order. */
@@ -921,7 +1081,9 @@ export interface PagingMetadata {
921
1081
  export interface QueryContactsRequest {
922
1082
  /**
923
1083
  * @internal
924
- * @internal */
1084
+ * @internal
1085
+ * @maxLength 100
1086
+ */
925
1087
  search?: string | null;
926
1088
  /** Query options. */
927
1089
  query?: Query;
@@ -942,6 +1104,7 @@ export interface Query {
942
1104
  * for more information.
943
1105
  *
944
1106
  * Max: 1 sort object
1107
+ * @maxSize 1
945
1108
  */
946
1109
  sort?: Sorting[];
947
1110
  /** Pagination options. */
@@ -957,6 +1120,8 @@ export interface Query {
957
1120
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
958
1121
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
959
1122
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
1123
+ * @maxLength 100
1124
+ * @maxSize 100
960
1125
  */
961
1126
  fields?: string[];
962
1127
  /**
@@ -970,6 +1135,7 @@ export interface Query {
970
1135
  * - `FULL`: Returns all fields.
971
1136
  *
972
1137
  * Default: If `fields` is omitted from the request, `FULL`.
1138
+ * @maxSize 10
973
1139
  */
974
1140
  fieldsets?: ContactFieldSet[];
975
1141
  }
@@ -983,7 +1149,10 @@ export interface QueryContactsResponse {
983
1149
  export interface ListFacetsRequest {
984
1150
  /** Pagination options. */
985
1151
  paging?: Paging;
986
- /** Language for localization. */
1152
+ /**
1153
+ * Language for localization.
1154
+ * @format LANGUAGE
1155
+ */
987
1156
  language?: string | null;
988
1157
  }
989
1158
  export interface ListFacetsResponse {
@@ -1025,7 +1194,10 @@ export declare enum ContactsFacetType {
1025
1194
  export interface QueryFacetsRequest {
1026
1195
  /** Pagination options. */
1027
1196
  paging?: Paging;
1028
- /** Language for localization. */
1197
+ /**
1198
+ * Language for localization.
1199
+ * @format LANGUAGE
1200
+ */
1029
1201
  language?: string | null;
1030
1202
  /**
1031
1203
  * Filterable fields:
@@ -1065,6 +1237,7 @@ export interface BulkDeleteContactsRequest {
1065
1237
  * - `info.name.last`
1066
1238
  * - `info.emails.email`
1067
1239
  * - `info.phones.phone`
1240
+ * @maxLength 100
1068
1241
  */
1069
1242
  search?: string | null;
1070
1243
  }
@@ -1072,6 +1245,7 @@ export interface BulkDeleteContactsResponse {
1072
1245
  /**
1073
1246
  * Bulk job ID.
1074
1247
  * The job's status can be retrieved with Get Bulk Job.
1248
+ * @format GUID
1075
1249
  */
1076
1250
  jobId?: string;
1077
1251
  }
@@ -1099,6 +1273,7 @@ export interface BulkUpdateContactsRequest {
1099
1273
  * - `info.name.last`
1100
1274
  * - `info.emails.email`
1101
1275
  * - `info.phones.phone`
1276
+ * @maxLength 100
1102
1277
  */
1103
1278
  search?: string | null;
1104
1279
  /** Contact info. */
@@ -1108,6 +1283,7 @@ export interface BulkUpdateContactsResponse {
1108
1283
  /**
1109
1284
  * Bulk job ID.
1110
1285
  * The job's status can be retrieved with Get Bulk Job.
1286
+ * @format GUID
1111
1287
  */
1112
1288
  jobId?: string;
1113
1289
  }
@@ -1128,6 +1304,7 @@ export interface BulkLabelAndUnlabelContactsRequest {
1128
1304
  * See
1129
1305
  * [Field Support for Filtering, Sorting, and Searching](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/sort-filter-and-search)
1130
1306
  * for a list of searchable fields.
1307
+ * @maxLength 100
1131
1308
  */
1132
1309
  search?: string | null;
1133
1310
  /**
@@ -1138,19 +1315,28 @@ export interface BulkLabelAndUnlabelContactsRequest {
1138
1315
  * [Find or Create Label](https://dev.wix.com/api/rest/contacts/labels/find-or-create-label)
1139
1316
  * or
1140
1317
  * [List Labels](https://dev.wix.com/api/rest/contacts/labels/list-labels)
1318
+ * @maxSize 100
1141
1319
  */
1142
1320
  labelKeysToAdd?: string[];
1143
- /** List of label keys to remove from the contacts. */
1321
+ /**
1322
+ * List of label keys to remove from the contacts.
1323
+ * @maxSize 100
1324
+ */
1144
1325
  labelKeysToRemove?: string[];
1145
1326
  }
1146
1327
  export interface BulkLabelAndUnlabelContactsResponse {
1147
1328
  /**
1148
1329
  * Bulk job ID.
1149
1330
  * The job's status can be retrieved with Get Bulk Job.
1331
+ * @format GUID
1150
1332
  */
1151
1333
  jobId?: string;
1152
1334
  }
1153
1335
  export interface BulkUpsertContactsRequest {
1336
+ /**
1337
+ * @minSize 1
1338
+ * @maxSize 100
1339
+ */
1154
1340
  info?: ContactInfo[];
1155
1341
  returnFullEntity?: boolean;
1156
1342
  }
@@ -1200,7 +1386,10 @@ export declare enum UpsertContactResponseAction {
1200
1386
  CREATED = "CREATED"
1201
1387
  }
1202
1388
  export interface GeneratePictureUploadUrlRequest {
1203
- /** ID of the contact whose picture is being updated. */
1389
+ /**
1390
+ * ID of the contact whose picture is being updated.
1391
+ * @format GUID
1392
+ */
1204
1393
  contactId?: string;
1205
1394
  /**
1206
1395
  * Mime Type. Must be one of:
@@ -1210,11 +1399,17 @@ export interface GeneratePictureUploadUrlRequest {
1210
1399
  mimeType?: string | null;
1211
1400
  }
1212
1401
  export interface GeneratePictureUploadUrlResponse {
1213
- /** URL to upload the image */
1402
+ /**
1403
+ * URL to upload the image
1404
+ * @format WEB_URL
1405
+ */
1214
1406
  uploadUrl?: string;
1215
1407
  }
1216
1408
  export interface GetContactRequest {
1217
- /** ID of the contact to retrieve. */
1409
+ /**
1410
+ * ID of the contact to retrieve.
1411
+ * @format GUID
1412
+ */
1218
1413
  _id: string;
1219
1414
  /**
1220
1415
  * List of projected fields to return.
@@ -1227,6 +1422,8 @@ export interface GetContactRequest {
1227
1422
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
1228
1423
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
1229
1424
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
1425
+ * @maxLength 100
1426
+ * @maxSize 100
1230
1427
  */
1231
1428
  fields?: string[];
1232
1429
  /**
@@ -1240,6 +1437,7 @@ export interface GetContactRequest {
1240
1437
  * - `FULL`: Returns all fields.
1241
1438
  *
1242
1439
  * Default: If `fields` is omitted from the request, `FULL`.
1440
+ * @maxSize 10
1243
1441
  */
1244
1442
  fieldsets?: ContactFieldSet[];
1245
1443
  }
@@ -1262,6 +1460,7 @@ export interface SyncSubmitContactRequest {
1262
1460
  contactInfo?: ContactInfo;
1263
1461
  activity?: ContactActivity;
1264
1462
  passThroughData?: string | null;
1463
+ /** @format GUID */
1265
1464
  contactId?: string;
1266
1465
  submitOperation?: SubmitOperation;
1267
1466
  /** Need to resolve source in allocator, because of server sign */
@@ -1301,6 +1500,8 @@ export interface Search extends SearchPagingMethodOneOf {
1301
1500
  *
1302
1501
  * For a list of valid projected fields, see
1303
1502
  * [Valid Contact Projection Fields](https://dev.wix.com/api/rest/contacts/contacts/fieldsets-and-projected-fields#contacts_contacts_fieldsets-and-projected-fields_valid-contact-projection-fields).
1503
+ * @maxLength 100
1504
+ * @maxSize 100
1304
1505
  */
1305
1506
  fields?: string[];
1306
1507
  /**
@@ -1311,6 +1512,7 @@ export interface Search extends SearchPagingMethodOneOf {
1311
1512
  *
1312
1513
  * For more information,
1313
1514
  * see [Contact Fieldsets](https://dev.wix.com/api/rest/contacts/contacts/fieldsets-and-projected-fields#contacts_contacts_fieldsets-and-projected-fields_contact-fieldsets).
1515
+ * @maxSize 10
1314
1516
  */
1315
1517
  fieldsets?: string[];
1316
1518
  /** free text to match in searchable fields */
@@ -1324,7 +1526,10 @@ export interface SearchPagingMethodOneOf {
1324
1526
  export interface SearchDetails {
1325
1527
  /** boolean search mode. Default is `OR` */
1326
1528
  mode?: Mode;
1327
- /** search term or expression */
1529
+ /**
1530
+ * search term or expression
1531
+ * @maxLength 100
1532
+ */
1328
1533
  expression?: string | null;
1329
1534
  /**
1330
1535
  * fields to search in. if empty - server will search in own default fieldsDefault searchable fields:
@@ -1333,6 +1538,8 @@ export interface SearchDetails {
1333
1538
  * - `info.name.last`
1334
1539
  * - `info.emails.email`
1335
1540
  * - `info.phones.phone`
1541
+ * @maxLength 100
1542
+ * @maxSize 100
1336
1543
  */
1337
1544
  fields?: string[];
1338
1545
  /** flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
@@ -1345,7 +1552,10 @@ export declare enum Mode {
1345
1552
  AND = "AND"
1346
1553
  }
1347
1554
  export interface CursorPaging {
1348
- /** The number of contacts to load (default = 50, max = 1000) */
1555
+ /**
1556
+ * The number of contacts to load (default = 50, max = 1000)
1557
+ * @max 1000
1558
+ */
1349
1559
  limit?: number | null;
1350
1560
  /** Cursor returned in last query response. Should not be provided on first page request */
1351
1561
  cursor?: string | null;
@@ -1377,11 +1587,23 @@ export interface Cursors {
1377
1587
  prev?: string | null;
1378
1588
  }
1379
1589
  export interface BulkAddSegmentToContactsRequest {
1380
- /** Segment id */
1590
+ /**
1591
+ * Segment id
1592
+ * @format GUID
1593
+ */
1381
1594
  segmentId?: string;
1382
- /** List of Contact ids */
1595
+ /**
1596
+ * List of Contact ids
1597
+ * @format GUID
1598
+ * @minSize 1
1599
+ * @maxSize 1000
1600
+ */
1383
1601
  contactIds?: string[];
1384
- /** List of existing segment ids */
1602
+ /**
1603
+ * List of existing segment ids
1604
+ * @format GUID
1605
+ * @maxSize 100
1606
+ */
1385
1607
  existsSegmentIds?: string[];
1386
1608
  }
1387
1609
  export interface BulkAddSegmentToContactsResponse {
@@ -1423,9 +1645,17 @@ export interface ContactAddedToSegment {
1423
1645
  contact?: Contact;
1424
1646
  }
1425
1647
  export interface BulkRemoveSegmentFromContactsRequest {
1426
- /** Segment id */
1648
+ /**
1649
+ * Segment id
1650
+ * @format GUID
1651
+ */
1427
1652
  segmentId?: string;
1428
- /** List of Contact ids */
1653
+ /**
1654
+ * List of Contact ids
1655
+ * @format GUID
1656
+ * @minSize 1
1657
+ * @maxSize 1000
1658
+ */
1429
1659
  contactIds?: string[];
1430
1660
  }
1431
1661
  export interface BulkRemoveSegmentFromContactsResponse {
@@ -1441,13 +1671,20 @@ export interface ContactRemovedFromSegment {
1441
1671
  contact?: Contact;
1442
1672
  }
1443
1673
  export interface ListContactIdsBySegmentRequest {
1444
- /** Segment id */
1674
+ /**
1675
+ * Segment id
1676
+ * @format GUID
1677
+ */
1445
1678
  segmentId?: string;
1446
1679
  /** Cursor paging. */
1447
1680
  cursorPaging?: CursorPaging;
1448
1681
  }
1449
1682
  export interface ListContactIdsBySegmentResponse {
1450
- /** List of contact IDs */
1683
+ /**
1684
+ * List of contact IDs
1685
+ * @format GUID
1686
+ * @maxSize 1000
1687
+ */
1451
1688
  contactIds?: string[];
1452
1689
  /** Paging metadata */
1453
1690
  cursorPagingMetadata?: CursorPagingMetadata;
@@ -1523,9 +1760,15 @@ export interface ActionEvent {
1523
1760
  body?: string;
1524
1761
  }
1525
1762
  export interface MessageEnvelope {
1526
- /** App instance ID. */
1763
+ /**
1764
+ * App instance ID.
1765
+ * @format GUID
1766
+ */
1527
1767
  instanceId?: string | null;
1528
- /** Event type. */
1768
+ /**
1769
+ * Event type.
1770
+ * @maxLength 150
1771
+ */
1529
1772
  eventType?: string;
1530
1773
  /** The identification type and identity data. */
1531
1774
  identity?: IdentificationData;
@@ -1533,26 +1776,50 @@ export interface MessageEnvelope {
1533
1776
  data?: string;
1534
1777
  }
1535
1778
  export interface IdentificationData extends IdentificationDataIdOneOf {
1536
- /** ID of a site visitor that has not logged in to the site. */
1779
+ /**
1780
+ * ID of a site visitor that has not logged in to the site.
1781
+ * @format GUID
1782
+ */
1537
1783
  anonymousVisitorId?: string;
1538
- /** ID of a site visitor that has logged in to the site. */
1784
+ /**
1785
+ * ID of a site visitor that has logged in to the site.
1786
+ * @format GUID
1787
+ */
1539
1788
  memberId?: string;
1540
- /** ID of a Wix user (site owner, contributor, etc.). */
1789
+ /**
1790
+ * ID of a Wix user (site owner, contributor, etc.).
1791
+ * @format GUID
1792
+ */
1541
1793
  wixUserId?: string;
1542
- /** ID of an app. */
1794
+ /**
1795
+ * ID of an app.
1796
+ * @format GUID
1797
+ */
1543
1798
  appId?: string;
1544
1799
  /** @readonly */
1545
1800
  identityType?: WebhookIdentityType;
1546
1801
  }
1547
1802
  /** @oneof */
1548
1803
  export interface IdentificationDataIdOneOf {
1549
- /** ID of a site visitor that has not logged in to the site. */
1804
+ /**
1805
+ * ID of a site visitor that has not logged in to the site.
1806
+ * @format GUID
1807
+ */
1550
1808
  anonymousVisitorId?: string;
1551
- /** ID of a site visitor that has logged in to the site. */
1809
+ /**
1810
+ * ID of a site visitor that has logged in to the site.
1811
+ * @format GUID
1812
+ */
1552
1813
  memberId?: string;
1553
- /** ID of a Wix user (site owner, contributor, etc.). */
1814
+ /**
1815
+ * ID of a Wix user (site owner, contributor, etc.).
1816
+ * @format GUID
1817
+ */
1554
1818
  wixUserId?: string;
1555
- /** ID of an app. */
1819
+ /**
1820
+ * ID of an app.
1821
+ * @format GUID
1822
+ */
1556
1823
  appId?: string;
1557
1824
  }
1558
1825
  export declare enum WebhookIdentityType {
@@ -1692,9 +1959,15 @@ export interface GetContactResponseNonNullableFields {
1692
1959
  responseType: GetContactResponseType;
1693
1960
  }
1694
1961
  export interface BaseEventMetadata {
1695
- /** App instance ID. */
1962
+ /**
1963
+ * App instance ID.
1964
+ * @format GUID
1965
+ */
1696
1966
  instanceId?: string | null;
1697
- /** Event type. */
1967
+ /**
1968
+ * Event type.
1969
+ * @maxLength 150
1970
+ */
1698
1971
  eventType?: string;
1699
1972
  /** The identification type and identity data. */
1700
1973
  identity?: IdentificationData;
@@ -1989,6 +2262,8 @@ export interface MergeContactsOptions {
1989
2262
  * IDs of up to 5 contacts to merge into the target contact.
1990
2263
  * When you merge more than one source contact,
1991
2264
  * the first source is given precedence, then the second, and so on.
2265
+ * @minSize 1
2266
+ * @maxSize 5
1992
2267
  */
1993
2268
  sourceContactIds?: string[];
1994
2269
  }
@@ -2104,7 +2379,10 @@ export declare function unlabelContact(contactId: string, labelKeys: string[]):
2104
2379
  */
2105
2380
  export declare function queryContacts(options?: QueryContactsOptions): ContactsQueryBuilder;
2106
2381
  export interface QueryContactsOptions {
2107
- /** @internal */
2382
+ /**
2383
+ * @internal
2384
+ * @maxLength 100
2385
+ */
2108
2386
  search?: string | null | undefined;
2109
2387
  }
2110
2388
  interface QueryOffsetResult {
@@ -2212,6 +2490,8 @@ export interface GetContactOptions {
2212
2490
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
2213
2491
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
2214
2492
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
2493
+ * @maxLength 100
2494
+ * @maxSize 100
2215
2495
  */
2216
2496
  fields?: string[];
2217
2497
  /**
@@ -2225,6 +2505,7 @@ export interface GetContactOptions {
2225
2505
  * - `FULL`: Returns all fields.
2226
2506
  *
2227
2507
  * Default: If `fields` is omitted from the request, `FULL`.
2508
+ * @maxSize 10
2228
2509
  */
2229
2510
  fieldsets?: ContactFieldSet[];
2230
2511
  }