@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. */
@@ -938,6 +1098,7 @@ export interface Query {
938
1098
  * for more information.
939
1099
  *
940
1100
  * Max: 1 sort object
1101
+ * @maxSize 1
941
1102
  */
942
1103
  sort?: Sorting[];
943
1104
  /** Pagination options. */
@@ -953,6 +1114,8 @@ export interface Query {
953
1114
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
954
1115
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
955
1116
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
1117
+ * @maxLength 100
1118
+ * @maxSize 100
956
1119
  */
957
1120
  fields?: string[];
958
1121
  /**
@@ -966,6 +1129,7 @@ export interface Query {
966
1129
  * - `FULL`: Returns all fields.
967
1130
  *
968
1131
  * Default: If `fields` is omitted from the request, `FULL`.
1132
+ * @maxSize 10
969
1133
  */
970
1134
  fieldsets?: ContactFieldSet[];
971
1135
  }
@@ -979,7 +1143,10 @@ export interface QueryContactsResponse {
979
1143
  export interface ListFacetsRequest {
980
1144
  /** Pagination options. */
981
1145
  paging?: Paging;
982
- /** Language for localization. */
1146
+ /**
1147
+ * Language for localization.
1148
+ * @format LANGUAGE
1149
+ */
983
1150
  language?: string | null;
984
1151
  }
985
1152
  export interface ListFacetsResponse {
@@ -1021,7 +1188,10 @@ export declare enum ContactsFacetType {
1021
1188
  export interface QueryFacetsRequest {
1022
1189
  /** Pagination options. */
1023
1190
  paging?: Paging;
1024
- /** Language for localization. */
1191
+ /**
1192
+ * Language for localization.
1193
+ * @format LANGUAGE
1194
+ */
1025
1195
  language?: string | null;
1026
1196
  /**
1027
1197
  * Filterable fields:
@@ -1061,6 +1231,7 @@ export interface BulkDeleteContactsRequest {
1061
1231
  * - `info.name.last`
1062
1232
  * - `info.emails.email`
1063
1233
  * - `info.phones.phone`
1234
+ * @maxLength 100
1064
1235
  */
1065
1236
  search?: string | null;
1066
1237
  }
@@ -1068,6 +1239,7 @@ export interface BulkDeleteContactsResponse {
1068
1239
  /**
1069
1240
  * Bulk job ID.
1070
1241
  * The job's status can be retrieved with Get Bulk Job.
1242
+ * @format GUID
1071
1243
  */
1072
1244
  jobId?: string;
1073
1245
  }
@@ -1095,6 +1267,7 @@ export interface BulkUpdateContactsRequest {
1095
1267
  * - `info.name.last`
1096
1268
  * - `info.emails.email`
1097
1269
  * - `info.phones.phone`
1270
+ * @maxLength 100
1098
1271
  */
1099
1272
  search?: string | null;
1100
1273
  /** Contact info. */
@@ -1104,6 +1277,7 @@ export interface BulkUpdateContactsResponse {
1104
1277
  /**
1105
1278
  * Bulk job ID.
1106
1279
  * The job's status can be retrieved with Get Bulk Job.
1280
+ * @format GUID
1107
1281
  */
1108
1282
  jobId?: string;
1109
1283
  }
@@ -1124,6 +1298,7 @@ export interface BulkLabelAndUnlabelContactsRequest {
1124
1298
  * See
1125
1299
  * [Field Support for Filtering, Sorting, and Searching](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/sort-filter-and-search)
1126
1300
  * for a list of searchable fields.
1301
+ * @maxLength 100
1127
1302
  */
1128
1303
  search?: string | null;
1129
1304
  /**
@@ -1134,19 +1309,28 @@ export interface BulkLabelAndUnlabelContactsRequest {
1134
1309
  * [Find or Create Label](https://dev.wix.com/api/rest/contacts/labels/find-or-create-label)
1135
1310
  * or
1136
1311
  * [List Labels](https://dev.wix.com/api/rest/contacts/labels/list-labels)
1312
+ * @maxSize 100
1137
1313
  */
1138
1314
  labelKeysToAdd?: string[];
1139
- /** List of label keys to remove from the contacts. */
1315
+ /**
1316
+ * List of label keys to remove from the contacts.
1317
+ * @maxSize 100
1318
+ */
1140
1319
  labelKeysToRemove?: string[];
1141
1320
  }
1142
1321
  export interface BulkLabelAndUnlabelContactsResponse {
1143
1322
  /**
1144
1323
  * Bulk job ID.
1145
1324
  * The job's status can be retrieved with Get Bulk Job.
1325
+ * @format GUID
1146
1326
  */
1147
1327
  jobId?: string;
1148
1328
  }
1149
1329
  export interface BulkUpsertContactsRequest {
1330
+ /**
1331
+ * @minSize 1
1332
+ * @maxSize 100
1333
+ */
1150
1334
  info?: ContactInfo[];
1151
1335
  returnFullEntity?: boolean;
1152
1336
  }
@@ -1196,7 +1380,10 @@ export declare enum UpsertContactResponseAction {
1196
1380
  CREATED = "CREATED"
1197
1381
  }
1198
1382
  export interface GeneratePictureUploadUrlRequest {
1199
- /** ID of the contact whose picture is being updated. */
1383
+ /**
1384
+ * ID of the contact whose picture is being updated.
1385
+ * @format GUID
1386
+ */
1200
1387
  contactId?: string;
1201
1388
  /**
1202
1389
  * Mime Type. Must be one of:
@@ -1206,11 +1393,17 @@ export interface GeneratePictureUploadUrlRequest {
1206
1393
  mimeType?: string | null;
1207
1394
  }
1208
1395
  export interface GeneratePictureUploadUrlResponse {
1209
- /** URL to upload the image */
1396
+ /**
1397
+ * URL to upload the image
1398
+ * @format WEB_URL
1399
+ */
1210
1400
  uploadUrl?: string;
1211
1401
  }
1212
1402
  export interface GetContactRequest {
1213
- /** ID of the contact to retrieve. */
1403
+ /**
1404
+ * ID of the contact to retrieve.
1405
+ * @format GUID
1406
+ */
1214
1407
  _id: string;
1215
1408
  /**
1216
1409
  * List of projected fields to return.
@@ -1223,6 +1416,8 @@ export interface GetContactRequest {
1223
1416
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
1224
1417
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
1225
1418
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
1419
+ * @maxLength 100
1420
+ * @maxSize 100
1226
1421
  */
1227
1422
  fields?: string[];
1228
1423
  /**
@@ -1236,6 +1431,7 @@ export interface GetContactRequest {
1236
1431
  * - `FULL`: Returns all fields.
1237
1432
  *
1238
1433
  * Default: If `fields` is omitted from the request, `FULL`.
1434
+ * @maxSize 10
1239
1435
  */
1240
1436
  fieldsets?: ContactFieldSet[];
1241
1437
  }
@@ -1258,6 +1454,7 @@ export interface SyncSubmitContactRequest {
1258
1454
  contactInfo?: ContactInfo;
1259
1455
  activity?: ContactActivity;
1260
1456
  passThroughData?: string | null;
1457
+ /** @format GUID */
1261
1458
  contactId?: string;
1262
1459
  submitOperation?: SubmitOperation;
1263
1460
  /** Need to resolve source in allocator, because of server sign */
@@ -1297,6 +1494,8 @@ export interface Search extends SearchPagingMethodOneOf {
1297
1494
  *
1298
1495
  * For a list of valid projected fields, see
1299
1496
  * [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).
1497
+ * @maxLength 100
1498
+ * @maxSize 100
1300
1499
  */
1301
1500
  fields?: string[];
1302
1501
  /**
@@ -1307,6 +1506,7 @@ export interface Search extends SearchPagingMethodOneOf {
1307
1506
  *
1308
1507
  * For more information,
1309
1508
  * see [Contact Fieldsets](https://dev.wix.com/api/rest/contacts/contacts/fieldsets-and-projected-fields#contacts_contacts_fieldsets-and-projected-fields_contact-fieldsets).
1509
+ * @maxSize 10
1310
1510
  */
1311
1511
  fieldsets?: string[];
1312
1512
  /** free text to match in searchable fields */
@@ -1320,7 +1520,10 @@ export interface SearchPagingMethodOneOf {
1320
1520
  export interface SearchDetails {
1321
1521
  /** boolean search mode. Default is `OR` */
1322
1522
  mode?: Mode;
1323
- /** search term or expression */
1523
+ /**
1524
+ * search term or expression
1525
+ * @maxLength 100
1526
+ */
1324
1527
  expression?: string | null;
1325
1528
  /**
1326
1529
  * fields to search in. if empty - server will search in own default fieldsDefault searchable fields:
@@ -1329,6 +1532,8 @@ export interface SearchDetails {
1329
1532
  * - `info.name.last`
1330
1533
  * - `info.emails.email`
1331
1534
  * - `info.phones.phone`
1535
+ * @maxLength 100
1536
+ * @maxSize 100
1332
1537
  */
1333
1538
  fields?: string[];
1334
1539
  /** flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
@@ -1341,7 +1546,10 @@ export declare enum Mode {
1341
1546
  AND = "AND"
1342
1547
  }
1343
1548
  export interface CursorPaging {
1344
- /** The number of contacts to load (default = 50, max = 1000) */
1549
+ /**
1550
+ * The number of contacts to load (default = 50, max = 1000)
1551
+ * @max 1000
1552
+ */
1345
1553
  limit?: number | null;
1346
1554
  /** Cursor returned in last query response. Should not be provided on first page request */
1347
1555
  cursor?: string | null;
@@ -1373,11 +1581,23 @@ export interface Cursors {
1373
1581
  prev?: string | null;
1374
1582
  }
1375
1583
  export interface BulkAddSegmentToContactsRequest {
1376
- /** Segment id */
1584
+ /**
1585
+ * Segment id
1586
+ * @format GUID
1587
+ */
1377
1588
  segmentId?: string;
1378
- /** List of Contact ids */
1589
+ /**
1590
+ * List of Contact ids
1591
+ * @format GUID
1592
+ * @minSize 1
1593
+ * @maxSize 1000
1594
+ */
1379
1595
  contactIds?: string[];
1380
- /** List of existing segment ids */
1596
+ /**
1597
+ * List of existing segment ids
1598
+ * @format GUID
1599
+ * @maxSize 100
1600
+ */
1381
1601
  existsSegmentIds?: string[];
1382
1602
  }
1383
1603
  export interface BulkAddSegmentToContactsResponse {
@@ -1419,9 +1639,17 @@ export interface ContactAddedToSegment {
1419
1639
  contact?: Contact;
1420
1640
  }
1421
1641
  export interface BulkRemoveSegmentFromContactsRequest {
1422
- /** Segment id */
1642
+ /**
1643
+ * Segment id
1644
+ * @format GUID
1645
+ */
1423
1646
  segmentId?: string;
1424
- /** List of Contact ids */
1647
+ /**
1648
+ * List of Contact ids
1649
+ * @format GUID
1650
+ * @minSize 1
1651
+ * @maxSize 1000
1652
+ */
1425
1653
  contactIds?: string[];
1426
1654
  }
1427
1655
  export interface BulkRemoveSegmentFromContactsResponse {
@@ -1437,13 +1665,20 @@ export interface ContactRemovedFromSegment {
1437
1665
  contact?: Contact;
1438
1666
  }
1439
1667
  export interface ListContactIdsBySegmentRequest {
1440
- /** Segment id */
1668
+ /**
1669
+ * Segment id
1670
+ * @format GUID
1671
+ */
1441
1672
  segmentId?: string;
1442
1673
  /** Cursor paging. */
1443
1674
  cursorPaging?: CursorPaging;
1444
1675
  }
1445
1676
  export interface ListContactIdsBySegmentResponse {
1446
- /** List of contact IDs */
1677
+ /**
1678
+ * List of contact IDs
1679
+ * @format GUID
1680
+ * @maxSize 1000
1681
+ */
1447
1682
  contactIds?: string[];
1448
1683
  /** Paging metadata */
1449
1684
  cursorPagingMetadata?: CursorPagingMetadata;
@@ -1519,9 +1754,15 @@ export interface ActionEvent {
1519
1754
  body?: string;
1520
1755
  }
1521
1756
  export interface MessageEnvelope {
1522
- /** App instance ID. */
1757
+ /**
1758
+ * App instance ID.
1759
+ * @format GUID
1760
+ */
1523
1761
  instanceId?: string | null;
1524
- /** Event type. */
1762
+ /**
1763
+ * Event type.
1764
+ * @maxLength 150
1765
+ */
1525
1766
  eventType?: string;
1526
1767
  /** The identification type and identity data. */
1527
1768
  identity?: IdentificationData;
@@ -1529,26 +1770,50 @@ export interface MessageEnvelope {
1529
1770
  data?: string;
1530
1771
  }
1531
1772
  export interface IdentificationData extends IdentificationDataIdOneOf {
1532
- /** ID of a site visitor that has not logged in to the site. */
1773
+ /**
1774
+ * ID of a site visitor that has not logged in to the site.
1775
+ * @format GUID
1776
+ */
1533
1777
  anonymousVisitorId?: string;
1534
- /** ID of a site visitor that has logged in to the site. */
1778
+ /**
1779
+ * ID of a site visitor that has logged in to the site.
1780
+ * @format GUID
1781
+ */
1535
1782
  memberId?: string;
1536
- /** ID of a Wix user (site owner, contributor, etc.). */
1783
+ /**
1784
+ * ID of a Wix user (site owner, contributor, etc.).
1785
+ * @format GUID
1786
+ */
1537
1787
  wixUserId?: string;
1538
- /** ID of an app. */
1788
+ /**
1789
+ * ID of an app.
1790
+ * @format GUID
1791
+ */
1539
1792
  appId?: string;
1540
1793
  /** @readonly */
1541
1794
  identityType?: WebhookIdentityType;
1542
1795
  }
1543
1796
  /** @oneof */
1544
1797
  export interface IdentificationDataIdOneOf {
1545
- /** ID of a site visitor that has not logged in to the site. */
1798
+ /**
1799
+ * ID of a site visitor that has not logged in to the site.
1800
+ * @format GUID
1801
+ */
1546
1802
  anonymousVisitorId?: string;
1547
- /** ID of a site visitor that has logged in to the site. */
1803
+ /**
1804
+ * ID of a site visitor that has logged in to the site.
1805
+ * @format GUID
1806
+ */
1548
1807
  memberId?: string;
1549
- /** ID of a Wix user (site owner, contributor, etc.). */
1808
+ /**
1809
+ * ID of a Wix user (site owner, contributor, etc.).
1810
+ * @format GUID
1811
+ */
1550
1812
  wixUserId?: string;
1551
- /** ID of an app. */
1813
+ /**
1814
+ * ID of an app.
1815
+ * @format GUID
1816
+ */
1552
1817
  appId?: string;
1553
1818
  }
1554
1819
  export declare enum WebhookIdentityType {
@@ -1660,9 +1925,15 @@ export interface GetContactResponseNonNullableFields {
1660
1925
  responseType: GetContactResponseType;
1661
1926
  }
1662
1927
  export interface BaseEventMetadata {
1663
- /** App instance ID. */
1928
+ /**
1929
+ * App instance ID.
1930
+ * @format GUID
1931
+ */
1664
1932
  instanceId?: string | null;
1665
- /** Event type. */
1933
+ /**
1934
+ * Event type.
1935
+ * @maxLength 150
1936
+ */
1666
1937
  eventType?: string;
1667
1938
  /** The identification type and identity data. */
1668
1939
  identity?: IdentificationData;
@@ -1957,6 +2228,8 @@ export interface MergeContactsOptions {
1957
2228
  * IDs of up to 5 contacts to merge into the target contact.
1958
2229
  * When you merge more than one source contact,
1959
2230
  * the first source is given precedence, then the second, and so on.
2231
+ * @minSize 1
2232
+ * @maxSize 5
1960
2233
  */
1961
2234
  sourceContactIds?: string[];
1962
2235
  }
@@ -2178,6 +2451,8 @@ export interface GetContactOptions {
2178
2451
  * `info.name`, `info.emails`, `info.phones`, `info.addresses`, `info.company`,
2179
2452
  * `info.jobTitle`, `info.picture`, `info.birthdate`, `info.locale`,
2180
2453
  * `info.labelKeys`, `info.locations`, `info.extendedFields`
2454
+ * @maxLength 100
2455
+ * @maxSize 100
2181
2456
  */
2182
2457
  fields?: string[];
2183
2458
  /**
@@ -2191,6 +2466,7 @@ export interface GetContactOptions {
2191
2466
  * - `FULL`: Returns all fields.
2192
2467
  *
2193
2468
  * Default: If `fields` is omitted from the request, `FULL`.
2469
+ * @maxSize 10
2194
2470
  */
2195
2471
  fieldsets?: ContactFieldSet[];
2196
2472
  }