@wix/auto_sdk_events_wix-events-v-2 1.0.38 → 1.0.39

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.
@@ -19,11 +19,14 @@ interface V3Event {
19
19
  title?: string | null;
20
20
  /**
21
21
  * Short description that appears under the event title.
22
+ * **Note:** This field is returned only when the `DETAILS` fieldset is included in the request.
22
23
  * @maxLength 500
23
24
  */
24
25
  shortDescription?: string | null;
25
26
  /**
26
- * Detailed description of an event. You can enter the description using rich text format (add various types of markups, such as underlines, italics, bolding, color codes, bullet lists, and links by using HTML formatting tags).
27
+ * Detailed description of an event.
28
+ *
29
+ * This field is deprecated.
27
30
  * @maxLength 50000
28
31
  * @deprecated Detailed description of an event.
29
32
  *
@@ -53,13 +56,7 @@ interface V3Event {
53
56
  */
54
57
  _updatedDate?: Date | null;
55
58
  /**
56
- * Event status:
57
- *
58
- * - `UPCOMING`: Event is published and scheduled to start.
59
- * - `STARTED`: Event has started.
60
- * - `ENDED`: Event has ended.
61
- * - `CANCELED`: Event is canceled.
62
- * - `DRAFT`: Event is not published.
59
+ * Event status.
63
60
  * @readonly
64
61
  */
65
62
  status?: StatusWithLiterals;
@@ -124,11 +121,7 @@ interface V3Event {
124
121
  agendaSettings?: AgendaSettings;
125
122
  /** Visual settings for event. */
126
123
  eventDisplaySettings?: V3EventDisplaySettings;
127
- /**
128
- * Event description with rich content.
129
- *
130
- * For the event description to appear on your site, connect the [Rich Content Viewer](https://dev.wix.com/docs/velo/velo-only-apis/$w/rich-content-viewer/introduction) element, and assign the description value to the viewer.
131
- */
124
+ /** Event description. <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="emoji,audio,codeBlock,collapsibleList,divider,emoji,file,gallery,giphy,hashtag,heading,html,image,indent,lineSpacing,link,linkPreview,spoiler,video" exampleid="9b569a8d-0fc1-40f4-987f-8bd40ecc72d0">Fallback Message for SSR and Error</widget> */
132
125
  description?: RichContent;
133
126
  /**
134
127
  * Event publish timestamp.
@@ -142,12 +135,7 @@ interface Location {
142
135
  * @maxLength 50
143
136
  */
144
137
  name?: string | null;
145
- /**
146
- * Location type:
147
- *
148
- * - `VENUE`: The event is on-site at a specific physical location.
149
- * - `ONLINE`: The event is online, such as a virtual video conference.
150
- */
138
+ /** Location type. */
151
139
  type?: LocationTypeWithLiterals;
152
140
  /** Exact location address. */
153
141
  address?: CommonAddress;
@@ -269,6 +257,8 @@ interface DateAndTimeSettings {
269
257
  dateAndTimeTbd?: boolean | null;
270
258
  /**
271
259
  * Message that is displayed when time and date is TBD.
260
+ *
261
+ * **Note:** This field is only used when the `dateAndTimeTbd` field value is `true`.
272
262
  * @maxLength 100
273
263
  */
274
264
  dateAndTimeTbdMessage?: string | null;
@@ -296,13 +286,7 @@ interface DateAndTimeSettings {
296
286
  /** Whether the time zone is displayed in the formatted schedule. */
297
287
  showTimeZone?: boolean | null;
298
288
  /**
299
- * Repeating event status. Possible values:
300
- *
301
- * - `ONE_TIME`: The event happens only once and can last multiple days.
302
- * - `RECURRING`: A series of events that repeat.
303
- * - `RECURRING_UPCOMING`: Next event in a schedule of recurring events.
304
- * - `RECURRING_RECENTLY_ENDED`: Latest event that ended in a schedule of recurring events.
305
- * - `RECURRING_RECENTLY_CANCELED`: Latest canceled event tin a schedule of recurring events.
289
+ * Repeating event status.
306
290
  * @readonly
307
291
  */
308
292
  recurrenceStatus?: RecurrenceStatusStatusWithLiterals;
@@ -329,7 +313,7 @@ declare enum RecurrenceStatusStatus {
329
313
  type RecurrenceStatusStatusWithLiterals = RecurrenceStatusStatus | 'UNKNOWN_STATUS' | 'ONE_TIME' | 'RECURRING' | 'RECURRING_UPCOMING' | 'RECURRING_RECENTLY_ENDED' | 'RECURRING_RECENTLY_CANCELED';
330
314
  interface Recurrences {
331
315
  /**
332
- * Individual event dates info.
316
+ * Individual event dates.
333
317
  * @maxSize 1000
334
318
  */
335
319
  individualEventDates?: Occurrence[];
@@ -355,9 +339,8 @@ interface Occurrence {
355
339
  }
356
340
  interface Formatted {
357
341
  /**
358
- * Formatted date and time representation.
359
- *
360
- * Example of formatting when an event lasts multiple days and is in the UTC time zone: `September 1, 2015 at 10:20 AM – September 5, 2015 at 12:14 PM`.
342
+ * Formatted date and time representation. <br>
343
+ * Example of formatting when an event lasts multiple days and is in the UTC time zone: `September 1, 2015 at 10:20 AM – September 5, 2015 at 12:14 PM`. <br>
361
344
  * Example of formatting when an event lasts 1 day and is in the GMT+2 time zone: `February 1, 2018, 12:10 – 2:50 PM GMT+2`.
362
345
  * @readonly
363
346
  * @maxLength 500
@@ -424,27 +407,12 @@ declare enum Status {
424
407
  type StatusWithLiterals = Status | 'UNKNOWN_EVENT_STATUS' | 'UPCOMING' | 'STARTED' | 'ENDED' | 'CANCELED' | 'DRAFT';
425
408
  interface Registration {
426
409
  /**
427
- * Current registration type:
428
- *
429
- * - `RSVP`: Guests register by RSVPing to the event.
430
- * - `TICKETING`: Guests register by buying tickets.
431
- * - `EXTERNAL`: Guests register externally using some other site or platform.
432
- * - `NONE`: No registration is required, all guests can attend. This registration type is for only displaying the event details on a site.
433
- *
434
- * The property value might change to `EXTERNAL` or `NONE` after initial event creation, depending on any additional configuration applied to the event.
410
+ * Current registration type.
435
411
  * @readonly
436
412
  */
437
413
  type?: RegistrationTypeTypeWithLiterals;
438
414
  /**
439
- * Registration status. Possible values:
440
- *
441
- * - `CLOSED_AUTOMATICALLY`: Registration is closed after tickets are sold out.
442
- * - `CLOSED_MANUALLY`: Registration is closed when the `registration.registrationDisabled` property is set to `true`.
443
- * - `OPEN_RSVP`: Guests can start RSVPing to the event.
444
- * - `OPEN_RSVP_WAITLIST_ONLY`: Guest list has reached the maximum, new guests are added to a waitlist.
445
- * - `OPEN_TICKETS`: Guests can buy tickets to the event.
446
- * - `OPEN_EXTERNAL`: Guests register on a different page or web address.
447
- * - `SCHEDULED_RSVP`: Registration via RSVP is scheduled for the future.
415
+ * Registration status.
448
416
  * @readonly
449
417
  */
450
418
  status?: RegistrationStatusStatusWithLiterals;
@@ -454,20 +422,10 @@ interface Registration {
454
422
  tickets?: TicketsRegistration;
455
423
  /** External registration details. */
456
424
  external?: ExternalRegistration;
457
- /**
458
- * Types of guests allowed to register. Possible values:
459
- *
460
- * - `VISITOR_OR_MEMBER`: All site visitors can RSVP to the event.
461
- * - `MEMBER`: Only people who have signed up as members of your site are able to RSVP to the event.
462
- */
425
+ /** Types of guests allowed to register. */
463
426
  allowedGuestTypes?: GuestTypeTypeWithLiterals;
464
427
  /**
465
- * Initial event type which is set when creating an event. Possible values:
466
- *
467
- * - `RSVP`: Guests register by RSVPing to the event.
468
- * - `TICKETING`: Guests register by buying tickets.
469
- *
470
- * This property value never changes.
428
+ * Initial event type which is set when creating an event.
471
429
  * @immutable
472
430
  */
473
431
  initialType?: InitialRegistrationTypeTypeWithLiterals;
@@ -485,13 +443,13 @@ declare enum RegistrationTypeType {
485
443
  TICKETING = "TICKETING",
486
444
  /** Guests register externally using some other site or platform. */
487
445
  EXTERNAL = "EXTERNAL",
488
- /** No registration is required, all guests can attend. This registration type is for only displaying the event details on a site. The property value can be changed from RSVP/TICKETING to EXTERNAL or NONE after the event is created, depending on any additional configurations applied to the event. */
446
+ /** No registration is required, all guests can attend. This registration type is for only displaying the event details on a site. The property value can be changed from `RSVP` or `TICKETING `to `EXTERNAL` or `NONE` after the event is created, depending on any additional configurations applied to the event. */
489
447
  NONE = "NONE"
490
448
  }
491
449
  /** @enumType */
492
450
  type RegistrationTypeTypeWithLiterals = RegistrationTypeType | 'UNKNOWN_REGISTRATION_TYPE' | 'RSVP' | 'TICKETING' | 'EXTERNAL' | 'NONE';
493
451
  declare enum RegistrationStatusStatus {
494
- /** Registration status is not applicable */
452
+ /** Registration status isn't applicable. */
495
453
  UNKNOWN_REGISTRATION_STATUS = "UNKNOWN_REGISTRATION_STATUS",
496
454
  /** Registration is closed after tickets are sold out. */
497
455
  CLOSED_AUTOMATICALLY = "CLOSED_AUTOMATICALLY",
@@ -515,7 +473,7 @@ interface RsvpRegistration {
515
473
  responseType?: ResponseTypeWithLiterals;
516
474
  /** How many guests can RSVP to an event. */
517
475
  limit?: number | null;
518
- /** Whether a waitlist is opened when the total guest limit is reached. If `true`, guests can RSVP to an event and are automatically put in the waitlist with the `IN_WAITLIST` status. */
476
+ /** Whether a waitlist is opened when the total guest limit is reached. If `true`, guests can RSVP to an event and are automatically added to the waitlist with the `IN_WAITLIST` status. */
519
477
  waitlistEnabled?: boolean;
520
478
  /** Registration start date. */
521
479
  startDate?: Date | null;
@@ -536,7 +494,7 @@ interface TicketsRegistration {
536
494
  /** Whether the registration form must be filled out separately for each ticket. */
537
495
  guestsAssignedSeparately?: boolean;
538
496
  /**
539
- * Ticket limit per order.
497
+ * Ticket limit per order. <br>
540
498
  * Default: 20 tickets.
541
499
  * @max 50
542
500
  */
@@ -589,12 +547,7 @@ interface Money {
589
547
  formattedValue?: string | null;
590
548
  }
591
549
  interface TaxSettings {
592
- /**
593
- * Tax application settings:
594
- *
595
- * - `INCLUDED_IN_PRICE`: Deduct the fee from the ticket price for a seller. For example, if you're selling tickets for $10, a ticket service fee of $0.25 is deducted from the price and you'll get $9.75.
596
- * - `ADDED_AT_CHECKOUT`: Show the fee iin addition to the ticket price at checkout and a guest pays the fee. For example, if you sell tickets for $10, a customer sees a ticket service fee of $0.25 and pays $10.25 in total.
597
- */
550
+ /** Tax application settings. */
598
551
  type?: TaxTypeWithLiterals;
599
552
  /**
600
553
  * Tax name.
@@ -603,7 +556,7 @@ interface TaxSettings {
603
556
  */
604
557
  name?: string | null;
605
558
  /**
606
- * Tax rate (for example,`21.55`).
559
+ * Tax rate. For example, `21.55`.
607
560
  * @decimalValue options { gte:0.001, lte:100, maxScale:3 }
608
561
  */
609
562
  rate?: string | null;
@@ -614,9 +567,9 @@ interface TaxSettings {
614
567
  declare enum TaxType {
615
568
  /** Unknown tax type. */
616
569
  UNKNOWN_TAX_TYPE = "UNKNOWN_TAX_TYPE",
617
- /** Deduct the fee from the ticket price for a seller. For example, if you're selling tickets for $10, a ticket ticket service fee of $0.25 is deducted from the price and you'll get $9.75. */
570
+ /** Deduct the fee from the ticket price for a seller. For example, if you're selling tickets for $10, a ticket service fee of $0.25 is deducted from the price and you'll get $9.75. */
618
571
  INCLUDED_IN_PRICE = "INCLUDED_IN_PRICE",
619
- /** Show the fee in addition to the ticket price at checkout and a guest pays the fee. For example, if you sell tickets for $10, a customer sees a ticket ticket service fee of $0.25 and pays $10.25 in total. */
572
+ /** Show the fee in addition to the ticket price at checkout and a guest pays the fee. For example, if you sell tickets for $10, a customer sees a ticket service fee of $0.25 and pays $10.25 in total. */
620
573
  ADDED_AT_CHECKOUT = "ADDED_AT_CHECKOUT"
621
574
  }
622
575
  /** @enumType */
@@ -650,7 +603,7 @@ declare enum InitialRegistrationTypeType {
650
603
  type InitialRegistrationTypeTypeWithLiterals = InitialRegistrationTypeType | 'UNKNOWN_INITIAL_REGISTRATION_TYPE' | 'RSVP' | 'TICKETING';
651
604
  interface CalendarUrls {
652
605
  /**
653
- * "Add to Google calendar" URL.
606
+ * "Add to Google Calendar" URL.
654
607
  * @readonly
655
608
  */
656
609
  google?: string;
@@ -922,7 +875,7 @@ interface TicketsUnavailableMessages {
922
875
  interface Summaries {
923
876
  /** RSVP summary of guests. */
924
877
  rsvps?: Rsvps;
925
- /** Summary of revenue and sold tickets. Archived orders are not included. */
878
+ /** Summary of revenue and sold tickets. Archived orders aren't included. */
926
879
  tickets?: Tickets;
927
880
  }
928
881
  interface EventsMoney {
@@ -933,7 +886,7 @@ interface EventsMoney {
933
886
  */
934
887
  amount?: string;
935
888
  /**
936
- * Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
889
+ * 3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. For example, `USD`.
937
890
  * @format CURRENCY
938
891
  */
939
892
  currency?: string;
@@ -977,7 +930,7 @@ interface Tickets {
977
930
  */
978
931
  revenue?: EventsMoney;
979
932
  /**
980
- * Whether the currency is locked and cant be changed.
933
+ * Whether the currency is locked and can't be changed.
981
934
  * @readonly
982
935
  */
983
936
  currencyLocked?: boolean;
@@ -993,7 +946,7 @@ interface Tickets {
993
946
  totalSales?: EventsMoney;
994
947
  }
995
948
  interface GuestListSettings {
996
- /** Whether the guest list is public for all guests. */
949
+ /** Whether the guest list is displayed publicly to all guests. */
997
950
  displayedPublicly?: boolean;
998
951
  }
999
952
  interface Feed {
@@ -1001,19 +954,14 @@ interface Feed {
1001
954
  token?: string;
1002
955
  }
1003
956
  interface OnlineConferencing {
1004
- /** Whether online conferencing is enabled. Not applicable for events, where date and time are TBD. When enabled, links to join the conference are generated and provided to guests. */
957
+ /** Whether online conferencing is enabled. Not applicable for events where date and time are TBD. When enabled, links to join the conference are generated and provided to guests. */
1005
958
  enabled?: boolean;
1006
959
  /**
1007
960
  * Conference host ID.
1008
961
  * @format GUID
1009
962
  */
1010
963
  providerId?: string | null;
1011
- /**
1012
- * Conference type. Possible values:
1013
- *
1014
- * - `MEETING`: Guests can do some actions during the conference, for example talk, turn on camera and show their screen.
1015
- * - `WEBINAR`: Guests can only watch the conference.
1016
- */
964
+ /** Conference type. */
1017
965
  type?: ConferenceTypeTypeWithLiterals;
1018
966
  /** Online conferencing session information. */
1019
967
  session?: OnlineConferencingSession;
@@ -1064,7 +1012,7 @@ interface SeoSettings {
1064
1012
  /** Advanced SEO data. */
1065
1013
  advancedSeoData?: SeoSchema;
1066
1014
  /**
1067
- * Whether the slug is hidden from the SEO Site Map.
1015
+ * Whether the slug is hidden from the SEO sitemap.
1068
1016
  * @readonly
1069
1017
  */
1070
1018
  hidden?: boolean | null;
@@ -2722,7 +2670,7 @@ interface EventEventStarted {
2722
2670
  * @format GUID
2723
2671
  */
2724
2672
  eventId?: string;
2725
- /** True if at least one guest is registered to the event with any attendance status. */
2673
+ /** Whether at least 1 guest is registered to the event with any attendance status. */
2726
2674
  hasGuests?: boolean | null;
2727
2675
  }
2728
2676
  interface EventEventEnded {
@@ -2733,7 +2681,7 @@ interface EventEventEnded {
2733
2681
  * @format GUID
2734
2682
  */
2735
2683
  eventId?: string;
2736
- /** True if at least one guest is registered to the event with any attendance status. */
2684
+ /** Whether at least 1 guest is registered to the event with any attendance status. */
2737
2685
  hasGuests?: boolean | null;
2738
2686
  }
2739
2687
  interface EventEventReminder {
@@ -2759,9 +2707,9 @@ interface EventEventReminder {
2759
2707
  * @format GUID
2760
2708
  */
2761
2709
  userId?: string | null;
2762
- /** Time until the start of event (currently, reminder letter is triggered 1 day before the start of event). */
2710
+ /** Time until the start of event. By default, the reminder letter is triggered 1 day before the start of event. */
2763
2711
  startsIn?: TimeDuration;
2764
- /** True if at least one guest is registered to the event with any attendance status. */
2712
+ /** Whether at least 1 guest is registered to the event with any attendance status. */
2765
2713
  hasGuests?: boolean | null;
2766
2714
  }
2767
2715
  interface EventEventPublished {
@@ -2843,7 +2791,7 @@ interface EventCloned {
2843
2791
  ticketDefinitions?: Record<string, string>;
2844
2792
  }
2845
2793
  interface EventEventCanceled {
2846
- /** Event cancelation timestamp in ISO UTC format. */
2794
+ /** Event cancellation timestamp in ISO UTC format. */
2847
2795
  timestamp?: Date | null;
2848
2796
  /**
2849
2797
  * Event ID.
@@ -2861,7 +2809,7 @@ interface EventEventCanceled {
2861
2809
  * @format GUID
2862
2810
  */
2863
2811
  userId?: string | null;
2864
- /** True if at least one guest is registered to the event with any attendance status. */
2812
+ /** Whether at least 1 guest is registered to the event with any attendance status. */
2865
2813
  hasGuests?: boolean | null;
2866
2814
  }
2867
2815
  interface CreateEventRequest {
@@ -2913,12 +2861,12 @@ interface CloneEventRequest {
2913
2861
  * @format GUID
2914
2862
  */
2915
2863
  eventId: string;
2916
- /** Field values to be changed when cloning the event. */
2864
+ /** Event info to change in the cloned event. */
2917
2865
  event?: V3Event;
2918
2866
  /** Whether to clone the event as a draft. */
2919
2867
  draft?: boolean;
2920
2868
  /**
2921
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
2869
+ * Predefined sets of fields to return.
2922
2870
  * @maxSize 20
2923
2871
  */
2924
2872
  fields?: RequestedFieldsWithLiterals[];
@@ -2939,7 +2887,7 @@ interface CloneEventFromOtherSiteRequest {
2939
2887
  */
2940
2888
  instanceId?: string | null;
2941
2889
  /**
2942
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
2890
+ * Predefined sets of fields to return.
2943
2891
  * @maxSize 20
2944
2892
  */
2945
2893
  fields?: RequestedFieldsWithLiterals[];
@@ -2949,10 +2897,10 @@ interface CloneEventFromOtherSiteResponse {
2949
2897
  event?: V3Event;
2950
2898
  }
2951
2899
  interface UpdateEventRequest {
2952
- /** Field values to be changed. */
2900
+ /** Event info to update. */
2953
2901
  event?: V3Event;
2954
2902
  /**
2955
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
2903
+ * Predefined sets of fields to return.
2956
2904
  * @maxSize 20
2957
2905
  */
2958
2906
  fields?: RequestedFieldsWithLiterals[];
@@ -2968,7 +2916,7 @@ interface PublishDraftEventRequest {
2968
2916
  */
2969
2917
  eventId: string;
2970
2918
  /**
2971
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
2919
+ * Predefined sets of fields to return.
2972
2920
  * @maxSize 20
2973
2921
  */
2974
2922
  fields?: RequestedFieldsWithLiterals[];
@@ -2984,7 +2932,7 @@ interface CancelEventRequest {
2984
2932
  */
2985
2933
  eventId: string;
2986
2934
  /**
2987
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
2935
+ * Predefined sets of fields to return.
2988
2936
  * @maxSize 20
2989
2937
  */
2990
2938
  fields?: RequestedFieldsWithLiterals[];
@@ -2994,7 +2942,7 @@ interface CancelEventResponse {
2994
2942
  event?: V3Event;
2995
2943
  }
2996
2944
  interface BulkCancelEventsByFilterRequest {
2997
- /** Filter. */
2945
+ /** Filter. For supported filters, see the table in [Query Events](https://dev.wix.com/docs/sdk/backend-modules/events/wix-events-v2/query-events). */
2998
2946
  filter?: CommonQueryV2;
2999
2947
  }
3000
2948
  interface CommonQueryV2 extends CommonQueryV2PagingMethodOneOf {
@@ -3066,13 +3014,13 @@ interface DeleteEventResponse {
3066
3014
  eventId?: string;
3067
3015
  }
3068
3016
  interface BulkDeleteEventsByFilterRequest {
3069
- /** Query options. See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language) for more details. */
3017
+ /** Query options. See [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language) for more details. */
3070
3018
  filter?: CommonQueryV2;
3071
3019
  }
3072
3020
  interface BulkDeleteEventsByFilterResponse {
3073
3021
  }
3074
3022
  interface QueryEventsRequest {
3075
- /** Query options. See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language) for more details. */
3023
+ /** Query options. See [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language) for more details. */
3076
3024
  query?: CommonQueryV2;
3077
3025
  /**
3078
3026
  * Predefined sets of fields to return.
@@ -3110,7 +3058,7 @@ interface CommonCursors {
3110
3058
  prev?: string | null;
3111
3059
  }
3112
3060
  interface ExportEventsRequest {
3113
- /** Query options. See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language) for more details. */
3061
+ /** Query options. See [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language) for more details. */
3114
3062
  query?: QueryV2;
3115
3063
  }
3116
3064
  interface QueryV2 extends QueryV2PagingMethodOneOf {
@@ -3259,12 +3207,12 @@ interface ListUserEventsRequest {
3259
3207
  }
3260
3208
  interface UserFilter {
3261
3209
  /**
3262
- * User who is related to event
3210
+ * User who is related to the event.
3263
3211
  * @format GUID
3264
3212
  */
3265
3213
  userId?: string;
3266
3214
  /**
3267
- * Relation of user to event.
3215
+ * Relation of user to the event.
3268
3216
  * @minSize 1
3269
3217
  * @maxSize 20
3270
3218
  */
@@ -4509,7 +4457,7 @@ interface EventCanceledEnvelope {
4509
4457
  metadata: EventMetadata;
4510
4458
  }
4511
4459
  /**
4512
- * Triggered when event is canceled.
4460
+ * Triggered when an event is canceled.
4513
4461
  * @permissionScope Manage Stores
4514
4462
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4515
4463
  * @permissionScope Read Events - all read permissions
@@ -4549,7 +4497,7 @@ interface EventClonedEnvelope {
4549
4497
  metadata: EventMetadata;
4550
4498
  }
4551
4499
  /**
4552
- * Triggered when event is cloned.
4500
+ * Triggered when an event is cloned.
4553
4501
  * @permissionScope Manage Stores
4554
4502
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4555
4503
  * @permissionScope Read Events - all read permissions
@@ -4589,7 +4537,7 @@ interface EventCreatedEnvelope {
4589
4537
  metadata: EventMetadata;
4590
4538
  }
4591
4539
  /**
4592
- * Triggered when event is created.
4540
+ * Triggered when an event is created.
4593
4541
  * @permissionScope Manage Stores
4594
4542
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4595
4543
  * @permissionScope Read Events - all read permissions
@@ -4628,7 +4576,7 @@ interface EventDeletedEnvelope {
4628
4576
  metadata: EventMetadata;
4629
4577
  }
4630
4578
  /**
4631
- * Triggered when event is deleted.
4579
+ * Triggered when an event is deleted.
4632
4580
  * @permissionScope Manage Stores
4633
4581
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4634
4582
  * @permissionScope Read Events - all read permissions
@@ -4668,7 +4616,7 @@ interface EventEndedEnvelope {
4668
4616
  metadata: EventMetadata;
4669
4617
  }
4670
4618
  /**
4671
- * Triggered when event has ended.
4619
+ * Triggered when an event has ended.
4672
4620
  * @permissionScope Manage Stores
4673
4621
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4674
4622
  * @permissionScope Read Events - all read permissions
@@ -4708,7 +4656,7 @@ interface EventPublishedEnvelope {
4708
4656
  metadata: EventMetadata;
4709
4657
  }
4710
4658
  /**
4711
- * Triggered when event is published.
4659
+ * Triggered when an event is published.
4712
4660
  * @permissionScope Manage Stores
4713
4661
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4714
4662
  * @permissionScope Read Events - all read permissions
@@ -4794,7 +4742,7 @@ interface EventStartedEnvelope {
4794
4742
  metadata: EventMetadata;
4795
4743
  }
4796
4744
  /**
4797
- * Triggered when event has started.
4745
+ * Triggered when an event has started.
4798
4746
  * @permissionScope Manage Stores
4799
4747
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4800
4748
  * @permissionScope Read Events - all read permissions
@@ -4834,7 +4782,7 @@ interface EventUpdatedEnvelope {
4834
4782
  metadata: EventMetadata;
4835
4783
  }
4836
4784
  /**
4837
- * Triggered when event is updated.
4785
+ * Triggered when an event is updated.
4838
4786
  * @permissionScope Manage Stores
4839
4787
  * @permissionScopeId SCOPE.STORES.MANAGE-STORES
4840
4788
  * @permissionScope Read Events - all read permissions
@@ -4871,13 +4819,9 @@ interface EventUpdatedEnvelope {
4871
4819
  declare function onEventUpdated(handler: (event: EventUpdatedEnvelope) => void | Promise<void>): void;
4872
4820
  type EventNonNullablePaths = `_id` | `location.type` | `location.address.streetAddress.number` | `location.address.streetAddress.name` | `dateAndTimeSettings.recurrenceStatus` | `dateAndTimeSettings.recurringEvents.individualEventDates` | `dateAndTimeSettings.recurringEvents.individualEventDates.${number}.showTimeZone` | `slug` | `status` | `registration.type` | `registration.status` | `registration.rsvp.responseType` | `registration.rsvp.waitlistEnabled` | `registration.tickets.guestsAssignedSeparately` | `registration.tickets.ticketLimitPerOrder` | `registration.tickets.lowestPrice.value` | `registration.tickets.lowestPrice.currency` | `registration.tickets.taxSettings.type` | `registration.allowedGuestTypes` | `registration.initialType` | `registration.registrationPaused` | `registration.registrationDisabled` | `calendarUrls.google` | `calendarUrls.ics` | `form.controls` | `form.controls.${number}.type` | `form.controls.${number}.system` | `form.controls.${number}.name` | `form.controls.${number}.label` | `form.controls.${number}.orderIndex` | `form.controls.${number}._id` | `form.messages.rsvp.rsvpYesOption` | `form.messages.rsvp.rsvpNoOption` | `form.messages.rsvp.positiveMessages.title` | `form.messages.rsvp.positiveMessages.confirmation.title` | `form.messages.rsvp.positiveMessages.confirmation.message` | `form.messages.rsvp.positiveMessages.confirmation.addToCalendarActionLabel` | `form.messages.rsvp.positiveMessages.confirmation.shareActionLabel` | `form.messages.rsvp.negativeMessages.title` | `form.messages.rsvp.negativeMessages.confirmation.title` | `form.messages.rsvp.negativeMessages.confirmation.shareActionLabel` | `form.messages.rsvp.submitActionLabel` | `form.messages.checkout.title` | `form.messages.checkout.submitActionLabel` | `form.messages.checkout.confirmation.title` | `form.messages.checkout.confirmation.message` | `form.messages.checkout.confirmation.downloadTicketsLabel` | `form.messages.checkout.confirmation.addToCalendarLabel` | `form.messages.checkout.confirmation.shareEventLabel` | `form.messages.registrationClosed.message` | `form.messages.registrationClosed.exploreEventsActionLabel` | `form.messages.ticketsUnavailable.message` | `form.messages.ticketsUnavailable.exploreEventsActionLabel` | `summaries.rsvps.totalCount` | `summaries.rsvps.yesCount` | `summaries.rsvps.noCount` | `summaries.rsvps.waitlistCount` | `summaries.tickets.ticketsSold` | `summaries.tickets.revenue.amount` | `summaries.tickets.revenue.currency` | `summaries.tickets.currencyLocked` | `summaries.tickets.totalOrders` | `instanceId` | `guestListSettings.displayedPublicly` | `userId` | `onlineConferencing.enabled` | `onlineConferencing.type` | `onlineConferencing.session.hostLink` | `onlineConferencing.session.guestLink` | `seoSettings.slug` | `seoSettings.advancedSeoData.tags` | `seoSettings.advancedSeoData.tags.${number}.type` | `seoSettings.advancedSeoData.tags.${number}.children` | `seoSettings.advancedSeoData.tags.${number}.custom` | `seoSettings.advancedSeoData.tags.${number}.disabled` | `seoSettings.advancedSeoData.settings.preventAutoRedirect` | `seoSettings.advancedSeoData.settings.keywords` | `seoSettings.advancedSeoData.settings.keywords.${number}.term` | `seoSettings.advancedSeoData.settings.keywords.${number}.isMain` | `agendaSettings.enabled`;
4873
4821
  /**
4874
- * Creates an event.
4875
- *
4876
- *
4877
- * The event includes a default registration form in the selected language, which consists of input fields for first name, last name, and email. See [Registration Form](https://www.wix.com/velo/reference/wix-events-v2/forms/introduction) for more information.
4878
- *
4879
- * You can create the event as a draft by setting the draft value to true. Otherwise, the event is published right away.
4880
- *
4822
+ * Creates an event. <br> <br>
4823
+ * The event includes a default registration form in the selected language, which consists of input fields for first name, last name, and email. See the Registration Form API ([SDK](https://dev.wix.com/docs/sdk/backend-modules/events/forms/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/events/form/about-the-registration-form-api)) for more information. <br> <br>
4824
+ * You can create the event as a draft by setting `draft` to `true`. Otherwise, the event is published right away. <br> <br>
4881
4825
  * The event is automatically set up to send daily summary reports of new guests to your business email.
4882
4826
  * @param event - Event data.
4883
4827
  * @public
@@ -4906,11 +4850,10 @@ interface CreateEventOptions {
4906
4850
  fields?: RequestedFieldsWithLiterals[];
4907
4851
  }
4908
4852
  /**
4909
- * Clones an event, including the registration form, notifications, multilingual translations and ticket configuration from the original event.
4910
- *
4911
- *
4912
- * The new event's date is automatically set to 14 days from the original event date.
4913
- * If an event with the same title already exists, the new event's title gets a sequence number. For example, if you clone an event named "Leather Crafting 101", the new event's title is "Leather Crafting 101 (1)". You can change the required entity field values while cloning an event.
4853
+ * Clones an event, including the registration form, notifications, multilingual translations and ticket configuration from the original event. <br> <br>
4854
+ * The new event's date is automatically set to 14 days from the original event date. <br> <br>
4855
+ * If an event with the same `title` already exists, the new event's `title` gets a sequence number. For example, if you clone an event named `"Leather Crafting 101"`, the new event's title is `"Leather Crafting 101 (1)"`. <br> <br>
4856
+ * You can change the required entity field values while cloning an event.
4914
4857
  * @param eventId - Event ID.
4915
4858
  * @public
4916
4859
  * @requiredField eventId
@@ -4923,12 +4866,12 @@ declare function cloneEvent(eventId: string, options?: CloneEventOptions): Promi
4923
4866
  [P in EventNonNullablePaths]: `event.${P}`;
4924
4867
  }[EventNonNullablePaths]>>;
4925
4868
  interface CloneEventOptions {
4926
- /** Field values to be changed when cloning the event. */
4869
+ /** Event info to change in the cloned event. */
4927
4870
  event?: V3Event;
4928
4871
  /** Whether to clone the event as a draft. */
4929
4872
  draft?: boolean;
4930
4873
  /**
4931
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
4874
+ * Predefined sets of fields to return.
4932
4875
  * @maxSize 20
4933
4876
  */
4934
4877
  fields?: RequestedFieldsWithLiterals[];
@@ -4949,7 +4892,6 @@ declare function updateEvent(_id: string, options?: UpdateEventOptions): Promise
4949
4892
  __validationErrorsType?: UpdateEventValidationErrors;
4950
4893
  }>;
4951
4894
  interface UpdateEventOptions {
4952
- /** Event to update. */
4953
4895
  event: {
4954
4896
  /**
4955
4897
  * Event ID.
@@ -4969,11 +4911,14 @@ interface UpdateEventOptions {
4969
4911
  title?: string | null;
4970
4912
  /**
4971
4913
  * Short description that appears under the event title.
4914
+ * **Note:** This field is returned only when the `DETAILS` fieldset is included in the request.
4972
4915
  * @maxLength 500
4973
4916
  */
4974
4917
  shortDescription?: string | null;
4975
4918
  /**
4976
- * Detailed description of an event. You can enter the description using rich text format (add various types of markups, such as underlines, italics, bolding, color codes, bullet lists, and links by using HTML formatting tags).
4919
+ * Detailed description of an event.
4920
+ *
4921
+ * This field is deprecated.
4977
4922
  * @maxLength 50000
4978
4923
  * @deprecated Detailed description of an event.
4979
4924
  *
@@ -5003,13 +4948,7 @@ interface UpdateEventOptions {
5003
4948
  */
5004
4949
  _updatedDate?: Date | null;
5005
4950
  /**
5006
- * Event status. Possible values:
5007
- *
5008
- * - `UPCOMING`: The event is published and scheduled to start.
5009
- * - `STARTED`: The event has started.
5010
- * - `ENDED`: The event has ended.
5011
- * - `CANCELED`: The event is canceled.
5012
- * - `DRAFT`: The event is not published.
4951
+ * Event status.
5013
4952
  * @readonly
5014
4953
  */
5015
4954
  status?: StatusWithLiterals;
@@ -5074,11 +5013,7 @@ interface UpdateEventOptions {
5074
5013
  agendaSettings?: AgendaSettings;
5075
5014
  /** Visual settings for event. */
5076
5015
  eventDisplaySettings?: V3EventDisplaySettings;
5077
- /**
5078
- * Event description with rich content.
5079
- *
5080
- * For the event description to appear on your site, connect the [Rich Content Viewer](https://dev.wix.com/docs/velo/velo-only-apis/$w/rich-content-viewer/introduction) element, and assign the description value to the viewer.
5081
- */
5016
+ /** Event description. <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="emoji,audio,codeBlock,collapsibleList,divider,emoji,file,gallery,giphy,hashtag,heading,html,image,indent,lineSpacing,link,linkPreview,spoiler,video" exampleid="9b569a8d-0fc1-40f4-987f-8bd40ecc72d0">Fallback Message for SSR and Error</widget> */
5082
5017
  description?: RichContent;
5083
5018
  /**
5084
5019
  * Event publish timestamp.
@@ -5087,16 +5022,14 @@ interface UpdateEventOptions {
5087
5022
  publishedDate?: Date | null;
5088
5023
  };
5089
5024
  /**
5090
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
5025
+ * Predefined sets of fields to return.
5091
5026
  * @maxSize 20
5092
5027
  */
5093
5028
  fields?: RequestedFieldsWithLiterals[];
5094
5029
  }
5095
5030
  /**
5096
- * Publishes a draft event to your live site. Once published, the event's status changes from `DRAFT` to `UPCOMING.`
5097
- *
5098
- *
5099
- * It's impossible to revert the `DRAFT` status after publishing. The only option is to clone the event, and then delete the original one.
5031
+ * Publishes a draft event to your live site. Once published, the event's status changes from `"DRAFT"` to `"UPCOMING"`. <br> <br>
5032
+ * It's impossible to revert the `"DRAFT"` status after publishing. The only option is to clone the event, then delete the original.
5100
5033
  * @param eventId - Event ID.
5101
5034
  * @public
5102
5035
  * @requiredField eventId
@@ -5112,16 +5045,14 @@ declare function publishDraftEvent(eventId: string, options?: PublishDraftEventO
5112
5045
  }>;
5113
5046
  interface PublishDraftEventOptions {
5114
5047
  /**
5115
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
5048
+ * Predefined sets of fields to return.
5116
5049
  * @maxSize 20
5117
5050
  */
5118
5051
  fields?: RequestedFieldsWithLiterals[];
5119
5052
  }
5120
5053
  /**
5121
- * Cancels an event.
5122
- *
5123
- *
5124
- * After cancellation, registration for an event is closed. To reuse the event, [clone](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/cloneevent) and [publish](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/publishdraftevent) it again.
5054
+ * Cancels an event. <br> <br>
5055
+ * After cancellation, registration for an event is closed. To reuse the event, call Clone Event and Publish Event to publish it again. <br> <br>
5125
5056
  * If event cancellation notifications are enabled, canceling an event automatically triggers the sending of cancellation emails and/or push notifications to registered guests.
5126
5057
  * @param eventId - Event ID.
5127
5058
  * @public
@@ -5138,16 +5069,14 @@ declare function cancelEvent(eventId: string, options?: CancelEventOptions): Pro
5138
5069
  }>;
5139
5070
  interface CancelEventOptions {
5140
5071
  /**
5141
- * Predefined sets of fields to return. If both `fields` and `fieldsets` are sent in the request, the union of both lists is returned.
5072
+ * Predefined sets of fields to return.
5142
5073
  * @maxSize 20
5143
5074
  */
5144
5075
  fields?: RequestedFieldsWithLiterals[];
5145
5076
  }
5146
5077
  /**
5147
- * Cancels multiple events that meet the given criteria.
5148
- *
5149
- *
5150
- * After cancellation, registration for an event is closed. To reuse the event, [clone](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/cloneevent) and [publish](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/publishdraftevent) it again.
5078
+ * Cancels multiple events that meet the specified criteria. <br> <br>
5079
+ * After cancellation, registration for an event is closed. To reuse the event, call Clone Event and Publish Event to publish it again. <br> <br>
5151
5080
  * If event cancellation notifications are enabled, canceling an event automatically triggers the sending of cancellation emails and/or push notifications to registered guests.
5152
5081
  * @public
5153
5082
  * @requiredField options.filter.filter
@@ -5158,11 +5087,11 @@ interface CancelEventOptions {
5158
5087
  */
5159
5088
  declare function bulkCancelEventsByFilter(options?: NonNullablePaths<BulkCancelEventsByFilterOptions, `filter.filter`>): Promise<void>;
5160
5089
  interface BulkCancelEventsByFilterOptions {
5161
- /** Filter. */
5090
+ /** Filter.For supported filters, see the table in [Query Events](https://dev.wix.com/docs/sdk/backend-modules/events/wix-events-v2/query-events). */
5162
5091
  filter?: CommonQueryV2;
5163
5092
  }
5164
5093
  /**
5165
- * Permanently deletes an event. <br> <br>
5094
+ * Deletes an event. <br> <br>
5166
5095
  * You can retrieve the deleted event through a GDPR access request.
5167
5096
  * @param eventId - Event ID.
5168
5097
  * @public
@@ -5173,9 +5102,7 @@ interface BulkCancelEventsByFilterOptions {
5173
5102
  */
5174
5103
  declare function deleteEvent(eventId: string): Promise<NonNullablePaths<DeleteEventResponse, `eventId`>>;
5175
5104
  /**
5176
- * Permanently deletes multiple events that meet the given criteria.
5177
- *
5178
- *
5105
+ * Deletes multiple events that meet the specified criteria. <br> <br>
5179
5106
  * You can retrieve the deleted events through a GDPR access request.
5180
5107
  * @public
5181
5108
  * @requiredField options.filter.filter
@@ -5186,18 +5113,18 @@ declare function deleteEvent(eventId: string): Promise<NonNullablePaths<DeleteEv
5186
5113
  */
5187
5114
  declare function bulkDeleteEventsByFilter(options?: NonNullablePaths<BulkDeleteEventsByFilterOptions, `filter.filter`>): Promise<void>;
5188
5115
  interface BulkDeleteEventsByFilterOptions {
5189
- /** Query options. See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language) for more details. */
5116
+ /** Query options. See [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language) for more details. */
5190
5117
  filter?: CommonQueryV2;
5191
5118
  }
5192
5119
  /**
5193
5120
  * Creates a query to retrieve a list of events.
5194
5121
  *
5195
5122
  *
5196
- * The `queryEvents()` function builds a query to retrieve a list of events and returns a [`EventsQueryBuilder`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder) object.
5123
+ * The `queryEvents()` method builds a query to retrieve a list of events and returns a [`EventsQueryBuilder`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder) object.
5197
5124
  *
5198
- * The returned object contains the query definition, which is typically used to run the query using the [`find()`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder/find) function.
5125
+ * The returned object contains the query definition, which is typically used to run the query using the [`find()`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder/find) method.
5199
5126
  *
5200
- * You can refine the query by chaining `EventsQueryBuilder` functions onto the query. `EventsQueryBuilder` functions enable you to sort, filter, and control the results `queryEvents()` returns.
5127
+ * You can refine the query by chaining `EventsQueryBuilder` methods onto the query. `EventsQueryBuilder` methods enable you to sort, filter, and control the results `queryEvents()` returns.
5201
5128
  *
5202
5129
  * `queryEvents()` runs with these `EventsQueryBuilder` defaults, which you can override:
5203
5130
  *
@@ -5205,7 +5132,7 @@ interface BulkDeleteEventsByFilterOptions {
5205
5132
  * - [`limit(50)`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder/limit)
5206
5133
  * - [`descending("_createdDate")`](https://www.wix.com/velo/reference/wix-events-v2/wixeventsv2/eventsquerybuilder/descending)
5207
5134
  *
5208
- * The functions that are chained to `queryEvents()` are applied in the order they're called. For example, if you apply `ascending('title')` and then `descending('status')`, the results are sorted first by the `title`, and then, if there are multiple results with the same `title`, the items are sorted by `status`.
5135
+ * The methods that are chained to `queryEvents()` are applied in the order they're called. For example, if you apply `ascending('title')` and then `descending('status')`, the results are sorted first by the `title`, and then, if there are multiple results with the same `title`, the items are sorted by `status`.
5209
5136
  * @public
5210
5137
  * @param options - Optional fields.
5211
5138
  * @permissionId WIX_EVENTS.READ_EVENTS
@@ -5325,10 +5252,9 @@ interface GetEventOptions {
5325
5252
  fields?: RequestedFieldsWithLiterals[];
5326
5253
  }
5327
5254
  /**
5328
- * Retrieves an event by the `slug` URL.
5329
- *
5255
+ * Retrieves an event by the slug URL.
5330
5256
  *
5331
- * The slug is the end of an event URL that refers to a specific event. For example, if an events' URL is `https://example.com/events/event/{my-event-slug}`, the slug is `my-event-slug`.
5257
+ * The slug is the end of an event URL that refers to a specific event. For example, if an event's URL is `https://example.com/events/event/{my-event-slug}`, the slug is `my-event-slug`.
5332
5258
  * @param slug - URL slug.
5333
5259
  * @public
5334
5260
  * @requiredField slug