@wix/calendar 1.0.56 → 1.0.58

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,4428 +0,0 @@
1
- /**
2
- * An event is a scheduled entry on a calendar that includes details like timing,
3
- * location, and participants. Each event is associated with
4
- * a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
5
- * from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
6
- * Events can either be standalone, part of a recurring series, or define a
7
- * recurrence pattern. You can also specify whether events block time on the
8
- * schedule or allow other events to be scheduled concurrently.
9
- */
10
- interface Event$1 {
11
- /**
12
- * Event ID.
13
- * @readonly
14
- */
15
- id?: string | null;
16
- /**
17
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
18
- * the event belongs to.
19
- * After creating an event, you can't assign it to a different schedule.
20
- */
21
- scheduleId?: string | null;
22
- /**
23
- * ID of the external schedule the event belongs to.
24
- *
25
- * For example, if the event belongs to a Bookings staff member, identical to
26
- * the ID of the [resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
27
- * If the schedule belongs to a Bookings service,
28
- * identical to the ID of the [service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object).
29
- * @readonly
30
- */
31
- externalScheduleId?: string | null;
32
- /**
33
- * Schedule name.
34
- * @readonly
35
- */
36
- scheduleName?: string | null;
37
- /**
38
- * Event type. You can set the event type but you can't update it.
39
- *
40
- * Supported values:
41
- * + `DEFAULT`: A standard event that's not further specified.
42
- * + `WORKING_HOURS`: The event adds working hours to a schedule. By default not returned in [Query Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/query-events).
43
- *
44
- * Additional supported values, if Wix Bookings is installed:
45
- * + `APPOINTMENT`: Bookings appointment event.
46
- * + `CLASS`: Bookings class event.
47
- * + `COURSE`: Bookings course event.
48
- */
49
- type?: string | null;
50
- /**
51
- * Event status.
52
- *
53
- * Supported values:
54
- * + `CONFIRMED`: Event is scheduled to happen or has happened.
55
- * + `CANCELLED`: Event has been canceled.
56
- *
57
- * Default: `CONFIRMED`
58
- * @readonly
59
- */
60
- status?: Status$7;
61
- /**
62
- * Event title.
63
- *
64
- * Min: 1 character
65
- * Max: 200 characters
66
- */
67
- title?: string | null;
68
- /** Information about when the event starts. */
69
- start?: ZonedDate$3;
70
- /**
71
- * Information about when the event ends.
72
- *
73
- * Maximum allowed date: Year 2100, or up to 100 years from the event's start date (whichever comes first).
74
- */
75
- end?: ZonedDate$3;
76
- /**
77
- * Information about when the event starts adjusted to the `timeZone` of the
78
- * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
79
- * or a different `timeZone` you provide in the call's request.
80
- * @readonly
81
- */
82
- adjustedStart?: ZonedDate$3;
83
- /**
84
- * Information about when the event ends adjusted to the `timeZone` of the
85
- * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
86
- * or a different `timeZone` you provide in the call's request.
87
- * @readonly
88
- */
89
- adjustedEnd?: ZonedDate$3;
90
- /**
91
- * Time zone the event is associated with in
92
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
93
- * Only regional time zones and UTC are supported.
94
- * For example, `America/New_York` or `UTC`.
95
- *
96
- * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
97
- */
98
- timeZone?: string | null;
99
- /**
100
- * Information about whether the event is a single occurrence or part of a
101
- * recurring series.
102
- *
103
- * Supported values:
104
- * + `NONE`: The event occurs only once and doesn't repeat.
105
- * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
106
- * + `INSTANCE`: A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`.
107
- * + `EXCEPTION`: A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event.
108
- *
109
- * Default: `NONE`
110
- * @readonly
111
- */
112
- recurrenceType?: RecurrenceType$1;
113
- /**
114
- * Recurrence pattern for a series of events. This field is required when
115
- * creating a `MASTER` event and isn't available for non-recurring events.
116
- * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
117
- *
118
- * For example, an event that repeats every second Monday until January 7, 2026,
119
- * at 8:00 AM has the following `recurrenceRule`:
120
- * - `frequency = WEEKLY`
121
- * - `interval = 2`
122
- * - `days = [MONDAY]`
123
- * - `until = 20260107T08:00:00Z`
124
- */
125
- recurrenceRule?: RecurrenceRule$1;
126
- /**
127
- * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
128
- * and `EXCEPTION` events.
129
- * @readonly
130
- */
131
- recurringEventId?: string | null;
132
- /**
133
- * Specifies whether the event blocks time in the schedule it belongs to.
134
- *
135
- * Supported values:
136
- * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same entities (for example, Booking staff members) from being scheduled at the same time.
137
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
138
- *
139
- * Default: `OPAQUE`
140
- */
141
- transparency?: Transparency$1;
142
- /**
143
- * Event location.
144
- *
145
- * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
146
- */
147
- location?: Location$3;
148
- /**
149
- * List of [Wix Bookings resources](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object)
150
- * affected by the event. This could include, for example, the
151
- * [Wix Bookings staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/staff-member-object)
152
- * providing the service or the room where the appointment takes place.
153
- *
154
- * Max: 100 resources
155
- */
156
- resources?: Resource$1[];
157
- /**
158
- * Maximum number of participants who can participate in the event.
159
- *
160
- * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
161
- */
162
- totalCapacity?: number | null;
163
- /**
164
- * Number of participants who can still be added to the event.
165
- * @readonly
166
- */
167
- remainingCapacity?: number | null;
168
- /**
169
- * Information about the event's participants.
170
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
171
- * @readonly
172
- */
173
- participants?: Participants$1;
174
- /**
175
- * Information about the event's online conferencing.
176
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
177
- *
178
- * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
179
- */
180
- conferencingDetails?: ConferencingDetails$3;
181
- /**
182
- * Additional notes about the event.
183
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
184
- *
185
- * Min: 1 character
186
- * Max: 5000 characters
187
- */
188
- notes?: string | null;
189
- /**
190
- * List of fields whose values are inherited.
191
- * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
192
- * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related `MASTER` event.
193
- * @readonly
194
- */
195
- inheritedFields?: Field$1[];
196
- /**
197
- * ID of the app that owns the event. Identical to `appId` of the
198
- * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
199
- * to which the event belongs.
200
- * @readonly
201
- */
202
- appId?: string | null;
203
- /**
204
- * List of permissions associated with the event. Refer to the
205
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
206
- * for more information.
207
- * @readonly
208
- */
209
- permissions?: Permission$3[];
210
- /** Extensions enabling applications or users to save custom data related to the event. */
211
- extendedFields?: ExtendedFields$5;
212
- /**
213
- * Revision number, which increments each time the event is updated.
214
- * To prevent conflicting changes, the current revision must be passed when updating the event.
215
- * Ignored when creating an event.
216
- * @readonly
217
- */
218
- revision?: string | null;
219
- /**
220
- * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
221
- * @readonly
222
- */
223
- createdDate?: Date | null;
224
- /**
225
- * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
226
- * @readonly
227
- */
228
- updatedDate?: Date | null;
229
- }
230
- declare enum Status$7 {
231
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
232
- /** Event is scheduled to happen or has happened. */
233
- CONFIRMED = "CONFIRMED",
234
- /** DEPRECATED! AND WILL BE REMOVED SOON */
235
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION",
236
- /** Event has been canceled. */
237
- CANCELLED = "CANCELLED"
238
- }
239
- /** A date time with a time zone, having the UTC offset and date determined by the server. */
240
- interface ZonedDate$3 {
241
- /**
242
- * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
243
- * For example, `2024-01-30T13:30:00`.
244
- * Wix Calendar APIs ignore seconds.
245
- */
246
- localDate?: string | null;
247
- /**
248
- * Time zone in
249
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
250
- * For example, `America/New_York`.
251
- * @readonly
252
- */
253
- timeZone?: string | null;
254
- /**
255
- * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
256
- * For example, `2024-01-30T13:30:00`.
257
- * Not available for adjusted date fields.
258
- * @readonly
259
- */
260
- utcDate?: Date | null;
261
- }
262
- declare enum RecurrenceType$1 {
263
- UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
264
- /** The event occurs only once and doesn't repeat. */
265
- NONE = "NONE",
266
- /** Defines the recurrence pattern for a series of recurring events. */
267
- MASTER = "MASTER",
268
- /** A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`. */
269
- INSTANCE = "INSTANCE",
270
- /** A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event. */
271
- EXCEPTION = "EXCEPTION"
272
- }
273
- interface RecurrenceRule$1 {
274
- /**
275
- * Frequency how often the event repeats. Works together with `interval`.
276
- *
277
- * Supported values:
278
- * + `WEEKLY`: The event's recurrence pattern is based on weeks.
279
- */
280
- frequency?: Frequency$1;
281
- /**
282
- * Interval how often the event repeats. Works together with `frequency`.
283
- * For example, `frequency` set to `WEEKLY` and `interval` set to `2` means
284
- * the event repeats every 2 weeks.
285
- *
286
- * Min: `1`
287
- * Max: `4`
288
- * Default: `1`
289
- */
290
- interval?: number | null;
291
- /**
292
- * Days of the week when the recurring event takes place.
293
- * Currently, only a single day is supported.
294
- *
295
- * Min: 1 day
296
- * Max: 1 day
297
- */
298
- days?: Day$1[];
299
- /**
300
- * Date until when the event repeats.
301
- * If not specified, the event repeats forever.
302
- */
303
- until?: ZonedDate$3;
304
- /**
305
- * Date until when the event repeats
306
- * adjusted to the `timeZone` of the business
307
- * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
308
- * or a different `timeZone` you provide in the call's request.
309
- * @readonly
310
- */
311
- adjustedUntil?: ZonedDate$3;
312
- }
313
- declare enum Frequency$1 {
314
- UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
315
- /** The event's recurrence pattern is based on weeks. */
316
- WEEKLY = "WEEKLY"
317
- }
318
- declare enum Day$1 {
319
- /** The recurring event takes place on Mondays. */
320
- MONDAY = "MONDAY",
321
- /** The recurring event takes place on Tuesdays. */
322
- TUESDAY = "TUESDAY",
323
- /** The recurring event takes place on Wednesday. */
324
- WEDNESDAY = "WEDNESDAY",
325
- /** The recurring event takes place on Thursdays. */
326
- THURSDAY = "THURSDAY",
327
- /** The recurring event takes place on Fridays. */
328
- FRIDAY = "FRIDAY",
329
- /** The recurring event takes place on Saturdays. */
330
- SATURDAY = "SATURDAY",
331
- /** The recurring event takes place on Sundays. */
332
- SUNDAY = "SUNDAY"
333
- }
334
- declare enum Transparency$1 {
335
- UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
336
- /** The schedule is blocked during the event, preventing other events that involve the same entities (for example, Booking staff members) from being scheduled at the same time. */
337
- OPAQUE = "OPAQUE",
338
- /** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
339
- TRANSPARENT = "TRANSPARENT"
340
- }
341
- interface Location$3 {
342
- /**
343
- * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
344
- * ID. Available only for `BUSINESS` locations.
345
- */
346
- id?: string | null;
347
- /**
348
- * Location type.
349
- *
350
- * Supported values:
351
- * + `BUSINESS`: The event is held at a business location.
352
- * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
353
- * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
354
- */
355
- type?: LocationType$3;
356
- /**
357
- * Location name. For `BUSINESS` locations, it's identical to the
358
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
359
- * `name`.
360
- *
361
- * Min: 1 character
362
- * Max: 150 characters
363
- */
364
- name?: string | null;
365
- /**
366
- * Location address. For `BUSINESS` locations, it's identical to the
367
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
368
- * `formattedAddress`.
369
- */
370
- address?: string | null;
371
- }
372
- declare enum LocationType$3 {
373
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
374
- /** The event is held at a business location. */
375
- BUSINESS = "BUSINESS",
376
- /** The event is held at the customer's location, such as their home or office. */
377
- CUSTOMER = "CUSTOMER",
378
- /** The event is held at an address or venue not tied to the business or customer. */
379
- CUSTOM = "CUSTOM"
380
- }
381
- interface Resource$1 {
382
- /** Resource ID. */
383
- id?: string | null;
384
- /**
385
- * Resource name.
386
- * @readonly
387
- */
388
- name?: string | null;
389
- /**
390
- * Resource type.
391
- * @readonly
392
- */
393
- type?: string | null;
394
- /**
395
- * Specifies whether the event blocks time in the resource's schedule.
396
- *
397
- * Supported values:
398
- * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
399
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
400
- *
401
- * Default: `OPAQUE`.
402
- */
403
- transparency?: Transparency$1;
404
- /**
405
- * Permission role associated with the resource. Refer to the
406
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
407
- * for more information.
408
- */
409
- permissionRole?: Role$3;
410
- }
411
- declare enum Role$3 {
412
- UNKNOWN_ROLE = "UNKNOWN_ROLE",
413
- /** Full read and write access. */
414
- WRITER = "WRITER",
415
- /** Full read access, write access limited to `event.notes`. */
416
- COMMENTER = "COMMENTER"
417
- }
418
- interface Participants$1 {
419
- /**
420
- * Total number of participants.
421
- *
422
- * Min: `0`
423
- */
424
- total?: number | null;
425
- /**
426
- * Full or partial list of the participants.
427
- *
428
- * Max: 50 participants
429
- */
430
- list?: Participant$3[];
431
- /**
432
- * Whether there are more participants for the event than listed.
433
- *
434
- * + `false`: The list includes all participants.
435
- * + `true`: The list doesn't include all participants.
436
- */
437
- hasMore?: boolean | null;
438
- /**
439
- * Participant's status.
440
- *
441
- * Supported values:
442
- * + `CONFIRMED`: All participants are confirmed.
443
- * + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
444
- */
445
- status?: ParticipantsStatus$1;
446
- }
447
- interface Participant$3 {
448
- /**
449
- * Participant name.
450
- *
451
- * Min: 1 character
452
- * Max: 200 characters
453
- */
454
- name?: string | null;
455
- /** Participant's phone number. */
456
- phone?: string | null;
457
- /** Participant's email address. */
458
- email?: string | null;
459
- /**
460
- * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
461
- * ID of the participant.
462
- */
463
- contactId?: string | null;
464
- }
465
- declare enum ParticipantsStatus$1 {
466
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
467
- /** All participants are confirmed. */
468
- CONFIRMED = "CONFIRMED",
469
- /** At least one participant isn't confirmed yet. */
470
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
471
- }
472
- interface ConferencingDetails$3 {
473
- /** Conference type. For example, `Zoom`. */
474
- type?: Type$3;
475
- /**
476
- * URL used by the host to start the conference.
477
- *
478
- * Min: 1 character
479
- * Max: 2000 characters
480
- */
481
- hostUrl?: string | null;
482
- /**
483
- * URL used by a guest to join the conference.
484
- *
485
- * Min: 1 character
486
- * Max: 2000 characters
487
- */
488
- guestUrl?: string | null;
489
- /**
490
- * Conference password.
491
- *
492
- * Min: 1 character
493
- * Max: 100 characters
494
- */
495
- password?: string | null;
496
- /**
497
- * Conference ID in an external system.
498
- *
499
- * Min: 1 character
500
- * Max: 150 characters
501
- */
502
- externalId?: string | null;
503
- }
504
- declare enum Type$3 {
505
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
506
- ZOOM = "ZOOM",
507
- CUSTOM = "CUSTOM"
508
- }
509
- declare enum Field$1 {
510
- UNKNOWN_FIELD = "UNKNOWN_FIELD",
511
- /** `title` is inherited from the schedule or `MASTER` event. */
512
- TITLE = "TITLE",
513
- /** `timeZone` is inherited from the schedule or `MASTER` event. */
514
- TIME_ZONE = "TIME_ZONE",
515
- /** `start` and `end` are inherited from the `MASTER` event. */
516
- TIME = "TIME",
517
- /** `location` is inherited from the schedule or `MASTER` event. */
518
- LOCATION = "LOCATION",
519
- /** `resources` is inherited from the `MASTER` event. */
520
- RESOURCES = "RESOURCES",
521
- /** `capacity` is inherited from the schedule or `MASTER` event. */
522
- CAPACITY = "CAPACITY",
523
- /** `participants` is inherited from the `MASTER` event. */
524
- PARTICIPANTS = "PARTICIPANTS",
525
- /** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
526
- CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
527
- }
528
- interface Permission$3 {
529
- /**
530
- * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
531
- * granted the permission.
532
- */
533
- identity?: CommonIdentificationData$3;
534
- /**
535
- * Permission role.
536
- *
537
- * Supported values:
538
- * + `WRITER`: Full read and write access.
539
- * + `COMMENTER`: Full read access, write access limited to `event.notes`.
540
- */
541
- role?: Role$3;
542
- }
543
- interface CommonIdentificationData$3 extends CommonIdentificationDataIdOneOf$3 {
544
- /**
545
- * ID of a Wix user. For example, the site owner or a
546
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
547
- */
548
- wixUserId?: string;
549
- }
550
- /** @oneof */
551
- interface CommonIdentificationDataIdOneOf$3 {
552
- /**
553
- * ID of a Wix user. For example, the site owner or a
554
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
555
- */
556
- wixUserId?: string;
557
- }
558
- declare enum IdentityType$3 {
559
- UNKNOWN = "UNKNOWN",
560
- WIX_USER = "WIX_USER"
561
- }
562
- interface ExtendedFields$5 {
563
- /**
564
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
565
- * The value of each key is structured according to the schema defined when the extended fields were configured.
566
- *
567
- * You can only access fields for which you have the appropriate permissions.
568
- *
569
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
570
- */
571
- namespaces?: Record<string, Record<string, any>>;
572
- }
573
- interface ListEventsByContactIdRequest$1 {
574
- /**
575
- * ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
576
- * to retrieve events for. Required, unless you provide `cursorPaging`.
577
- */
578
- contactId: string | null;
579
- /**
580
- * Local start date and time from which events are returned in
581
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
582
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
583
- *
584
- * Events that start before the `fromLocalDate` but end after it are included in
585
- * the results. Must be earlier than `toLocalDate`.
586
- */
587
- fromLocalDate?: string | null;
588
- /**
589
- * Local end date and time up to which events are returned in
590
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
591
- * `2024-01-30T13:30:00`. Can't be more than a full year after
592
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
593
- *
594
- * Events that start before `toLocalDate` but end after it are included in the
595
- * results. Must be later than `fromLocalDate`.
596
- */
597
- toLocalDate?: string | null;
598
- /**
599
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
600
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
601
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
602
- *
603
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
604
- */
605
- timeZone?: string | null;
606
- /**
607
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
608
- * to filter events by.
609
- */
610
- appId?: string | null;
611
- /** Cursor to retrieve the next page of the results. */
612
- cursorPaging?: CommonCursorPaging$1;
613
- }
614
- /** TODO Diverge */
615
- interface CommonCursorPaging$1 {
616
- /**
617
- * Number of events to return.
618
- * Defaults to `50`. Maximum `100`.
619
- */
620
- limit?: number | null;
621
- /**
622
- * Pointer to the next or previous page in the list of results.
623
- *
624
- * You can get the relevant cursor token
625
- * from the `pagingMetadata` object in the previous call's response.
626
- * Not relevant for the first request.
627
- */
628
- cursor?: string | null;
629
- }
630
- interface ListEventsByContactIdResponse$1 {
631
- /** Retrieved events. */
632
- events?: Event$1[];
633
- /** Paging metadata. */
634
- pagingMetadata?: CommonCursorPagingMetadata$1;
635
- }
636
- /** TODO Diverge */
637
- interface CommonCursorPagingMetadata$1 {
638
- /** Number of items returned in the response. */
639
- count?: number | null;
640
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
641
- cursors?: CommonCursors$1;
642
- /**
643
- * Indicates if there are more results after the current page.
644
- * If `true`, another page of results can be retrieved.
645
- * If `false`, this is the last page.
646
- */
647
- hasNext?: boolean | null;
648
- }
649
- interface CommonCursors$1 {
650
- /** Cursor pointing to next page in the list of results. */
651
- next?: string | null;
652
- }
653
- interface ListEventsByMemberIdRequest$1 {
654
- /**
655
- * ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
656
- * to retrieve events for. Required, unless you provide `cursorPaging`.
657
- * Provide `me` to retrieve events for the currently logged-in member.
658
- * You must have the `Read Calendars - Including PI`
659
- * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
660
- * to retrieve events for members who aren't the currently logged in member.
661
- */
662
- memberId: string | null;
663
- /**
664
- * Local start date and time from which events are returned in
665
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
666
- * `2024-01-30T13:30:00`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
667
- *
668
- * Events that start before the `fromLocalDate` but end after it are included in
669
- * the results. Must be earlier than `toLocalDate`.
670
- */
671
- fromLocalDate?: string | null;
672
- /**
673
- * Local end date and time up to which events are returned in
674
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
675
- * `2024-01-30T13:30:00`. Can't be more than a full year after
676
- * `fromLocalDate`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
677
- *
678
- * Events that start before `toLocalDate` but end after it are included in the
679
- * results. Must be later than `fromLocalDate`.
680
- */
681
- toLocalDate?: string | null;
682
- /**
683
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
684
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
685
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
686
- *
687
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
688
- */
689
- timeZone?: string | null;
690
- /**
691
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
692
- * to filter events by.
693
- */
694
- appId?: string | null;
695
- /** Cursor to retrieve the next page of the results. */
696
- cursorPaging?: CommonCursorPaging$1;
697
- /**
698
- * IDs of the events to retrieve.
699
- * If you provide a list of IDs, all other filters are ignored.
700
- *
701
- * Max: 100 `eventId`s
702
- */
703
- eventIds?: string[];
704
- }
705
- interface ListEventsByMemberIdResponse$1 {
706
- /** Retrieved events. */
707
- events?: Event$1[];
708
- /** Paging metadata. */
709
- pagingMetadata?: CommonCursorPagingMetadata$1;
710
- }
711
- interface GetEventRequest$1 {
712
- /**
713
- * ID of the event to retrieve.
714
- *
715
- * Min: 36 characters
716
- * Max: 250 characters
717
- */
718
- eventId: string | null;
719
- /**
720
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
721
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
722
- * `America/New_York` or `UTC`.
723
- *
724
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
725
- */
726
- timeZone?: string | null;
727
- /**
728
- * Information about which fields containing personal data to return. Refer to the
729
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
730
- * for more information.
731
- *
732
- * Supported values:
733
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
734
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
735
- *
736
- * Max: 1 field
737
- * Default: No personal data is returned.
738
- */
739
- fields?: RequestedFields$3[];
740
- }
741
- declare enum RequestedFields$3 {
742
- UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
743
- /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
744
- PI_FIELDS = "PI_FIELDS",
745
- /** Returns only fields containing your own personal data. */
746
- OWN_PI_FIELDS = "OWN_PI_FIELDS"
747
- }
748
- interface GetEventResponse$1 {
749
- /** Retrieved event. */
750
- event?: Event$1;
751
- }
752
- interface ListEventsRequest$1 {
753
- /**
754
- * IDs of the events to retrieve.
755
- *
756
- * Min: 1 event ID
757
- * Min: 100 event IDs
758
- */
759
- eventIds: string[];
760
- /**
761
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
762
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
763
- * `America/New_York` or `UTC`.
764
- *
765
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
766
- */
767
- timeZone?: string | null;
768
- /**
769
- * Information about which fields containing personal data to return. Refer to the
770
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
771
- * for more information.
772
- *
773
- * Supported values:
774
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
775
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
776
- *
777
- * Max: 1 field
778
- * Default: No personal data is returned.
779
- */
780
- fields?: RequestedFields$3[];
781
- }
782
- interface ListEventsResponse$1 {
783
- /** Retrieved events matching the provided IDs. */
784
- events?: Event$1[];
785
- }
786
- interface QueryEventsRequest$1 {
787
- /**
788
- * Local start date and time from which events are returned in
789
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
790
- * `2024-01-30T13:30:00`.
791
- *
792
- * Events that start before the `fromLocalDate` but end after it are included in
793
- * the results. Must be earlier than `toLocalDate` unless the sort order is
794
- * descending.
795
- */
796
- fromLocalDate?: string | null;
797
- /**
798
- * Local end date and time up to which events are returned in
799
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
800
- * `2024-01-30T13:30:00`.
801
- *
802
- * Events that start before `toLocalDate` but end after it are included in the
803
- * results. Must be later than `fromLocalDate` unless the sort order is
804
- * descending.
805
- */
806
- toLocalDate?: string | null;
807
- /**
808
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
809
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
810
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
811
- *
812
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
813
- */
814
- timeZone?: string | null;
815
- /** Query containing filters and paging. */
816
- query?: CursorQuery$5;
817
- /**
818
- * Filters events based on their `recurrenceType`.
819
- *
820
- * Max: 5 recurrence types can be specified.
821
- * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
822
- */
823
- recurrenceType?: RecurrenceType$1[];
824
- /**
825
- * Information about which fields containing personal data to return. Refer to the
826
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
827
- * for more information.
828
- *
829
- * Supported values:
830
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
831
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
832
- *
833
- * Max: 1 field
834
- * Default: No personal data is returned.
835
- */
836
- fields?: RequestedFields$3[];
837
- }
838
- /** TODO Diverge */
839
- interface CursorQuery$5 extends CursorQueryPagingMethodOneOf$5 {
840
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
841
- cursorPaging?: CursorPaging$5;
842
- /**
843
- * Filter object.
844
- * See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
845
- * for more information.
846
- *
847
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
848
- *
849
- * For a detailed list of supported filters, see Supported Filters.
850
- */
851
- filter?: Record<string, any> | null;
852
- /**
853
- * Whether to sort events by their start date in ascending order or by their end date in descending order.
854
- * Default is start ascending.
855
- */
856
- sort?: Sorting$1[];
857
- }
858
- /** @oneof */
859
- interface CursorQueryPagingMethodOneOf$5 {
860
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
861
- cursorPaging?: CursorPaging$5;
862
- }
863
- /** TODO Diverge */
864
- interface Sorting$1 {
865
- /**
866
- * The field to sort by.
867
- * Either `start` or `end`.
868
- * Default is `start`.
869
- */
870
- fieldName?: string;
871
- /** Sort order. */
872
- order?: SortOrder$1;
873
- }
874
- declare enum SortOrder$1 {
875
- ASC = "ASC",
876
- DESC = "DESC"
877
- }
878
- /** TODO Diverge */
879
- interface CursorPaging$5 {
880
- /**
881
- * Number of events to return.
882
- * Defaults to `50`. Maximum `1000`.
883
- */
884
- limit?: number | null;
885
- /**
886
- * Pointer to the next or previous page in the list of results.
887
- *
888
- * You can get the relevant cursor token
889
- * from the `pagingMetadata` object in the previous call's response.
890
- * Not relevant for the first request.
891
- */
892
- cursor?: string | null;
893
- }
894
- interface QueryEventsResponse$1 {
895
- /** Retrieved events matching the provided query. */
896
- events?: Event$1[];
897
- /** Paging metadata. */
898
- pagingMetadata?: CursorPagingMetadata$5;
899
- }
900
- /** TODO Diverge */
901
- interface CursorPagingMetadata$5 {
902
- /** Number of items returned in the response. */
903
- count?: number | null;
904
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
905
- cursors?: Cursors$5;
906
- /**
907
- * Indicates if there are more results after the current page.
908
- * If `true`, another page of results can be retrieved.
909
- * If `false`, this is the last page.
910
- */
911
- hasNext?: boolean | null;
912
- }
913
- interface Cursors$5 {
914
- /** Cursor pointing to next page in the list of results. */
915
- next?: string | null;
916
- }
917
- interface CreateEventRequest$1 {
918
- /** Event to create. */
919
- event: Event$1;
920
- /**
921
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
922
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
923
- * `America/New_York` or `UTC`.
924
- *
925
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
926
- */
927
- timeZone?: string | null;
928
- /**
929
- * Idempotency key guaranteeing that you don't create the same event more
930
- * than once.
931
- */
932
- idempotencyKey?: string | null;
933
- }
934
- interface CreateEventResponse$1 {
935
- /** Created event. */
936
- event?: Event$1;
937
- }
938
- interface BulkCreateEventRequest$1 {
939
- /** Events to create. */
940
- events: MaskedEvent$1[];
941
- /**
942
- * Whether to return created events.
943
- *
944
- * Default: `false`.
945
- */
946
- returnEntity?: boolean | null;
947
- /**
948
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
949
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
950
- * `America/New_York` or `UTC`.
951
- *
952
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
953
- */
954
- timeZone?: string | null;
955
- }
956
- interface MaskedEvent$1 {
957
- /** Event to create. */
958
- event?: Event$1;
959
- }
960
- interface BulkCreateEventResponse$1 {
961
- /** The result for each event, containing the event and whether the action was successful. */
962
- results?: BulkEventResult$1[];
963
- /** Total successes and failures. */
964
- bulkActionMetadata?: BulkActionMetadata$1;
965
- }
966
- interface BulkEventResult$1 {
967
- /** Whether the requested action was successful. */
968
- itemMetadata?: ItemMetadata$1;
969
- /** The event. */
970
- item?: Event$1;
971
- }
972
- interface ItemMetadata$1 {
973
- /**
974
- * Event ID.
975
- * Should always be available, unless it's impossible (for example, when failing to create an event).
976
- */
977
- id?: string | null;
978
- /** Index of the item within the request array, for correlation between request and response items. */
979
- originalIndex?: number;
980
- /**
981
- * Whether the requested action was successful for this event.
982
- * When `false`, the `error` field is populated.
983
- */
984
- success?: boolean;
985
- /** Details about the error in case of failure. */
986
- error?: ApplicationError$1;
987
- }
988
- interface ApplicationError$1 {
989
- /** Error code. */
990
- code?: string;
991
- /** Description of the error. */
992
- description?: string;
993
- /** Data related to the error. */
994
- data?: Record<string, any> | null;
995
- }
996
- interface BulkActionMetadata$1 {
997
- /** Number of events that were successfully processed. */
998
- totalSuccesses?: number;
999
- /** Number of events that couldn't be processed. */
1000
- totalFailures?: number;
1001
- }
1002
- interface UpdateEventRequest$1 {
1003
- /** Event to update. */
1004
- event: Event$1;
1005
- /**
1006
- * Information about whether participants of the updated event are notified and
1007
- * the message they receive.
1008
- */
1009
- participantNotification?: ParticipantNotification$3;
1010
- /**
1011
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1012
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1013
- * `America/New_York` or `UTC`.
1014
- *
1015
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1016
- */
1017
- timeZone?: string | null;
1018
- }
1019
- interface ParticipantNotification$3 {
1020
- /**
1021
- * Whether to notify the participants about changes made to the schedule or event.
1022
- *
1023
- * Default: `false`
1024
- */
1025
- notifyParticipants?: boolean | null;
1026
- /**
1027
- * Message to send.
1028
- *
1029
- * Min: 1 character
1030
- * Max: 5000 characters
1031
- */
1032
- message?: string | null;
1033
- }
1034
- interface UpdateEventResponse$1 {
1035
- /** Updated event. */
1036
- event?: Event$1;
1037
- }
1038
- interface BulkUpdateEventRequest$1 {
1039
- /**
1040
- * Events to update.
1041
- *
1042
- * Min: 1 event
1043
- * Max: 50 events
1044
- */
1045
- events: BulkUpdateEventRequestMaskedEvent$1[];
1046
- /**
1047
- * Whether to return the updated events.
1048
- *
1049
- * Default: `false`
1050
- */
1051
- returnEntity?: boolean | null;
1052
- /**
1053
- * Information about whether participants of the updated event are notified and
1054
- * the message they receive.
1055
- */
1056
- participantNotification?: ParticipantNotification$3;
1057
- /**
1058
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1059
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1060
- * `America/New_York` or `UTC`.
1061
- *
1062
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1063
- */
1064
- timeZone?: string | null;
1065
- }
1066
- interface BulkUpdateEventRequestMaskedEvent$1 {
1067
- /** Event to update. */
1068
- event?: Event$1;
1069
- }
1070
- interface BulkUpdateEventResponse$1 {
1071
- /** The result for each event, containing the event and whether the action was successful. */
1072
- results?: BulkEventResult$1[];
1073
- /** Total successes and failures. */
1074
- bulkActionMetadata?: BulkActionMetadata$1;
1075
- }
1076
- interface RestoreEventDefaultsRequest$1 {
1077
- /** ID of the event for which to restore default values. */
1078
- eventId: string | null;
1079
- /**
1080
- * Fields for which to restore default values.
1081
- *
1082
- * `TIME` restores default values for `start` and `end`.
1083
- *
1084
- * Min: 1 field
1085
- */
1086
- fields: Field$1[];
1087
- /**
1088
- * Information about whether participants of the updated event are notified and
1089
- * the message they receive.
1090
- */
1091
- participantNotification?: ParticipantNotification$3;
1092
- /**
1093
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1094
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1095
- * `America/New_York` or `UTC`.
1096
- *
1097
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1098
- */
1099
- timeZone?: string | null;
1100
- }
1101
- interface RestoreEventDefaultsResponse$1 {
1102
- /** Updated event. */
1103
- event?: Event$1;
1104
- }
1105
- interface SplitRecurringEventRequest$1 {
1106
- /** ID of the `MASTER` event to split. */
1107
- recurringEventId: string | null;
1108
- /**
1109
- * Local date and time at which the `MASTER` event is split in
1110
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1111
- * `2025-03-11T09:00:00`.
1112
- * Must be a future date that's after the `start` date of the next `INSTANCE` or
1113
- * `EXCEPTION` event in the series. Additionally, there must be another
1114
- * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
1115
- * wouldn't affect any event without a subsequent occurrence.
1116
- */
1117
- splitLocalDate: string | null;
1118
- /**
1119
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1120
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1121
- * `America/New_York` or `UTC`.
1122
- *
1123
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1124
- */
1125
- timeZone?: string | null;
1126
- }
1127
- interface SplitRecurringEventResponse$1 {
1128
- /** Original `MASTER` event that was shortened. */
1129
- updatedRecurringEventEndingBeforeSplit?: Event$1;
1130
- /** New `MASTER` event starting with the first event after the split date. */
1131
- newRecurringEventStartingFromSplit?: Event$1;
1132
- }
1133
- interface CancelEventRequest$1 {
1134
- /** ID of the event to cancel. */
1135
- eventId: string | null;
1136
- /**
1137
- * Information about whether participants of the canceled event are notified and
1138
- * the message they receive.
1139
- */
1140
- participantNotification?: ParticipantNotification$3;
1141
- /**
1142
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1143
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1144
- * `America/New_York` or `UTC`.
1145
- *
1146
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1147
- */
1148
- timeZone?: string | null;
1149
- }
1150
- interface CancelEventResponse$1 {
1151
- /** Canceled event. */
1152
- event?: Event$1;
1153
- }
1154
- interface BulkCancelEventRequest$1 {
1155
- /** IDs of the events to cancel. */
1156
- eventIds: string[];
1157
- /**
1158
- * Whether to return the canceled events.
1159
- *
1160
- * Default: `false`
1161
- */
1162
- returnEntity?: boolean | null;
1163
- /**
1164
- * Information about whether participants of the canceled events are notified and
1165
- * the message they receive.
1166
- */
1167
- participantNotification?: ParticipantNotification$3;
1168
- /**
1169
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1170
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1171
- * `America/New_York` or `UTC`.
1172
- *
1173
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1174
- */
1175
- timeZone?: string | null;
1176
- }
1177
- interface BulkCancelEventResponse$1 {
1178
- /** The result for each event, containing the event and whether the action was successful. */
1179
- results?: BulkEventResult$1[];
1180
- /** Total successes and failures. */
1181
- bulkActionMetadata?: BulkActionMetadata$1;
1182
- }
1183
- interface RecurrenceRuleNonNullableFields$1 {
1184
- frequency: Frequency$1;
1185
- days: Day$1[];
1186
- }
1187
- interface LocationNonNullableFields$3 {
1188
- type: LocationType$3;
1189
- }
1190
- interface ResourceNonNullableFields$1 {
1191
- transparency: Transparency$1;
1192
- permissionRole: Role$3;
1193
- }
1194
- interface ParticipantsNonNullableFields$1 {
1195
- status: ParticipantsStatus$1;
1196
- }
1197
- interface ConferencingDetailsNonNullableFields$3 {
1198
- type: Type$3;
1199
- }
1200
- interface CommonIdentificationDataNonNullableFields$3 {
1201
- wixUserId: string;
1202
- identityType: IdentityType$3;
1203
- }
1204
- interface PermissionNonNullableFields$3 {
1205
- identity?: CommonIdentificationDataNonNullableFields$3;
1206
- role: Role$3;
1207
- }
1208
- interface EventNonNullableFields$1 {
1209
- status: Status$7;
1210
- recurrenceType: RecurrenceType$1;
1211
- recurrenceRule?: RecurrenceRuleNonNullableFields$1;
1212
- transparency: Transparency$1;
1213
- location?: LocationNonNullableFields$3;
1214
- resources: ResourceNonNullableFields$1[];
1215
- participants?: ParticipantsNonNullableFields$1;
1216
- conferencingDetails?: ConferencingDetailsNonNullableFields$3;
1217
- inheritedFields: Field$1[];
1218
- permissions: PermissionNonNullableFields$3[];
1219
- }
1220
- interface ListEventsByContactIdResponseNonNullableFields$1 {
1221
- events: EventNonNullableFields$1[];
1222
- }
1223
- interface ListEventsByMemberIdResponseNonNullableFields$1 {
1224
- events: EventNonNullableFields$1[];
1225
- }
1226
- interface GetEventResponseNonNullableFields$1 {
1227
- event?: EventNonNullableFields$1;
1228
- }
1229
- interface ListEventsResponseNonNullableFields$1 {
1230
- events: EventNonNullableFields$1[];
1231
- }
1232
- interface QueryEventsResponseNonNullableFields$1 {
1233
- events: EventNonNullableFields$1[];
1234
- }
1235
- interface CreateEventResponseNonNullableFields$1 {
1236
- event?: EventNonNullableFields$1;
1237
- }
1238
- interface ApplicationErrorNonNullableFields$1 {
1239
- code: string;
1240
- description: string;
1241
- }
1242
- interface ItemMetadataNonNullableFields$1 {
1243
- originalIndex: number;
1244
- success: boolean;
1245
- error?: ApplicationErrorNonNullableFields$1;
1246
- }
1247
- interface BulkEventResultNonNullableFields$1 {
1248
- itemMetadata?: ItemMetadataNonNullableFields$1;
1249
- item?: EventNonNullableFields$1;
1250
- }
1251
- interface BulkActionMetadataNonNullableFields$1 {
1252
- totalSuccesses: number;
1253
- totalFailures: number;
1254
- }
1255
- interface BulkCreateEventResponseNonNullableFields$1 {
1256
- results: BulkEventResultNonNullableFields$1[];
1257
- bulkActionMetadata?: BulkActionMetadataNonNullableFields$1;
1258
- }
1259
- interface UpdateEventResponseNonNullableFields$1 {
1260
- event?: EventNonNullableFields$1;
1261
- }
1262
- interface BulkUpdateEventResponseNonNullableFields$1 {
1263
- results: BulkEventResultNonNullableFields$1[];
1264
- bulkActionMetadata?: BulkActionMetadataNonNullableFields$1;
1265
- }
1266
- interface RestoreEventDefaultsResponseNonNullableFields$1 {
1267
- event?: EventNonNullableFields$1;
1268
- }
1269
- interface SplitRecurringEventResponseNonNullableFields$1 {
1270
- updatedRecurringEventEndingBeforeSplit?: EventNonNullableFields$1;
1271
- newRecurringEventStartingFromSplit?: EventNonNullableFields$1;
1272
- }
1273
- interface CancelEventResponseNonNullableFields$1 {
1274
- event?: EventNonNullableFields$1;
1275
- }
1276
- interface BulkCancelEventResponseNonNullableFields$1 {
1277
- results: BulkEventResultNonNullableFields$1[];
1278
- bulkActionMetadata?: BulkActionMetadataNonNullableFields$1;
1279
- }
1280
-
1281
- /**
1282
- * An event is a scheduled entry on a calendar that includes details like timing,
1283
- * location, and participants. Each event is associated with
1284
- * a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
1285
- * from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
1286
- * Events can either be standalone, part of a recurring series, or define a
1287
- * recurrence pattern. You can also specify whether events block time on the
1288
- * schedule or allow other events to be scheduled concurrently.
1289
- */
1290
- interface Event {
1291
- /**
1292
- * Event ID.
1293
- * @readonly
1294
- */
1295
- _id?: string | null;
1296
- /**
1297
- * ID of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
1298
- * the event belongs to.
1299
- * After creating an event, you can't assign it to a different schedule.
1300
- */
1301
- scheduleId?: string | null;
1302
- /**
1303
- * ID of the external schedule the event belongs to.
1304
- *
1305
- * For example, if the event belongs to a Bookings staff member, identical to the ID of the [resource](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction). If the schedule belongs to a Bookings service, identical to the ID of the [service](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup).
1306
- * @readonly
1307
- */
1308
- externalScheduleId?: string | null;
1309
- /**
1310
- * Schedule name.
1311
- * @readonly
1312
- */
1313
- scheduleName?: string | null;
1314
- /**
1315
- * Event type. You can set the event type but you can't update it.
1316
- *
1317
- * Supported values:
1318
- * + `DEFAULT`: A standard event that's not further specified.
1319
- * + `WORKING_HOURS`: The event adds working hours to a schedule. By default not returned in [queryEvents()](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/query-events).
1320
- *
1321
- * Additional supported values, if Wix Bookings is installed:
1322
- * + `APPOINTMENT`: Bookings appointment event.
1323
- * + `CLASS`: Bookings class event.
1324
- * + `COURSE`: Bookings course event.
1325
- */
1326
- type?: string | null;
1327
- /**
1328
- * Event status.
1329
- *
1330
- * Supported values:
1331
- * + `CONFIRMED`: Event is scheduled to happen or has happened.
1332
- * + `CANCELLED`: Event has been canceled.
1333
- *
1334
- * Default: `CONFIRMED`
1335
- * @readonly
1336
- */
1337
- status?: Status$6;
1338
- /**
1339
- * Event title.
1340
- *
1341
- * Min: 1 character
1342
- * Max: 200 characters
1343
- */
1344
- title?: string | null;
1345
- /** Information about when the event starts. */
1346
- start?: ZonedDate$2;
1347
- /**
1348
- * Information about when the event ends.
1349
- *
1350
- * Maximum allowed date: Year 2100, or up to 100 years from the event's start date (whichever comes first).
1351
- */
1352
- end?: ZonedDate$2;
1353
- /**
1354
- * Information about when the event starts adjusted to the `timeZone` of the
1355
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
1356
- * or a different `timeZone` you provide in the call's request.
1357
- * @readonly
1358
- */
1359
- adjustedStart?: ZonedDate$2;
1360
- /**
1361
- * Information about when the event ends adjusted to the `timeZone` of the
1362
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
1363
- * or a different `timeZone` you provide in the call's request.
1364
- * @readonly
1365
- */
1366
- adjustedEnd?: ZonedDate$2;
1367
- /**
1368
- * Time zone the event is associated with in
1369
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
1370
- * Only regional time zones and UTC are supported.
1371
- * For example, `America/New_York` or `UTC`.
1372
- *
1373
- * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
1374
- */
1375
- timeZone?: string | null;
1376
- /**
1377
- * Information about whether the event is a single occurrence or part of a
1378
- * recurring series.
1379
- *
1380
- * Supported values:
1381
- * + `NONE`: The event occurs only once and doesn't repeat.
1382
- * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
1383
- * + `INSTANCE`: A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`.
1384
- * + `EXCEPTION`: A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event.
1385
- *
1386
- * Default: `NONE`
1387
- * @readonly
1388
- */
1389
- recurrenceType?: RecurrenceType;
1390
- /**
1391
- * Recurrence pattern for a series of events. This field is required when
1392
- * creating a `MASTER` event and isn't available for non-recurring events.
1393
- * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
1394
- *
1395
- * For example, an event that repeats every second Monday until January 7, 2026,
1396
- * at 8:00 AM has the following `recurrenceRule`:
1397
- * - `frequency = WEEKLY`
1398
- * - `interval = 2`
1399
- * - `days = [MONDAY]`
1400
- * - `until = 20260107T08:00:00Z`
1401
- */
1402
- recurrenceRule?: RecurrenceRule;
1403
- /**
1404
- * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
1405
- * and `EXCEPTION` events.
1406
- * @readonly
1407
- */
1408
- recurringEventId?: string | null;
1409
- /**
1410
- * Specifies whether the event blocks time in the schedule it belongs to.
1411
- *
1412
- * Supported values:
1413
- * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same entities (for example, Booking staff members) from being scheduled at the same time.
1414
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
1415
- *
1416
- * Default: `OPAQUE`
1417
- */
1418
- transparency?: Transparency;
1419
- /**
1420
- * Event location.
1421
- *
1422
- * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to
1423
- */
1424
- location?: Location$2;
1425
- /**
1426
- * List of [Wix Bookings resources](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction)
1427
- * affected by the event. This could include, for example, the
1428
- * [Wix Bookings staff member](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction)
1429
- * providing the service or the room where the appointment takes place.
1430
- *
1431
- * Max: 100 resources
1432
- */
1433
- resources?: Resource[];
1434
- /**
1435
- * Maximum number of participants who can participate in the event.
1436
- *
1437
- * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
1438
- */
1439
- totalCapacity?: number | null;
1440
- /**
1441
- * Number of participants who can still be added to the event.
1442
- * @readonly
1443
- */
1444
- remainingCapacity?: number | null;
1445
- /**
1446
- * Information about the event's participants.
1447
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#retrieve-personal-information).
1448
- * @readonly
1449
- */
1450
- participants?: Participants;
1451
- /**
1452
- * Information about the event's online conferencing.
1453
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#retrieve-personal-information).
1454
- *
1455
- * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
1456
- */
1457
- conferencingDetails?: ConferencingDetails$2;
1458
- /**
1459
- * Additional notes about the event.
1460
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#retrieve-personal-information).
1461
- *
1462
- * Min: 1 character
1463
- * Max: 5000 characters
1464
- */
1465
- notes?: string | null;
1466
- /**
1467
- * List of fields whose values are inherited.
1468
- * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
1469
- * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related `MASTER` event.
1470
- * @readonly
1471
- */
1472
- inheritedFields?: Field[];
1473
- /**
1474
- * ID of the app that owns the event. Identical to `appId` of the
1475
- * [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
1476
- * to which the event belongs.
1477
- * @readonly
1478
- */
1479
- appId?: string | null;
1480
- /**
1481
- * List of permissions associated with the event. Refer to the
1482
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#roles)
1483
- * for more information.
1484
- * @readonly
1485
- */
1486
- permissions?: Permission$2[];
1487
- /** Extensions enabling applications or users to save custom data related to the event. */
1488
- extendedFields?: ExtendedFields$4;
1489
- /**
1490
- * Revision number, which increments each time the event is updated.
1491
- * To prevent conflicting changes, the current revision must be passed when updating the event.
1492
- * Ignored when creating an event.
1493
- * @readonly
1494
- */
1495
- revision?: string | null;
1496
- /**
1497
- * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
1498
- * @readonly
1499
- */
1500
- _createdDate?: Date | null;
1501
- /**
1502
- * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
1503
- * @readonly
1504
- */
1505
- _updatedDate?: Date | null;
1506
- }
1507
- declare enum Status$6 {
1508
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
1509
- /** Event is scheduled to happen or has happened. */
1510
- CONFIRMED = "CONFIRMED",
1511
- /** DEPRECATED! AND WILL BE REMOVED SOON */
1512
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION",
1513
- /** Event has been canceled. */
1514
- CANCELLED = "CANCELLED"
1515
- }
1516
- /** A date time with a time zone, having the UTC offset and date determined by the server. */
1517
- interface ZonedDate$2 {
1518
- /**
1519
- * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
1520
- * For example, `2024-01-30T13:30:00`.
1521
- * Wix Calendar APIs ignore seconds.
1522
- */
1523
- localDate?: string | null;
1524
- /**
1525
- * Time zone in
1526
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
1527
- * For example, `America/New_York`.
1528
- * @readonly
1529
- */
1530
- timeZone?: string | null;
1531
- /**
1532
- * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
1533
- * For example, `2024-01-30T13:30:00`.
1534
- * Not available for adjusted date fields.
1535
- * @readonly
1536
- */
1537
- utcDate?: Date | null;
1538
- }
1539
- declare enum RecurrenceType {
1540
- UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
1541
- /** The event occurs only once and doesn't repeat. */
1542
- NONE = "NONE",
1543
- /** Defines the recurrence pattern for a series of recurring events. */
1544
- MASTER = "MASTER",
1545
- /** A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`. */
1546
- INSTANCE = "INSTANCE",
1547
- /** A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event. */
1548
- EXCEPTION = "EXCEPTION"
1549
- }
1550
- interface RecurrenceRule {
1551
- /**
1552
- * Frequency how often the event repeats. Works together with `interval`.
1553
- *
1554
- * Supported values:
1555
- * + `WEEKLY`: The event's recurrence pattern is based on weeks.
1556
- */
1557
- frequency?: Frequency;
1558
- /**
1559
- * Interval how often the event repeats. Works together with `frequency`.
1560
- * For example, `frequency` set to `WEEKLY` and `interval` set to `2` means
1561
- * the event repeats every 2 weeks.
1562
- *
1563
- * Min: `1`
1564
- * Max: `4`
1565
- * Default: `1`
1566
- */
1567
- interval?: number | null;
1568
- /**
1569
- * Days of the week when the recurring event takes place.
1570
- * Currently, only a single day is supported.
1571
- *
1572
- * Min: 1 day
1573
- * Max: 1 day
1574
- */
1575
- days?: Day[];
1576
- /**
1577
- * Date until when the event repeats.
1578
- * If not specified, the event repeats forever.
1579
- */
1580
- until?: ZonedDate$2;
1581
- /**
1582
- * Date until when the event repeats
1583
- * adjusted to the `timeZone` of the business
1584
- * [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
1585
- * or a different `timeZone` you provide in the call's request.
1586
- * @readonly
1587
- */
1588
- adjustedUntil?: ZonedDate$2;
1589
- }
1590
- declare enum Frequency {
1591
- UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
1592
- /** The event's recurrence pattern is based on weeks. */
1593
- WEEKLY = "WEEKLY"
1594
- }
1595
- declare enum Day {
1596
- /** The recurring event takes place on Mondays. */
1597
- MONDAY = "MONDAY",
1598
- /** The recurring event takes place on Tuesdays. */
1599
- TUESDAY = "TUESDAY",
1600
- /** The recurring event takes place on Wednesday. */
1601
- WEDNESDAY = "WEDNESDAY",
1602
- /** The recurring event takes place on Thursdays. */
1603
- THURSDAY = "THURSDAY",
1604
- /** The recurring event takes place on Fridays. */
1605
- FRIDAY = "FRIDAY",
1606
- /** The recurring event takes place on Saturdays. */
1607
- SATURDAY = "SATURDAY",
1608
- /** The recurring event takes place on Sundays. */
1609
- SUNDAY = "SUNDAY"
1610
- }
1611
- declare enum Transparency {
1612
- UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
1613
- /** The schedule is blocked during the event, preventing other events that involve the same entities (for example, Booking staff members) from being scheduled at the same time. */
1614
- OPAQUE = "OPAQUE",
1615
- /** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
1616
- TRANSPARENT = "TRANSPARENT"
1617
- }
1618
- interface Location$2 {
1619
- /**
1620
- * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
1621
- * ID. Available only for `BUSINESS` locations.
1622
- */
1623
- _id?: string | null;
1624
- /**
1625
- * Location type.
1626
- *
1627
- * Supported values:
1628
- * + `BUSINESS`: The event is held at a business location.
1629
- * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
1630
- * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
1631
- */
1632
- type?: LocationType$2;
1633
- /**
1634
- * Location name. For `BUSINESS` locations, it's identical to the
1635
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
1636
- * `name`.
1637
- *
1638
- * Min: 1 character
1639
- * Max: 150 characters
1640
- */
1641
- name?: string | null;
1642
- /**
1643
- * Location address. For `BUSINESS` locations, it's identical to the
1644
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
1645
- * `formattedAddress`.
1646
- */
1647
- address?: string | null;
1648
- }
1649
- declare enum LocationType$2 {
1650
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
1651
- /** The event is held at a business location. */
1652
- BUSINESS = "BUSINESS",
1653
- /** The event is held at the customer's location, such as their home or office. */
1654
- CUSTOMER = "CUSTOMER",
1655
- /** The event is held at an address or venue not tied to the business or customer. */
1656
- CUSTOM = "CUSTOM"
1657
- }
1658
- interface Resource {
1659
- /** Resource ID. */
1660
- _id?: string | null;
1661
- /**
1662
- * Resource name.
1663
- * @readonly
1664
- */
1665
- name?: string | null;
1666
- /**
1667
- * Resource type.
1668
- * @readonly
1669
- */
1670
- type?: string | null;
1671
- /**
1672
- * Specifies whether the event blocks time in the resource's schedule.
1673
- *
1674
- * Supported values:
1675
- * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
1676
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
1677
- *
1678
- * Default: `OPAQUE`.
1679
- */
1680
- transparency?: Transparency;
1681
- /**
1682
- * Permission role associated with the resource. Refer to the
1683
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
1684
- * for more information.
1685
- */
1686
- permissionRole?: Role$2;
1687
- }
1688
- declare enum Role$2 {
1689
- UNKNOWN_ROLE = "UNKNOWN_ROLE",
1690
- /** Full read and write access. */
1691
- WRITER = "WRITER",
1692
- /** Full read access, write access limited to `event.notes`. */
1693
- COMMENTER = "COMMENTER"
1694
- }
1695
- interface Participants {
1696
- /**
1697
- * Total number of participants.
1698
- *
1699
- * Min: `0`
1700
- */
1701
- total?: number | null;
1702
- /**
1703
- * Full or partial list of the participants.
1704
- *
1705
- * Max: 50 participants
1706
- */
1707
- list?: Participant$2[];
1708
- /**
1709
- * Whether there are more participants for the event than listed.
1710
- *
1711
- * + `false`: The list includes all participants.
1712
- * + `true`: The list doesn't include all participants.
1713
- */
1714
- hasMore?: boolean | null;
1715
- /**
1716
- * Participant's status.
1717
- *
1718
- * Supported values:
1719
- * + `CONFIRMED`: All participants are confirmed.
1720
- * + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
1721
- */
1722
- status?: ParticipantsStatus;
1723
- }
1724
- interface Participant$2 {
1725
- /**
1726
- * Participant name.
1727
- *
1728
- * Min: 1 character
1729
- * Max: 200 characters
1730
- */
1731
- name?: string | null;
1732
- /** Participant's phone number. */
1733
- phone?: string | null;
1734
- /** Participant's email address. */
1735
- email?: string | null;
1736
- /**
1737
- * [Contact](https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/introduction)
1738
- * ID of the participant.
1739
- */
1740
- contactId?: string | null;
1741
- }
1742
- declare enum ParticipantsStatus {
1743
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
1744
- /** All participants are confirmed. */
1745
- CONFIRMED = "CONFIRMED",
1746
- /** At least one participant isn't confirmed yet. */
1747
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
1748
- }
1749
- interface ConferencingDetails$2 {
1750
- /** Conference type. For example, `Zoom`. */
1751
- type?: Type$2;
1752
- /**
1753
- * URL used by the host to start the conference.
1754
- *
1755
- * Min: 1 character
1756
- * Max: 2000 characters
1757
- */
1758
- hostUrl?: string | null;
1759
- /**
1760
- * URL used by a guest to join the conference.
1761
- *
1762
- * Min: 1 character
1763
- * Max: 2000 characters
1764
- */
1765
- guestUrl?: string | null;
1766
- /**
1767
- * Conference password.
1768
- *
1769
- * Min: 1 character
1770
- * Max: 100 characters
1771
- */
1772
- password?: string | null;
1773
- /**
1774
- * Conference ID in an external system.
1775
- *
1776
- * Min: 1 character
1777
- * Max: 150 characters
1778
- */
1779
- externalId?: string | null;
1780
- }
1781
- declare enum Type$2 {
1782
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
1783
- ZOOM = "ZOOM",
1784
- CUSTOM = "CUSTOM"
1785
- }
1786
- declare enum Field {
1787
- UNKNOWN_FIELD = "UNKNOWN_FIELD",
1788
- /** `title` is inherited from the schedule or `MASTER` event. */
1789
- TITLE = "TITLE",
1790
- /** `timeZone` is inherited from the schedule or `MASTER` event. */
1791
- TIME_ZONE = "TIME_ZONE",
1792
- /** `start` and `end` are inherited from the `MASTER` event. */
1793
- TIME = "TIME",
1794
- /** `location` is inherited from the schedule or `MASTER` event. */
1795
- LOCATION = "LOCATION",
1796
- /** `resources` is inherited from the `MASTER` event. */
1797
- RESOURCES = "RESOURCES",
1798
- /** `capacity` is inherited from the schedule or `MASTER` event. */
1799
- CAPACITY = "CAPACITY",
1800
- /** `participants` is inherited from the `MASTER` event. */
1801
- PARTICIPANTS = "PARTICIPANTS",
1802
- /** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
1803
- CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
1804
- }
1805
- interface Permission$2 {
1806
- /**
1807
- * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
1808
- * granted the permission.
1809
- */
1810
- identity?: CommonIdentificationData$2;
1811
- /**
1812
- * Permission role.
1813
- *
1814
- * Supported values:
1815
- * + `WRITER`: Full read and write access.
1816
- * + `COMMENTER`: Full read access, write access limited to `event.notes`.
1817
- */
1818
- role?: Role$2;
1819
- }
1820
- interface CommonIdentificationData$2 extends CommonIdentificationDataIdOneOf$2 {
1821
- /**
1822
- * ID of a Wix user. For example, the site owner or a
1823
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
1824
- */
1825
- wixUserId?: string;
1826
- }
1827
- /** @oneof */
1828
- interface CommonIdentificationDataIdOneOf$2 {
1829
- /**
1830
- * ID of a Wix user. For example, the site owner or a
1831
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
1832
- */
1833
- wixUserId?: string;
1834
- }
1835
- declare enum IdentityType$2 {
1836
- UNKNOWN = "UNKNOWN",
1837
- WIX_USER = "WIX_USER"
1838
- }
1839
- interface ExtendedFields$4 {
1840
- /**
1841
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
1842
- * The value of each key is structured according to the schema defined when the extended fields were configured.
1843
- *
1844
- * You can only access fields for which you have the appropriate permissions.
1845
- *
1846
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
1847
- */
1848
- namespaces?: Record<string, Record<string, any>>;
1849
- }
1850
- interface ListEventsByContactIdRequest {
1851
- /**
1852
- * ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
1853
- * to retrieve events for. Required, unless you provide `cursorPaging`.
1854
- */
1855
- contactId: string | null;
1856
- /**
1857
- * Local start date and time from which events are returned in
1858
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1859
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
1860
- *
1861
- * Events that start before the `fromLocalDate` but end after it are included in
1862
- * the results. Must be earlier than `toLocalDate`.
1863
- */
1864
- fromLocalDate?: string | null;
1865
- /**
1866
- * Local end date and time up to which events are returned in
1867
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1868
- * `2024-01-30T13:30:00`. Can't be more than a full year after
1869
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
1870
- *
1871
- * Events that start before `toLocalDate` but end after it are included in the
1872
- * results. Must be later than `fromLocalDate`.
1873
- */
1874
- toLocalDate?: string | null;
1875
- /**
1876
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1877
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
1878
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
1879
- *
1880
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1881
- */
1882
- timeZone?: string | null;
1883
- /**
1884
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
1885
- * to filter events by.
1886
- */
1887
- appId?: string | null;
1888
- /** Cursor to retrieve the next page of the results. */
1889
- cursorPaging?: CommonCursorPaging;
1890
- }
1891
- /** TODO Diverge */
1892
- interface CommonCursorPaging {
1893
- /**
1894
- * Number of events to return.
1895
- * Defaults to `50`. Maximum `100`.
1896
- */
1897
- limit?: number | null;
1898
- /**
1899
- * Pointer to the next or previous page in the list of results.
1900
- *
1901
- * You can get the relevant cursor token
1902
- * from the `pagingMetadata` object in the previous call's response.
1903
- * Not relevant for the first request.
1904
- */
1905
- cursor?: string | null;
1906
- }
1907
- interface ListEventsByContactIdResponse {
1908
- /** Retrieved events. */
1909
- events?: Event[];
1910
- /** Paging metadata. */
1911
- pagingMetadata?: CommonCursorPagingMetadata;
1912
- }
1913
- /** TODO Diverge */
1914
- interface CommonCursorPagingMetadata {
1915
- /** Number of items returned in the response. */
1916
- count?: number | null;
1917
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
1918
- cursors?: CommonCursors;
1919
- /**
1920
- * Indicates if there are more results after the current page.
1921
- * If `true`, another page of results can be retrieved.
1922
- * If `false`, this is the last page.
1923
- */
1924
- hasNext?: boolean | null;
1925
- }
1926
- interface CommonCursors {
1927
- /** Cursor pointing to next page in the list of results. */
1928
- next?: string | null;
1929
- }
1930
- interface ListEventsByMemberIdRequest {
1931
- /**
1932
- * ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
1933
- * to retrieve events for. Required, unless you provide `cursorPaging`.
1934
- * Provide `me` to retrieve events for the currently logged-in member.
1935
- * You must have the `Read Calendars - Including PI`
1936
- * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
1937
- * to retrieve events for members who aren't the currently logged in member.
1938
- */
1939
- memberId: string | null;
1940
- /**
1941
- * Local start date and time from which events are returned in
1942
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1943
- * `2024-01-30T13:30:00`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
1944
- *
1945
- * Events that start before the `fromLocalDate` but end after it are included in
1946
- * the results. Must be earlier than `toLocalDate`.
1947
- */
1948
- fromLocalDate?: string | null;
1949
- /**
1950
- * Local end date and time up to which events are returned in
1951
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1952
- * `2024-01-30T13:30:00`. Can't be more than a full year after
1953
- * `fromLocalDate`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
1954
- *
1955
- * Events that start before `toLocalDate` but end after it are included in the
1956
- * results. Must be later than `fromLocalDate`.
1957
- */
1958
- toLocalDate?: string | null;
1959
- /**
1960
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1961
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
1962
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
1963
- *
1964
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1965
- */
1966
- timeZone?: string | null;
1967
- /**
1968
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
1969
- * to filter events by.
1970
- */
1971
- appId?: string | null;
1972
- /** Cursor to retrieve the next page of the results. */
1973
- cursorPaging?: CommonCursorPaging;
1974
- /**
1975
- * IDs of the events to retrieve.
1976
- * If you provide a list of IDs, all other filters are ignored.
1977
- *
1978
- * Max: 100 `eventId`s
1979
- */
1980
- eventIds?: string[];
1981
- }
1982
- interface ListEventsByMemberIdResponse {
1983
- /** Retrieved events. */
1984
- events?: Event[];
1985
- /** Paging metadata. */
1986
- pagingMetadata?: CommonCursorPagingMetadata;
1987
- }
1988
- interface GetEventRequest {
1989
- /**
1990
- * ID of the event to retrieve.
1991
- *
1992
- * Min: 36 characters
1993
- * Max: 250 characters
1994
- */
1995
- eventId: string | null;
1996
- /**
1997
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1998
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1999
- * `America/New_York` or `UTC`.
2000
- *
2001
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2002
- */
2003
- timeZone?: string | null;
2004
- /**
2005
- * Information about which fields containing personal data to return. Refer to the
2006
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2007
- * for more information.
2008
- *
2009
- * Supported values:
2010
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2011
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2012
- *
2013
- * Max: 1 field
2014
- * Default: No personal data is returned.
2015
- */
2016
- fields?: RequestedFields$2[];
2017
- }
2018
- declare enum RequestedFields$2 {
2019
- UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
2020
- /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
2021
- PI_FIELDS = "PI_FIELDS",
2022
- /** Returns only fields containing your own personal data. */
2023
- OWN_PI_FIELDS = "OWN_PI_FIELDS"
2024
- }
2025
- interface GetEventResponse {
2026
- /** Retrieved event. */
2027
- event?: Event;
2028
- }
2029
- interface ListEventsRequest {
2030
- /**
2031
- * IDs of the events to retrieve.
2032
- *
2033
- * Min: 1 event ID
2034
- * Min: 100 event IDs
2035
- */
2036
- eventIds: string[];
2037
- /**
2038
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2039
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2040
- * `America/New_York` or `UTC`.
2041
- *
2042
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2043
- */
2044
- timeZone?: string | null;
2045
- /**
2046
- * Information about which fields containing personal data to return. Refer to the
2047
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2048
- * for more information.
2049
- *
2050
- * Supported values:
2051
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2052
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2053
- *
2054
- * Max: 1 field
2055
- * Default: No personal data is returned.
2056
- */
2057
- fields?: RequestedFields$2[];
2058
- }
2059
- interface ListEventsResponse {
2060
- /** Retrieved events matching the provided IDs. */
2061
- events?: Event[];
2062
- }
2063
- interface QueryEventsRequest {
2064
- /**
2065
- * Local start date and time from which events are returned in
2066
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2067
- * `2024-01-30T13:30:00`.
2068
- *
2069
- * Events that start before the `fromLocalDate` but end after it are included in
2070
- * the results. Must be earlier than `toLocalDate` unless the sort order is
2071
- * descending.
2072
- */
2073
- fromLocalDate?: string | null;
2074
- /**
2075
- * Local end date and time up to which events are returned in
2076
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2077
- * `2024-01-30T13:30:00`.
2078
- *
2079
- * Events that start before `toLocalDate` but end after it are included in the
2080
- * results. Must be later than `fromLocalDate` unless the sort order is
2081
- * descending.
2082
- */
2083
- toLocalDate?: string | null;
2084
- /**
2085
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2086
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
2087
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
2088
- *
2089
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2090
- */
2091
- timeZone?: string | null;
2092
- /** Query containing filters and paging. */
2093
- query?: CursorQuery$4;
2094
- /**
2095
- * Filters events based on their `recurrenceType`.
2096
- *
2097
- * Max: 5 recurrence types can be specified.
2098
- * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
2099
- */
2100
- recurrenceType?: RecurrenceType[];
2101
- /**
2102
- * Information about which fields containing personal data to return. Refer to the
2103
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2104
- * for more information.
2105
- *
2106
- * Supported values:
2107
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2108
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2109
- *
2110
- * Max: 1 field
2111
- * Default: No personal data is returned.
2112
- */
2113
- fields?: RequestedFields$2[];
2114
- }
2115
- /** TODO Diverge */
2116
- interface CursorQuery$4 extends CursorQueryPagingMethodOneOf$4 {
2117
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
2118
- cursorPaging?: CursorPaging$4;
2119
- /**
2120
- * Filter object.
2121
- * See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
2122
- * for more information.
2123
- *
2124
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
2125
- *
2126
- * For a detailed list of supported filters, see Supported Filters.
2127
- */
2128
- filter?: Record<string, any> | null;
2129
- /**
2130
- * Whether to sort events by their start date in ascending order or by their end date in descending order.
2131
- * Default is start ascending.
2132
- */
2133
- sort?: Sorting[];
2134
- }
2135
- /** @oneof */
2136
- interface CursorQueryPagingMethodOneOf$4 {
2137
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
2138
- cursorPaging?: CursorPaging$4;
2139
- }
2140
- /** TODO Diverge */
2141
- interface Sorting {
2142
- /**
2143
- * The field to sort by.
2144
- * Either `start` or `end`.
2145
- * Default is `start`.
2146
- */
2147
- fieldName?: string;
2148
- /** Sort order. */
2149
- order?: SortOrder;
2150
- }
2151
- declare enum SortOrder {
2152
- ASC = "ASC",
2153
- DESC = "DESC"
2154
- }
2155
- /** TODO Diverge */
2156
- interface CursorPaging$4 {
2157
- /**
2158
- * Number of events to return.
2159
- * Defaults to `50`. Maximum `1000`.
2160
- */
2161
- limit?: number | null;
2162
- /**
2163
- * Pointer to the next or previous page in the list of results.
2164
- *
2165
- * You can get the relevant cursor token
2166
- * from the `pagingMetadata` object in the previous call's response.
2167
- * Not relevant for the first request.
2168
- */
2169
- cursor?: string | null;
2170
- }
2171
- interface QueryEventsResponse {
2172
- /** Retrieved events matching the provided query. */
2173
- events?: Event[];
2174
- /** Paging metadata. */
2175
- pagingMetadata?: CursorPagingMetadata$4;
2176
- }
2177
- /** TODO Diverge */
2178
- interface CursorPagingMetadata$4 {
2179
- /** Number of items returned in the response. */
2180
- count?: number | null;
2181
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
2182
- cursors?: Cursors$4;
2183
- /**
2184
- * Indicates if there are more results after the current page.
2185
- * If `true`, another page of results can be retrieved.
2186
- * If `false`, this is the last page.
2187
- */
2188
- hasNext?: boolean | null;
2189
- }
2190
- interface Cursors$4 {
2191
- /** Cursor pointing to next page in the list of results. */
2192
- next?: string | null;
2193
- }
2194
- interface CreateEventRequest {
2195
- /** Event to create. */
2196
- event: Event;
2197
- /**
2198
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2199
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2200
- * `America/New_York` or `UTC`.
2201
- *
2202
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2203
- */
2204
- timeZone?: string | null;
2205
- /**
2206
- * Idempotency key guaranteeing that you don't create the same event more
2207
- * than once.
2208
- */
2209
- idempotencyKey?: string | null;
2210
- }
2211
- interface CreateEventResponse {
2212
- /** Created event. */
2213
- event?: Event;
2214
- }
2215
- interface BulkCreateEventRequest {
2216
- /** Events to create. */
2217
- events: MaskedEvent[];
2218
- /**
2219
- * Whether to return created events.
2220
- *
2221
- * Default: `false`.
2222
- */
2223
- returnEntity?: boolean | null;
2224
- /**
2225
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2226
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2227
- * `America/New_York` or `UTC`.
2228
- *
2229
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2230
- */
2231
- timeZone?: string | null;
2232
- }
2233
- interface MaskedEvent {
2234
- /** Event to create. */
2235
- event?: Event;
2236
- }
2237
- interface BulkCreateEventResponse {
2238
- /** The result for each event, containing the event and whether the action was successful. */
2239
- results?: BulkEventResult[];
2240
- /** Total successes and failures. */
2241
- bulkActionMetadata?: BulkActionMetadata;
2242
- }
2243
- interface BulkEventResult {
2244
- /** Whether the requested action was successful. */
2245
- itemMetadata?: ItemMetadata;
2246
- /** The event. */
2247
- item?: Event;
2248
- }
2249
- interface ItemMetadata {
2250
- /**
2251
- * Event ID.
2252
- * Should always be available, unless it's impossible (for example, when failing to create an event).
2253
- */
2254
- _id?: string | null;
2255
- /** Index of the item within the request array, for correlation between request and response items. */
2256
- originalIndex?: number;
2257
- /**
2258
- * Whether the requested action was successful for this event.
2259
- * When `false`, the `error` field is populated.
2260
- */
2261
- success?: boolean;
2262
- /** Details about the error in case of failure. */
2263
- error?: ApplicationError;
2264
- }
2265
- interface ApplicationError {
2266
- /** Error code. */
2267
- code?: string;
2268
- /** Description of the error. */
2269
- description?: string;
2270
- /** Data related to the error. */
2271
- data?: Record<string, any> | null;
2272
- }
2273
- interface BulkActionMetadata {
2274
- /** Number of events that were successfully processed. */
2275
- totalSuccesses?: number;
2276
- /** Number of events that couldn't be processed. */
2277
- totalFailures?: number;
2278
- }
2279
- interface UpdateEventRequest {
2280
- /** Event to update. */
2281
- event: Event;
2282
- /**
2283
- * Information about whether participants of the updated event are notified and
2284
- * the message they receive.
2285
- */
2286
- participantNotification?: ParticipantNotification$2;
2287
- /**
2288
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2289
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2290
- * `America/New_York` or `UTC`.
2291
- *
2292
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2293
- */
2294
- timeZone?: string | null;
2295
- }
2296
- interface ParticipantNotification$2 {
2297
- /**
2298
- * Whether to notify the participants about changes made to the schedule or event.
2299
- *
2300
- * Default: `false`
2301
- */
2302
- notifyParticipants?: boolean | null;
2303
- /**
2304
- * Message to send.
2305
- *
2306
- * Min: 1 character
2307
- * Max: 5000 characters
2308
- */
2309
- message?: string | null;
2310
- }
2311
- interface UpdateEventResponse {
2312
- /** Updated event. */
2313
- event?: Event;
2314
- }
2315
- interface BulkUpdateEventRequest {
2316
- /**
2317
- * Events to update.
2318
- *
2319
- * Min: 1 event
2320
- * Max: 50 events
2321
- */
2322
- events: BulkUpdateEventRequestMaskedEvent[];
2323
- /**
2324
- * Whether to return the updated events.
2325
- *
2326
- * Default: `false`
2327
- */
2328
- returnEntity?: boolean | null;
2329
- /**
2330
- * Information about whether participants of the updated event are notified and
2331
- * the message they receive.
2332
- */
2333
- participantNotification?: ParticipantNotification$2;
2334
- /**
2335
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2336
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2337
- * `America/New_York` or `UTC`.
2338
- *
2339
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2340
- */
2341
- timeZone?: string | null;
2342
- }
2343
- interface BulkUpdateEventRequestMaskedEvent {
2344
- /** Event to update. */
2345
- event?: Event;
2346
- }
2347
- interface BulkUpdateEventResponse {
2348
- /** The result for each event, containing the event and whether the action was successful. */
2349
- results?: BulkEventResult[];
2350
- /** Total successes and failures. */
2351
- bulkActionMetadata?: BulkActionMetadata;
2352
- }
2353
- interface RestoreEventDefaultsRequest {
2354
- /** ID of the event for which to restore default values. */
2355
- eventId: string | null;
2356
- /**
2357
- * Fields for which to restore default values.
2358
- *
2359
- * `TIME` restores default values for `start` and `end`.
2360
- *
2361
- * Min: 1 field
2362
- */
2363
- fields: Field[];
2364
- /**
2365
- * Information about whether participants of the updated event are notified and
2366
- * the message they receive.
2367
- */
2368
- participantNotification?: ParticipantNotification$2;
2369
- /**
2370
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2371
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2372
- * `America/New_York` or `UTC`.
2373
- *
2374
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2375
- */
2376
- timeZone?: string | null;
2377
- }
2378
- interface RestoreEventDefaultsResponse {
2379
- /** Updated event. */
2380
- event?: Event;
2381
- }
2382
- interface SplitRecurringEventRequest {
2383
- /** ID of the `MASTER` event to split. */
2384
- recurringEventId: string | null;
2385
- /**
2386
- * Local date and time at which the `MASTER` event is split in
2387
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2388
- * `2025-03-11T09:00:00`.
2389
- * Must be a future date that's after the `start` date of the next `INSTANCE` or
2390
- * `EXCEPTION` event in the series. Additionally, there must be another
2391
- * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
2392
- * wouldn't affect any event without a subsequent occurrence.
2393
- */
2394
- splitLocalDate: string | null;
2395
- /**
2396
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2397
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2398
- * `America/New_York` or `UTC`.
2399
- *
2400
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2401
- */
2402
- timeZone?: string | null;
2403
- }
2404
- interface SplitRecurringEventResponse {
2405
- /** Original `MASTER` event that was shortened. */
2406
- updatedRecurringEventEndingBeforeSplit?: Event;
2407
- /** New `MASTER` event starting with the first event after the split date. */
2408
- newRecurringEventStartingFromSplit?: Event;
2409
- }
2410
- interface CancelEventRequest {
2411
- /** ID of the event to cancel. */
2412
- eventId: string | null;
2413
- /**
2414
- * Information about whether participants of the canceled event are notified and
2415
- * the message they receive.
2416
- */
2417
- participantNotification?: ParticipantNotification$2;
2418
- /**
2419
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2420
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2421
- * `America/New_York` or `UTC`.
2422
- *
2423
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2424
- */
2425
- timeZone?: string | null;
2426
- }
2427
- interface CancelEventResponse {
2428
- /** Canceled event. */
2429
- event?: Event;
2430
- }
2431
- interface BulkCancelEventRequest {
2432
- /** IDs of the events to cancel. */
2433
- eventIds: string[];
2434
- /**
2435
- * Whether to return the canceled events.
2436
- *
2437
- * Default: `false`
2438
- */
2439
- returnEntity?: boolean | null;
2440
- /**
2441
- * Information about whether participants of the canceled events are notified and
2442
- * the message they receive.
2443
- */
2444
- participantNotification?: ParticipantNotification$2;
2445
- /**
2446
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2447
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2448
- * `America/New_York` or `UTC`.
2449
- *
2450
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2451
- */
2452
- timeZone?: string | null;
2453
- }
2454
- interface BulkCancelEventResponse {
2455
- /** The result for each event, containing the event and whether the action was successful. */
2456
- results?: BulkEventResult[];
2457
- /** Total successes and failures. */
2458
- bulkActionMetadata?: BulkActionMetadata;
2459
- }
2460
- interface RecurrenceRuleNonNullableFields {
2461
- frequency: Frequency;
2462
- days: Day[];
2463
- }
2464
- interface LocationNonNullableFields$2 {
2465
- type: LocationType$2;
2466
- }
2467
- interface ResourceNonNullableFields {
2468
- transparency: Transparency;
2469
- permissionRole: Role$2;
2470
- }
2471
- interface ParticipantsNonNullableFields {
2472
- status: ParticipantsStatus;
2473
- }
2474
- interface ConferencingDetailsNonNullableFields$2 {
2475
- type: Type$2;
2476
- }
2477
- interface CommonIdentificationDataNonNullableFields$2 {
2478
- wixUserId: string;
2479
- identityType: IdentityType$2;
2480
- }
2481
- interface PermissionNonNullableFields$2 {
2482
- identity?: CommonIdentificationDataNonNullableFields$2;
2483
- role: Role$2;
2484
- }
2485
- interface EventNonNullableFields {
2486
- status: Status$6;
2487
- recurrenceType: RecurrenceType;
2488
- recurrenceRule?: RecurrenceRuleNonNullableFields;
2489
- transparency: Transparency;
2490
- location?: LocationNonNullableFields$2;
2491
- resources: ResourceNonNullableFields[];
2492
- participants?: ParticipantsNonNullableFields;
2493
- conferencingDetails?: ConferencingDetailsNonNullableFields$2;
2494
- inheritedFields: Field[];
2495
- permissions: PermissionNonNullableFields$2[];
2496
- }
2497
- interface ListEventsByContactIdResponseNonNullableFields {
2498
- events: EventNonNullableFields[];
2499
- }
2500
- interface ListEventsByMemberIdResponseNonNullableFields {
2501
- events: EventNonNullableFields[];
2502
- }
2503
- interface GetEventResponseNonNullableFields {
2504
- event?: EventNonNullableFields;
2505
- }
2506
- interface ListEventsResponseNonNullableFields {
2507
- events: EventNonNullableFields[];
2508
- }
2509
- interface QueryEventsResponseNonNullableFields {
2510
- events: EventNonNullableFields[];
2511
- }
2512
- interface CreateEventResponseNonNullableFields {
2513
- event?: EventNonNullableFields;
2514
- }
2515
- interface ApplicationErrorNonNullableFields {
2516
- code: string;
2517
- description: string;
2518
- }
2519
- interface ItemMetadataNonNullableFields {
2520
- originalIndex: number;
2521
- success: boolean;
2522
- error?: ApplicationErrorNonNullableFields;
2523
- }
2524
- interface BulkEventResultNonNullableFields {
2525
- itemMetadata?: ItemMetadataNonNullableFields;
2526
- item?: EventNonNullableFields;
2527
- }
2528
- interface BulkActionMetadataNonNullableFields {
2529
- totalSuccesses: number;
2530
- totalFailures: number;
2531
- }
2532
- interface BulkCreateEventResponseNonNullableFields {
2533
- results: BulkEventResultNonNullableFields[];
2534
- bulkActionMetadata?: BulkActionMetadataNonNullableFields;
2535
- }
2536
- interface UpdateEventResponseNonNullableFields {
2537
- event?: EventNonNullableFields;
2538
- }
2539
- interface BulkUpdateEventResponseNonNullableFields {
2540
- results: BulkEventResultNonNullableFields[];
2541
- bulkActionMetadata?: BulkActionMetadataNonNullableFields;
2542
- }
2543
- interface RestoreEventDefaultsResponseNonNullableFields {
2544
- event?: EventNonNullableFields;
2545
- }
2546
- interface SplitRecurringEventResponseNonNullableFields {
2547
- updatedRecurringEventEndingBeforeSplit?: EventNonNullableFields;
2548
- newRecurringEventStartingFromSplit?: EventNonNullableFields;
2549
- }
2550
- interface CancelEventResponseNonNullableFields {
2551
- event?: EventNonNullableFields;
2552
- }
2553
- interface BulkCancelEventResponseNonNullableFields {
2554
- results: BulkEventResultNonNullableFields[];
2555
- bulkActionMetadata?: BulkActionMetadataNonNullableFields;
2556
- }
2557
-
2558
- type __PublicMethodMetaInfo$4<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
2559
- getUrl: (context: any) => string;
2560
- httpMethod: K;
2561
- path: string;
2562
- pathParams: M;
2563
- __requestType: T;
2564
- __originalRequestType: S;
2565
- __responseType: Q;
2566
- __originalResponseType: R;
2567
- };
2568
- declare function listEventsByContactId(): __PublicMethodMetaInfo$4<'GET', {
2569
- contactId: string;
2570
- }, ListEventsByContactIdRequest, ListEventsByContactIdRequest$1, ListEventsByContactIdResponse & ListEventsByContactIdResponseNonNullableFields, ListEventsByContactIdResponse$1 & ListEventsByContactIdResponseNonNullableFields$1>;
2571
- declare function listEventsByMemberId(): __PublicMethodMetaInfo$4<'GET', {
2572
- memberId: string;
2573
- }, ListEventsByMemberIdRequest, ListEventsByMemberIdRequest$1, ListEventsByMemberIdResponse & ListEventsByMemberIdResponseNonNullableFields, ListEventsByMemberIdResponse$1 & ListEventsByMemberIdResponseNonNullableFields$1>;
2574
- declare function getEvent(): __PublicMethodMetaInfo$4<'GET', {
2575
- eventId: string;
2576
- }, GetEventRequest, GetEventRequest$1, GetEventResponse & GetEventResponseNonNullableFields, GetEventResponse$1 & GetEventResponseNonNullableFields$1>;
2577
- declare function listEvents(): __PublicMethodMetaInfo$4<'GET', {}, ListEventsRequest, ListEventsRequest$1, ListEventsResponse & ListEventsResponseNonNullableFields, ListEventsResponse$1 & ListEventsResponseNonNullableFields$1>;
2578
- declare function queryEvents(): __PublicMethodMetaInfo$4<'POST', {}, QueryEventsRequest, QueryEventsRequest$1, QueryEventsResponse & QueryEventsResponseNonNullableFields, QueryEventsResponse$1 & QueryEventsResponseNonNullableFields$1>;
2579
- declare function createEvent(): __PublicMethodMetaInfo$4<'POST', {}, CreateEventRequest, CreateEventRequest$1, CreateEventResponse & CreateEventResponseNonNullableFields, CreateEventResponse$1 & CreateEventResponseNonNullableFields$1>;
2580
- declare function bulkCreateEvent(): __PublicMethodMetaInfo$4<'POST', {}, BulkCreateEventRequest, BulkCreateEventRequest$1, BulkCreateEventResponse & BulkCreateEventResponseNonNullableFields, BulkCreateEventResponse$1 & BulkCreateEventResponseNonNullableFields$1>;
2581
- declare function updateEvent(): __PublicMethodMetaInfo$4<'PATCH', {
2582
- eventId: string;
2583
- }, UpdateEventRequest, UpdateEventRequest$1, UpdateEventResponse & UpdateEventResponseNonNullableFields, UpdateEventResponse$1 & UpdateEventResponseNonNullableFields$1>;
2584
- declare function bulkUpdateEvent(): __PublicMethodMetaInfo$4<'POST', {}, BulkUpdateEventRequest, BulkUpdateEventRequest$1, BulkUpdateEventResponse & BulkUpdateEventResponseNonNullableFields, BulkUpdateEventResponse$1 & BulkUpdateEventResponseNonNullableFields$1>;
2585
- declare function restoreEventDefaults(): __PublicMethodMetaInfo$4<'POST', {
2586
- eventId: string;
2587
- }, RestoreEventDefaultsRequest, RestoreEventDefaultsRequest$1, RestoreEventDefaultsResponse & RestoreEventDefaultsResponseNonNullableFields, RestoreEventDefaultsResponse$1 & RestoreEventDefaultsResponseNonNullableFields$1>;
2588
- declare function splitRecurringEvent(): __PublicMethodMetaInfo$4<'POST', {
2589
- recurringEventId: string;
2590
- }, SplitRecurringEventRequest, SplitRecurringEventRequest$1, SplitRecurringEventResponse & SplitRecurringEventResponseNonNullableFields, SplitRecurringEventResponse$1 & SplitRecurringEventResponseNonNullableFields$1>;
2591
- declare function cancelEvent(): __PublicMethodMetaInfo$4<'POST', {
2592
- eventId: string;
2593
- }, CancelEventRequest, CancelEventRequest$1, CancelEventResponse & CancelEventResponseNonNullableFields, CancelEventResponse$1 & CancelEventResponseNonNullableFields$1>;
2594
- declare function bulkCancelEvent(): __PublicMethodMetaInfo$4<'POST', {}, BulkCancelEventRequest, BulkCancelEventRequest$1, BulkCancelEventResponse & BulkCancelEventResponseNonNullableFields, BulkCancelEventResponse$1 & BulkCancelEventResponseNonNullableFields$1>;
2595
-
2596
- declare const meta$4_bulkCancelEvent: typeof bulkCancelEvent;
2597
- declare const meta$4_bulkCreateEvent: typeof bulkCreateEvent;
2598
- declare const meta$4_bulkUpdateEvent: typeof bulkUpdateEvent;
2599
- declare const meta$4_cancelEvent: typeof cancelEvent;
2600
- declare const meta$4_createEvent: typeof createEvent;
2601
- declare const meta$4_getEvent: typeof getEvent;
2602
- declare const meta$4_listEvents: typeof listEvents;
2603
- declare const meta$4_listEventsByContactId: typeof listEventsByContactId;
2604
- declare const meta$4_listEventsByMemberId: typeof listEventsByMemberId;
2605
- declare const meta$4_queryEvents: typeof queryEvents;
2606
- declare const meta$4_restoreEventDefaults: typeof restoreEventDefaults;
2607
- declare const meta$4_splitRecurringEvent: typeof splitRecurringEvent;
2608
- declare const meta$4_updateEvent: typeof updateEvent;
2609
- declare namespace meta$4 {
2610
- export { type __PublicMethodMetaInfo$4 as __PublicMethodMetaInfo, meta$4_bulkCancelEvent as bulkCancelEvent, meta$4_bulkCreateEvent as bulkCreateEvent, meta$4_bulkUpdateEvent as bulkUpdateEvent, meta$4_cancelEvent as cancelEvent, meta$4_createEvent as createEvent, meta$4_getEvent as getEvent, meta$4_listEvents as listEvents, meta$4_listEventsByContactId as listEventsByContactId, meta$4_listEventsByMemberId as listEventsByMemberId, meta$4_queryEvents as queryEvents, meta$4_restoreEventDefaults as restoreEventDefaults, meta$4_splitRecurringEvent as splitRecurringEvent, meta$4_updateEvent as updateEvent };
2611
- }
2612
-
2613
- /**
2614
- * The `eventsView` object gives you details about how far into the future you can
2615
- * easily get a complete picture of a calendar. Subscribing to the event view
2616
- * webhooks lets you keep track of a calendar's single-occurrence, `EXCEPTION`, and
2617
- * `INSTANCE` events at least one year into the future.
2618
- */
2619
- interface EventsView$1 {
2620
- /**
2621
- * End date of the event view in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2622
- * @readonly
2623
- */
2624
- endDate?: Date | null;
2625
- /**
2626
- * Number of days from now until the event view ends.
2627
- * @readonly
2628
- */
2629
- futureDurationInDays?: number | null;
2630
- }
2631
- interface GetEventsViewRequest$1 {
2632
- }
2633
- interface GetEventsViewResponse$1 {
2634
- /** Retrieved event view. */
2635
- eventsView?: EventsView$1;
2636
- }
2637
-
2638
- /**
2639
- * The `eventsView` object gives you details about how far into the future you can
2640
- * easily get a complete picture of a calendar. Subscribing to the event view
2641
- * webhooks lets you keep track of a calendar's single-occurrence, `EXCEPTION`, and
2642
- * `INSTANCE` events at least one year into the future.
2643
- */
2644
- interface EventsView {
2645
- /**
2646
- * End date of the event view in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2647
- * @readonly
2648
- */
2649
- endDate?: Date | null;
2650
- /**
2651
- * Number of days from now until the event view ends.
2652
- * @readonly
2653
- */
2654
- futureDurationInDays?: number | null;
2655
- }
2656
- interface GetEventsViewRequest {
2657
- }
2658
- interface GetEventsViewResponse {
2659
- /** Retrieved event view. */
2660
- eventsView?: EventsView;
2661
- }
2662
-
2663
- type __PublicMethodMetaInfo$3<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
2664
- getUrl: (context: any) => string;
2665
- httpMethod: K;
2666
- path: string;
2667
- pathParams: M;
2668
- __requestType: T;
2669
- __originalRequestType: S;
2670
- __responseType: Q;
2671
- __originalResponseType: R;
2672
- };
2673
- declare function getEventsView(): __PublicMethodMetaInfo$3<'GET', {}, GetEventsViewRequest, GetEventsViewRequest$1, GetEventsViewResponse, GetEventsViewResponse$1>;
2674
-
2675
- declare const meta$3_getEventsView: typeof getEventsView;
2676
- declare namespace meta$3 {
2677
- export { type __PublicMethodMetaInfo$3 as __PublicMethodMetaInfo, meta$3_getEventsView as getEventsView };
2678
- }
2679
-
2680
- /**
2681
- * The `participation` object represents the relationship between a participant and
2682
- * an [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2683
- * or [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
2684
- * It includes details about the participant, whether the participation status is confirmed or
2685
- * pending, which app owns the relevant event or schedule, and allows for custom data extensions.
2686
- */
2687
- interface Participation$1 extends ParticipationParticipatedItemOneOf$1 {
2688
- /**
2689
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2690
- * associated with the participation.
2691
- */
2692
- scheduleId?: string | null;
2693
- /**
2694
- * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2695
- * associated with the participation.
2696
- */
2697
- eventId?: string | null;
2698
- /**
2699
- * Participation ID.
2700
- * @readonly
2701
- */
2702
- id?: string | null;
2703
- /** External ID. */
2704
- externalId?: string | null;
2705
- /** Information about the participant. */
2706
- participant?: Participant$1;
2707
- /**
2708
- * Party size of the group or `1` for individuals.
2709
- *
2710
- * Min: `1`
2711
- * Max: `1000`
2712
- */
2713
- partySize?: number | null;
2714
- /**
2715
- * Status of the party's participation in the event. Depending on your
2716
- * implementation, confirmation may be handled by the business owner or the customer.
2717
- *
2718
- * Supported values:
2719
- * + `CONFIRMED`: The party's participation is confirmed. For example, the business owner has confirmed a [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings).
2720
- * + `PENDING_CONFIRMATION`: The party's participation is awaiting confirmation. For example, the business owner still needs to approve the [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings).
2721
- *
2722
- * Default: `CONFIRMED`
2723
- */
2724
- status?: Status$5;
2725
- /**
2726
- * ID of the app that owns the participation `object`. Identical to `appId` of the
2727
- * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2728
- * that the related
2729
- * [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2730
- * belongs to.
2731
- * @readonly
2732
- */
2733
- appId?: string | null;
2734
- /**
2735
- * Revision number, which increments by 1 each time the participation is updated.
2736
- * To prevent conflicting changes, the current revision must be passed when updating the participation.
2737
- * Ignored when creating a participation.
2738
- * @readonly
2739
- */
2740
- revision?: string | null;
2741
- /**
2742
- * Date the participation was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2743
- * @readonly
2744
- */
2745
- createdDate?: Date | null;
2746
- /**
2747
- * Date the participation was updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2748
- * @readonly
2749
- */
2750
- updatedDate?: Date | null;
2751
- /** Extensions enabling applications or users to save custom data related to the participation. */
2752
- extendedFields?: ExtendedFields$3;
2753
- }
2754
- /** @oneof */
2755
- interface ParticipationParticipatedItemOneOf$1 {
2756
- /**
2757
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2758
- * associated with the participation.
2759
- */
2760
- scheduleId?: string | null;
2761
- /**
2762
- * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2763
- * associated with the participation.
2764
- */
2765
- eventId?: string | null;
2766
- }
2767
- interface Participant$1 {
2768
- /**
2769
- * Participant name.
2770
- *
2771
- * Min: 1 character
2772
- * Max: 200 characters
2773
- */
2774
- name?: string | null;
2775
- /** Participant's phone number. */
2776
- phone?: string | null;
2777
- /** Participant's email address. */
2778
- email?: string | null;
2779
- /**
2780
- * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
2781
- * ID of the parcipant.
2782
- */
2783
- contactId?: string | null;
2784
- }
2785
- declare enum Status$5 {
2786
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
2787
- /** The party's participation is confirmed. For example, the business owner has confirmed a [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings). */
2788
- CONFIRMED = "CONFIRMED",
2789
- /** The party's participation is awaiting confirmation. For example, the business owner still needs to approve the [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings). */
2790
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
2791
- }
2792
- interface ExtendedFields$3 {
2793
- /**
2794
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
2795
- * The value of each key is structured according to the schema defined when the extended fields were configured.
2796
- *
2797
- * You can only access fields for which you have the appropriate permissions.
2798
- *
2799
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
2800
- */
2801
- namespaces?: Record<string, Record<string, any>>;
2802
- }
2803
- interface GetParticipationRequest$1 {
2804
- /** ID of the `participation` object to retrieve. */
2805
- participationId: string | null;
2806
- }
2807
- interface GetParticipationResponse$1 {
2808
- /** Retrieved `participation` object. */
2809
- participation?: Participation$1;
2810
- }
2811
- interface QueryParticipationsRequest$1 {
2812
- /** Query containing filters and paging. */
2813
- query?: CursorQuery$3;
2814
- }
2815
- interface CursorQuery$3 extends CursorQueryPagingMethodOneOf$3 {
2816
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2817
- cursorPaging?: CursorPaging$3;
2818
- /**
2819
- * Filter object in the following format:
2820
- * `"filter" : {
2821
- * "fieldName1": "value1",
2822
- * "fieldName2":{"$operator":"value2"}
2823
- * }`
2824
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
2825
- */
2826
- filter?: Record<string, any> | null;
2827
- }
2828
- /** @oneof */
2829
- interface CursorQueryPagingMethodOneOf$3 {
2830
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2831
- cursorPaging?: CursorPaging$3;
2832
- }
2833
- interface CursorPaging$3 {
2834
- /** Number of participations to load. */
2835
- limit?: number | null;
2836
- /**
2837
- * Pointer to the next or previous page in the list of results.
2838
- *
2839
- * You can get the relevant cursor token
2840
- * from the `pagingMetadata` object in the previous call's response.
2841
- * Not relevant for the first request.
2842
- */
2843
- cursor?: string | null;
2844
- }
2845
- interface QueryParticipationsResponse$1 {
2846
- /** Retrieved `participation` objects matching the provided query. */
2847
- participations?: Participation$1[];
2848
- /** Paging metadata. */
2849
- pagingMetadata?: CursorPagingMetadata$3;
2850
- }
2851
- interface CursorPagingMetadata$3 {
2852
- /** Number of items returned in the response. */
2853
- count?: number | null;
2854
- /** Offset that was requested. */
2855
- cursors?: Cursors$3;
2856
- /**
2857
- * Indicates if there are more results after the current page.
2858
- * If `true`, another page of results can be retrieved.
2859
- * If `false`, this is the last page.
2860
- */
2861
- hasNext?: boolean | null;
2862
- }
2863
- interface Cursors$3 {
2864
- /** Cursor pointing to next page in the list of results. */
2865
- next?: string | null;
2866
- /** Cursor pointing to previous page in the list of results. */
2867
- prev?: string | null;
2868
- }
2869
- interface CreateParticipationRequest$1 {
2870
- /** `participation` object to create. */
2871
- participation: Participation$1;
2872
- /**
2873
- * Idempotency key guaranteeing that you don't create the same `participation`
2874
- * object more than once.
2875
- */
2876
- idempotencyKey?: string | null;
2877
- }
2878
- interface CreateParticipationResponse$1 {
2879
- /** Created `participation` object. */
2880
- participation?: Participation$1;
2881
- }
2882
- interface UpdateParticipationRequest$1 {
2883
- /** `participation` object to update. */
2884
- participation: Participation$1;
2885
- }
2886
- interface UpdateParticipationResponse$1 {
2887
- /** Updated `participation` object. */
2888
- participation?: Participation$1;
2889
- }
2890
- interface DeleteParticipationRequest$1 {
2891
- /** ID of `participation` object to delete. */
2892
- participationId: string | null;
2893
- }
2894
- interface DeleteParticipationResponse$1 {
2895
- }
2896
- interface ParticipationNonNullableFields$1 {
2897
- status: Status$5;
2898
- }
2899
- interface GetParticipationResponseNonNullableFields$1 {
2900
- participation?: ParticipationNonNullableFields$1;
2901
- }
2902
- interface QueryParticipationsResponseNonNullableFields$1 {
2903
- participations: ParticipationNonNullableFields$1[];
2904
- }
2905
- interface CreateParticipationResponseNonNullableFields$1 {
2906
- participation?: ParticipationNonNullableFields$1;
2907
- }
2908
- interface UpdateParticipationResponseNonNullableFields$1 {
2909
- participation?: ParticipationNonNullableFields$1;
2910
- }
2911
-
2912
- /**
2913
- * The `participation` object represents the relationship between a participant and
2914
- * an [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2915
- * or [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
2916
- * It includes details about the participant, whether the participation status is confirmed or
2917
- * pending, which app owns the relevant event or schedule, and allows for custom data extensions.
2918
- */
2919
- interface Participation extends ParticipationParticipatedItemOneOf {
2920
- /**
2921
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2922
- * associated with the participation.
2923
- */
2924
- scheduleId?: string | null;
2925
- /**
2926
- * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2927
- * associated with the participation.
2928
- */
2929
- eventId?: string | null;
2930
- /**
2931
- * Participation ID.
2932
- * @readonly
2933
- */
2934
- _id?: string | null;
2935
- /** External ID. */
2936
- externalId?: string | null;
2937
- /** Information about the participant. */
2938
- participant?: Participant;
2939
- /**
2940
- * Party size of the group or `1` for individuals.
2941
- *
2942
- * Min: `1`
2943
- * Max: `1000`
2944
- */
2945
- partySize?: number | null;
2946
- /**
2947
- * Status of the party's participation in the event. Depending on your
2948
- * implementation, confirmation may be handled by the business owner or the customer.
2949
- *
2950
- * Supported values:
2951
- * + `CONFIRMED`: The party's participation is confirmed. For example, the business owner has confirmed a [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings).
2952
- * + `PENDING_CONFIRMATION`: The party's participation is awaiting confirmation. For example, the business owner still needs to approve the [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings).
2953
- *
2954
- * Default: `CONFIRMED`
2955
- */
2956
- status?: Status$4;
2957
- /**
2958
- * ID of the app that owns the participation `object`. Identical to `appId` of the
2959
- * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2960
- * that the related
2961
- * [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2962
- * belongs to.
2963
- * @readonly
2964
- */
2965
- appId?: string | null;
2966
- /**
2967
- * Revision number, which increments by 1 each time the participation is updated.
2968
- * To prevent conflicting changes, the current revision must be passed when updating the participation.
2969
- * Ignored when creating a participation.
2970
- * @readonly
2971
- */
2972
- revision?: string | null;
2973
- /**
2974
- * Date the participation was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2975
- * @readonly
2976
- */
2977
- _createdDate?: Date | null;
2978
- /**
2979
- * Date the participation was updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2980
- * @readonly
2981
- */
2982
- _updatedDate?: Date | null;
2983
- /** Extensions enabling applications or users to save custom data related to the participation. */
2984
- extendedFields?: ExtendedFields$2;
2985
- }
2986
- /** @oneof */
2987
- interface ParticipationParticipatedItemOneOf {
2988
- /**
2989
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
2990
- * associated with the participation.
2991
- */
2992
- scheduleId?: string | null;
2993
- /**
2994
- * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
2995
- * associated with the participation.
2996
- */
2997
- eventId?: string | null;
2998
- }
2999
- interface Participant {
3000
- /**
3001
- * Participant name.
3002
- *
3003
- * Min: 1 character
3004
- * Max: 200 characters
3005
- */
3006
- name?: string | null;
3007
- /** Participant's phone number. */
3008
- phone?: string | null;
3009
- /** Participant's email address. */
3010
- email?: string | null;
3011
- /**
3012
- * [Contact](https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/introduction)
3013
- * ID of the participant.
3014
- */
3015
- contactId?: string | null;
3016
- }
3017
- declare enum Status$4 {
3018
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
3019
- /** The party's participation is confirmed. For example, the business owner has confirmed a [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings). */
3020
- CONFIRMED = "CONFIRMED",
3021
- /** The party's participation is awaiting confirmation. For example, the business owner still needs to approve the [booking](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings). */
3022
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
3023
- }
3024
- interface ExtendedFields$2 {
3025
- /**
3026
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
3027
- * The value of each key is structured according to the schema defined when the extended fields were configured.
3028
- *
3029
- * You can only access fields for which you have the appropriate permissions.
3030
- *
3031
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
3032
- */
3033
- namespaces?: Record<string, Record<string, any>>;
3034
- }
3035
- interface GetParticipationRequest {
3036
- /** ID of the `participation` object to retrieve. */
3037
- participationId: string | null;
3038
- }
3039
- interface GetParticipationResponse {
3040
- /** Retrieved `participation` object. */
3041
- participation?: Participation;
3042
- }
3043
- interface QueryParticipationsRequest {
3044
- /** Query containing filters and paging. */
3045
- query?: CursorQuery$2;
3046
- }
3047
- interface CursorQuery$2 extends CursorQueryPagingMethodOneOf$2 {
3048
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3049
- cursorPaging?: CursorPaging$2;
3050
- /**
3051
- * Filter object in the following format:
3052
- * `"filter" : {
3053
- * "fieldName1": "value1",
3054
- * "fieldName2":{"$operator":"value2"}
3055
- * }`
3056
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
3057
- */
3058
- filter?: Record<string, any> | null;
3059
- }
3060
- /** @oneof */
3061
- interface CursorQueryPagingMethodOneOf$2 {
3062
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3063
- cursorPaging?: CursorPaging$2;
3064
- }
3065
- interface CursorPaging$2 {
3066
- /** Number of participations to load. */
3067
- limit?: number | null;
3068
- /**
3069
- * Pointer to the next or previous page in the list of results.
3070
- *
3071
- * You can get the relevant cursor token
3072
- * from the `pagingMetadata` object in the previous call's response.
3073
- * Not relevant for the first request.
3074
- */
3075
- cursor?: string | null;
3076
- }
3077
- interface QueryParticipationsResponse {
3078
- /** Retrieved `participation` objects matching the provided query. */
3079
- participations?: Participation[];
3080
- /** Paging metadata. */
3081
- pagingMetadata?: CursorPagingMetadata$2;
3082
- }
3083
- interface CursorPagingMetadata$2 {
3084
- /** Number of items returned in the response. */
3085
- count?: number | null;
3086
- /** Offset that was requested. */
3087
- cursors?: Cursors$2;
3088
- /**
3089
- * Indicates if there are more results after the current page.
3090
- * If `true`, another page of results can be retrieved.
3091
- * If `false`, this is the last page.
3092
- */
3093
- hasNext?: boolean | null;
3094
- }
3095
- interface Cursors$2 {
3096
- /** Cursor pointing to next page in the list of results. */
3097
- next?: string | null;
3098
- /** Cursor pointing to previous page in the list of results. */
3099
- prev?: string | null;
3100
- }
3101
- interface CreateParticipationRequest {
3102
- /** `participation` object to create. */
3103
- participation: Participation;
3104
- /**
3105
- * Idempotency key guaranteeing that you don't create the same `participation`
3106
- * object more than once.
3107
- */
3108
- idempotencyKey?: string | null;
3109
- }
3110
- interface CreateParticipationResponse {
3111
- /** Created `participation` object. */
3112
- participation?: Participation;
3113
- }
3114
- interface UpdateParticipationRequest {
3115
- /** `participation` object to update. */
3116
- participation: Participation;
3117
- }
3118
- interface UpdateParticipationResponse {
3119
- /** Updated `participation` object. */
3120
- participation?: Participation;
3121
- }
3122
- interface DeleteParticipationRequest {
3123
- /** ID of `participation` object to delete. */
3124
- participationId: string | null;
3125
- }
3126
- interface DeleteParticipationResponse {
3127
- }
3128
- interface ParticipationNonNullableFields {
3129
- status: Status$4;
3130
- }
3131
- interface GetParticipationResponseNonNullableFields {
3132
- participation?: ParticipationNonNullableFields;
3133
- }
3134
- interface QueryParticipationsResponseNonNullableFields {
3135
- participations: ParticipationNonNullableFields[];
3136
- }
3137
- interface CreateParticipationResponseNonNullableFields {
3138
- participation?: ParticipationNonNullableFields;
3139
- }
3140
- interface UpdateParticipationResponseNonNullableFields {
3141
- participation?: ParticipationNonNullableFields;
3142
- }
3143
-
3144
- type __PublicMethodMetaInfo$2<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
3145
- getUrl: (context: any) => string;
3146
- httpMethod: K;
3147
- path: string;
3148
- pathParams: M;
3149
- __requestType: T;
3150
- __originalRequestType: S;
3151
- __responseType: Q;
3152
- __originalResponseType: R;
3153
- };
3154
- declare function getParticipation(): __PublicMethodMetaInfo$2<'GET', {
3155
- participationId: string;
3156
- }, GetParticipationRequest, GetParticipationRequest$1, GetParticipationResponse & GetParticipationResponseNonNullableFields, GetParticipationResponse$1 & GetParticipationResponseNonNullableFields$1>;
3157
- declare function queryParticipations(): __PublicMethodMetaInfo$2<'POST', {}, QueryParticipationsRequest, QueryParticipationsRequest$1, QueryParticipationsResponse & QueryParticipationsResponseNonNullableFields, QueryParticipationsResponse$1 & QueryParticipationsResponseNonNullableFields$1>;
3158
- declare function createParticipation(): __PublicMethodMetaInfo$2<'POST', {}, CreateParticipationRequest, CreateParticipationRequest$1, CreateParticipationResponse & CreateParticipationResponseNonNullableFields, CreateParticipationResponse$1 & CreateParticipationResponseNonNullableFields$1>;
3159
- declare function updateParticipation(): __PublicMethodMetaInfo$2<'PATCH', {
3160
- participationId: string;
3161
- }, UpdateParticipationRequest, UpdateParticipationRequest$1, UpdateParticipationResponse & UpdateParticipationResponseNonNullableFields, UpdateParticipationResponse$1 & UpdateParticipationResponseNonNullableFields$1>;
3162
- declare function deleteParticipation(): __PublicMethodMetaInfo$2<'DELETE', {
3163
- participationId: string;
3164
- }, DeleteParticipationRequest, DeleteParticipationRequest$1, DeleteParticipationResponse, DeleteParticipationResponse$1>;
3165
-
3166
- declare const meta$2_createParticipation: typeof createParticipation;
3167
- declare const meta$2_deleteParticipation: typeof deleteParticipation;
3168
- declare const meta$2_getParticipation: typeof getParticipation;
3169
- declare const meta$2_queryParticipations: typeof queryParticipations;
3170
- declare const meta$2_updateParticipation: typeof updateParticipation;
3171
- declare namespace meta$2 {
3172
- export { type __PublicMethodMetaInfo$2 as __PublicMethodMetaInfo, meta$2_createParticipation as createParticipation, meta$2_deleteParticipation as deleteParticipation, meta$2_getParticipation as getParticipation, meta$2_queryParticipations as queryParticipations, meta$2_updateParticipation as updateParticipation };
3173
- }
3174
-
3175
- /**
3176
- * A collection of [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3177
- * associated with a specific entity, such as a
3178
- * [Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object),
3179
- * or [Bookings resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
3180
- * Schedules can also serve as templates for the events they manage, setting
3181
- * default values like a default location.
3182
- */
3183
- interface Schedule$1 {
3184
- /**
3185
- * Schedule ID.
3186
- * @readonly
3187
- */
3188
- id?: string | null;
3189
- /**
3190
- * External ID. You can't update the external ID.
3191
- *
3192
- * If the schedule belongs to a Bookings staff member, identical to the ID of
3193
- * the [resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
3194
- * If the schedule belongs to a Bookings service, identical to the ID of
3195
- * the [service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object).
3196
- */
3197
- externalId?: string | null;
3198
- /**
3199
- * Schedule name.
3200
- *
3201
- * Min: 1 character
3202
- * Max: 200 characters
3203
- */
3204
- name?: string | null;
3205
- /**
3206
- * Schedule status.
3207
- *
3208
- * Supported values:
3209
- * - `ACTIVE`: You can add events to the schedule or update its fields.
3210
- * - `CANCELLED`: You can't add events to the schedule or update its fields.
3211
- *
3212
- * Default: `ACTIVE`
3213
- * @readonly
3214
- */
3215
- status?: Status$3;
3216
- /**
3217
- * Time zone the schedule is associated with in
3218
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
3219
- * For example, `America/New_York`.
3220
- *
3221
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
3222
- *
3223
- * Min: 1 character
3224
- * Max: 150 characters
3225
- */
3226
- timeZone?: string | null;
3227
- /**
3228
- * Whether the schedule's `timeZone` is automatically synced from
3229
- * `timeZone` of the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
3230
- *
3231
- * Default: `true`
3232
- */
3233
- businessTimeZoneEnabled?: boolean | null;
3234
- /**
3235
- * Default `title` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3236
- * that are added to the schedule.
3237
- *
3238
- * Min: 1 character
3239
- * Max: 200 characters
3240
- */
3241
- defaultTitle?: string | null;
3242
- /**
3243
- * Default `location` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3244
- * that are added to the schedule.
3245
- */
3246
- defaultLocation?: Location$1;
3247
- /**
3248
- * Default `totalCapacity` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3249
- * that are added to the schedule.
3250
- *
3251
- * Min: `0`
3252
- */
3253
- defaultCapacity?: number | null;
3254
- /**
3255
- * Default `conferencingDetails` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3256
- * that are added to the schedule.
3257
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
3258
- */
3259
- defaultConferencingDetails?: ConferencingDetails$1;
3260
- /**
3261
- * ID of the app that's associated with the schedule. You can't update `appId`.
3262
- * If you want to create a schedule and ensure its associated events appear
3263
- * in the [Bookings calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar),
3264
- * you must provide the [Wix Bookings app ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
3265
- * `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
3266
- */
3267
- appId?: string | null;
3268
- /**
3269
- * List of permissions associated with the schedule. Refer to the
3270
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
3271
- * for more information.
3272
- *
3273
- * Max: 1 permission
3274
- */
3275
- permissions?: Permission$1[];
3276
- /** Extensions enabling applications or users to save custom data related to the schedule. */
3277
- extendedFields?: ExtendedFields$1;
3278
- /**
3279
- * Revision number, which increments by 1 each time the schedule is updated.
3280
- * To prevent conflicting changes, the current revision must be passed when updating the schedule.
3281
- * Ignored when creating a schedule.
3282
- * @readonly
3283
- */
3284
- revision?: string | null;
3285
- /**
3286
- * Date the schedule was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
3287
- * @readonly
3288
- */
3289
- createdDate?: Date | null;
3290
- /**
3291
- * Date the schedule was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
3292
- * @readonly
3293
- */
3294
- updatedDate?: Date | null;
3295
- }
3296
- declare enum Status$3 {
3297
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
3298
- /** You can add events to the schedule or update its fields. */
3299
- ACTIVE = "ACTIVE",
3300
- /** You can't add events to the schedule or update its fields. */
3301
- CANCELLED = "CANCELLED"
3302
- }
3303
- interface Location$1 {
3304
- /**
3305
- * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
3306
- * ID. Available only for `BUSINESS` locations.
3307
- */
3308
- id?: string | null;
3309
- /**
3310
- * Location type.
3311
- *
3312
- * Supported values:
3313
- * + `BUSINESS`: The event is held at a business location.
3314
- * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
3315
- * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
3316
- */
3317
- type?: LocationType$1;
3318
- /**
3319
- * Location name. For `BUSINESS` locations, it's identical to the
3320
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
3321
- * `name`.
3322
- *
3323
- * Min: 1 character
3324
- * Max: 150 characters
3325
- */
3326
- name?: string | null;
3327
- /**
3328
- * Location address. For `BUSINESS` locations, it's identical to the
3329
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
3330
- * `formattedAddress`.
3331
- */
3332
- address?: string | null;
3333
- }
3334
- declare enum LocationType$1 {
3335
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
3336
- /** The event is held at a business location. */
3337
- BUSINESS = "BUSINESS",
3338
- /** The event is held at the customer's location, such as their home or office. */
3339
- CUSTOMER = "CUSTOMER",
3340
- /** The event is held at an address or venue not tied to the business or customer. */
3341
- CUSTOM = "CUSTOM"
3342
- }
3343
- interface ConferencingDetails$1 {
3344
- /** Conference type. For example, `Zoom`. */
3345
- type?: Type$1;
3346
- /**
3347
- * URL used by the host to start the conference.
3348
- *
3349
- * Min: 1 character
3350
- * Max: 2000 characters
3351
- */
3352
- hostUrl?: string | null;
3353
- /**
3354
- * URL used by a guest to join the conference.
3355
- *
3356
- * Min: 1 character
3357
- * Max: 2000 characters
3358
- */
3359
- guestUrl?: string | null;
3360
- /**
3361
- * Conference password.
3362
- *
3363
- * Min: 1 character
3364
- * Max: 100 characters
3365
- */
3366
- password?: string | null;
3367
- /**
3368
- * Conference ID in an external system.
3369
- *
3370
- * Min: 1 character
3371
- * Max: 150 characters
3372
- */
3373
- externalId?: string | null;
3374
- }
3375
- declare enum Type$1 {
3376
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
3377
- ZOOM = "ZOOM",
3378
- CUSTOM = "CUSTOM"
3379
- }
3380
- interface Permission$1 {
3381
- /**
3382
- * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
3383
- * granted the permission.
3384
- */
3385
- identity?: CommonIdentificationData$1;
3386
- /**
3387
- * Permission role.
3388
- *
3389
- * Supported values:
3390
- * + `WRITER`: Full read and write access.
3391
- * + `COMMENTER`: Full read access, write access limited to `event.notes`.
3392
- */
3393
- role?: Role$1;
3394
- }
3395
- interface CommonIdentificationData$1 extends CommonIdentificationDataIdOneOf$1 {
3396
- /**
3397
- * ID of a Wix user. For example, the site owner or a
3398
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
3399
- */
3400
- wixUserId?: string;
3401
- }
3402
- /** @oneof */
3403
- interface CommonIdentificationDataIdOneOf$1 {
3404
- /**
3405
- * ID of a Wix user. For example, the site owner or a
3406
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
3407
- */
3408
- wixUserId?: string;
3409
- }
3410
- declare enum IdentityType$1 {
3411
- UNKNOWN = "UNKNOWN",
3412
- WIX_USER = "WIX_USER"
3413
- }
3414
- declare enum Role$1 {
3415
- UNKNOWN_ROLE = "UNKNOWN_ROLE",
3416
- /** Full read and write access. */
3417
- WRITER = "WRITER",
3418
- /** Full read access, write access limited to `event.notes`. */
3419
- COMMENTER = "COMMENTER"
3420
- }
3421
- interface ExtendedFields$1 {
3422
- /**
3423
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
3424
- * The value of each key is structured according to the schema defined when the extended fields were configured.
3425
- *
3426
- * You can only access fields for which you have the appropriate permissions.
3427
- *
3428
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
3429
- */
3430
- namespaces?: Record<string, Record<string, any>>;
3431
- }
3432
- interface GetScheduleRequest$1 {
3433
- /** ID of the schedule to retrieve. */
3434
- scheduleId: string | null;
3435
- /**
3436
- * Information about which fields containing personal data to return. Refer to the
3437
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
3438
- * for more information.
3439
- *
3440
- * Supported values:
3441
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
3442
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
3443
- *
3444
- * Max: 1 field
3445
- * Default: No personal data is returned.
3446
- */
3447
- fields?: RequestedFields$1[];
3448
- }
3449
- declare enum RequestedFields$1 {
3450
- UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
3451
- /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
3452
- PI_FIELDS = "PI_FIELDS",
3453
- /** Returns only fields containing your own personal data. */
3454
- OWN_PI_FIELDS = "OWN_PI_FIELDS"
3455
- }
3456
- interface GetScheduleResponse$1 {
3457
- /** Retrieved schedule. */
3458
- schedule?: Schedule$1;
3459
- }
3460
- interface QuerySchedulesRequest$1 {
3461
- /** Query containing filters and paging. */
3462
- query?: CursorQuery$1;
3463
- /**
3464
- * Information about which fields containing personal data to return. Refer to the
3465
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
3466
- * for more information.
3467
- *
3468
- * Supported values:
3469
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
3470
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
3471
- *
3472
- * Max: 1 field
3473
- * Default: No personal data is returned.
3474
- */
3475
- fields?: RequestedFields$1[];
3476
- }
3477
- /** TODO Diverge */
3478
- interface CursorQuery$1 extends CursorQueryPagingMethodOneOf$1 {
3479
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
3480
- cursorPaging?: CursorPaging$1;
3481
- /**
3482
- * Filter object.
3483
- * See [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language)
3484
- * for more information.
3485
- *
3486
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
3487
- *
3488
- * For a detailed list of supported filters, see Supported Filters.
3489
- */
3490
- filter?: Record<string, any> | null;
3491
- }
3492
- /** @oneof */
3493
- interface CursorQueryPagingMethodOneOf$1 {
3494
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
3495
- cursorPaging?: CursorPaging$1;
3496
- }
3497
- /** TODO Diverge */
3498
- interface CursorPaging$1 {
3499
- /**
3500
- * Number of schedules to return.
3501
- *
3502
- * Min: `1`
3503
- * Max: `100`
3504
- * Default: `50`
3505
- */
3506
- limit?: number | null;
3507
- /**
3508
- * Pointer to the next or previous page in the list of results.
3509
- *
3510
- * You can get the relevant cursor token
3511
- * from the `pagingMetadata` object in the previous call's response.
3512
- * Not relevant for the first request.
3513
- */
3514
- cursor?: string | null;
3515
- }
3516
- interface QuerySchedulesResponse$1 {
3517
- /** Retrieved schedules matching the provided query. */
3518
- schedules?: Schedule$1[];
3519
- /** Paging metadata. */
3520
- pagingMetadata?: CursorPagingMetadata$1;
3521
- }
3522
- /** TODO Diverge */
3523
- interface CursorPagingMetadata$1 {
3524
- /** Number of schedules returned in the current page of the response. */
3525
- count?: number | null;
3526
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
3527
- cursors?: Cursors$1;
3528
- /**
3529
- * Indicates if there are more results after the current page.
3530
- * If `true`, another page of results can be retrieved.
3531
- * If `false`, this is the last page.
3532
- */
3533
- hasNext?: boolean | null;
3534
- }
3535
- interface Cursors$1 {
3536
- /** Cursor pointing to next page in the list of results. */
3537
- next?: string | null;
3538
- /** Cursor pointing to previous page in the list of results. */
3539
- prev?: string | null;
3540
- }
3541
- interface CreateScheduleRequest$1 {
3542
- /** Schedule to create. */
3543
- schedule: Schedule$1;
3544
- /**
3545
- * Idempotency key guaranteeing that you don't create the same schedule more
3546
- * than once.
3547
- */
3548
- idempotencyKey?: string | null;
3549
- }
3550
- interface CreateScheduleResponse$1 {
3551
- /** Created schedule. */
3552
- schedule?: Schedule$1;
3553
- }
3554
- interface UpdateScheduleRequest$1 {
3555
- /** Schedule to update. */
3556
- schedule: Schedule$1;
3557
- /**
3558
- * Information about whether participants of the schedule's updated events are
3559
- * notified and the message they receive.
3560
- */
3561
- participantNotification?: ParticipantNotification$1;
3562
- }
3563
- interface ParticipantNotification$1 {
3564
- /**
3565
- * Whether to notify the participants about changes made to the schedule or event.
3566
- *
3567
- * Default: `false`
3568
- */
3569
- notifyParticipants?: boolean | null;
3570
- /**
3571
- * Message to send.
3572
- *
3573
- * Min: 1 character
3574
- * Max: 5000 characters
3575
- */
3576
- message?: string | null;
3577
- }
3578
- interface UpdateScheduleResponse$1 {
3579
- /** Updated schedule. */
3580
- schedule?: Schedule$1;
3581
- }
3582
- interface CancelScheduleRequest$1 {
3583
- /** ID of the schedule to cancel. */
3584
- scheduleId: string | null;
3585
- /**
3586
- * Whether to preserve future events with participants.
3587
- * Default: `false`.
3588
- */
3589
- preserveFutureEventsWithParticipants?: boolean | null;
3590
- /**
3591
- * Information about whether participants of the schedule's updated events are
3592
- * notified and the message they receive.
3593
- */
3594
- participantNotification?: ParticipantNotification$1;
3595
- }
3596
- interface CancelScheduleResponse$1 {
3597
- /** Canceled schedule. */
3598
- schedule?: Schedule$1;
3599
- }
3600
- interface LocationNonNullableFields$1 {
3601
- type: LocationType$1;
3602
- }
3603
- interface ConferencingDetailsNonNullableFields$1 {
3604
- type: Type$1;
3605
- }
3606
- interface CommonIdentificationDataNonNullableFields$1 {
3607
- wixUserId: string;
3608
- identityType: IdentityType$1;
3609
- }
3610
- interface PermissionNonNullableFields$1 {
3611
- identity?: CommonIdentificationDataNonNullableFields$1;
3612
- role: Role$1;
3613
- }
3614
- interface ScheduleNonNullableFields$1 {
3615
- status: Status$3;
3616
- defaultLocation?: LocationNonNullableFields$1;
3617
- defaultConferencingDetails?: ConferencingDetailsNonNullableFields$1;
3618
- permissions: PermissionNonNullableFields$1[];
3619
- }
3620
- interface GetScheduleResponseNonNullableFields$1 {
3621
- schedule?: ScheduleNonNullableFields$1;
3622
- }
3623
- interface QuerySchedulesResponseNonNullableFields$1 {
3624
- schedules: ScheduleNonNullableFields$1[];
3625
- }
3626
- interface CreateScheduleResponseNonNullableFields$1 {
3627
- schedule?: ScheduleNonNullableFields$1;
3628
- }
3629
- interface UpdateScheduleResponseNonNullableFields$1 {
3630
- schedule?: ScheduleNonNullableFields$1;
3631
- }
3632
- interface CancelScheduleResponseNonNullableFields$1 {
3633
- schedule?: ScheduleNonNullableFields$1;
3634
- }
3635
-
3636
- /**
3637
- * A collection of [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
3638
- * associated with a specific entity, such as a
3639
- * [Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object),
3640
- * or [Bookings resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
3641
- * Schedules can also serve as templates for the events they manage, setting
3642
- * default values like a default location.
3643
- */
3644
- interface Schedule {
3645
- /**
3646
- * Schedule ID.
3647
- * @readonly
3648
- */
3649
- _id?: string | null;
3650
- /**
3651
- * External ID. You can't update the external ID.
3652
- *
3653
- * If the schedule belongs to a Bookings staff member, identical to the ID of
3654
- * the [resource](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction).
3655
- * If the schedule belongs to a Bookings service, identical to the ID of
3656
- * the [service](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup).
3657
- */
3658
- externalId?: string | null;
3659
- /**
3660
- * Schedule name.
3661
- *
3662
- * Min: 1 character
3663
- * Max: 200 characters
3664
- */
3665
- name?: string | null;
3666
- /**
3667
- * Schedule status.
3668
- *
3669
- * Supported values:
3670
- * - `ACTIVE`: You can add events to the schedule or update its fields.
3671
- * - `CANCELLED`: You can't add events to the schedule or update its fields.
3672
- *
3673
- * Default: `ACTIVE`
3674
- * @readonly
3675
- */
3676
- status?: Status$2;
3677
- /**
3678
- * Time zone the schedule is associated with in
3679
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
3680
- * For example, `America/New_York`.
3681
- *
3682
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3683
- *
3684
- * Min: 1 character
3685
- * Max: 150 characters
3686
- */
3687
- timeZone?: string | null;
3688
- /**
3689
- * Whether the schedule's `timeZone` is automatically synced from
3690
- * `timeZone` of the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3691
- *
3692
- * Default: `true`
3693
- */
3694
- businessTimeZoneEnabled?: boolean | null;
3695
- /**
3696
- * Default `title` for [events](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
3697
- * that are added to the schedule.
3698
- *
3699
- * Min: 1 character
3700
- * Max: 200 characters
3701
- */
3702
- defaultTitle?: string | null;
3703
- /**
3704
- * Default `location` for [events](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
3705
- * that are added to the schedule.
3706
- */
3707
- defaultLocation?: Location;
3708
- /**
3709
- * Default `totalCapacity` for [events](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
3710
- * that are added to the schedule.
3711
- *
3712
- * Min: `0`
3713
- */
3714
- defaultCapacity?: number | null;
3715
- /**
3716
- * Default `conferencingDetails` for [events](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
3717
- * that are added to the schedule.
3718
- * Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#retrieve-personal-information).
3719
- */
3720
- defaultConferencingDetails?: ConferencingDetails;
3721
- /**
3722
- * ID of the app that's associated with the schedule. You can't update `appId`.
3723
- * If you want to create a schedule and ensure its associated events appear
3724
- * in the [Bookings calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar),
3725
- * you must provide the Wix Bookings app ID
3726
- * `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
3727
- */
3728
- appId?: string | null;
3729
- /**
3730
- * List of permissions associated with the schedule. Refer to the
3731
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#roles)
3732
- * for more information.
3733
- *
3734
- * Max: 1 permission
3735
- */
3736
- permissions?: Permission[];
3737
- /** Extensions enabling applications or users to save custom data related to the schedule. */
3738
- extendedFields?: ExtendedFields;
3739
- /**
3740
- * Revision number, which increments by 1 each time the schedule is updated.
3741
- * To prevent conflicting changes, the current revision must be passed when updating the schedule.
3742
- * Ignored when creating a schedule.
3743
- * @readonly
3744
- */
3745
- revision?: string | null;
3746
- /**
3747
- * Date the schedule was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
3748
- * @readonly
3749
- */
3750
- _createdDate?: Date | null;
3751
- /**
3752
- * Date the schedule was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
3753
- * @readonly
3754
- */
3755
- _updatedDate?: Date | null;
3756
- }
3757
- declare enum Status$2 {
3758
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
3759
- /** You can add events to the schedule or update its fields. */
3760
- ACTIVE = "ACTIVE",
3761
- /** You can't add events to the schedule or update its fields. */
3762
- CANCELLED = "CANCELLED"
3763
- }
3764
- interface Location {
3765
- /**
3766
- * [Location](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction)
3767
- * ID. Available only for `BUSINESS` locations.
3768
- */
3769
- _id?: string | null;
3770
- /**
3771
- * Location type.
3772
- *
3773
- * Supported values:
3774
- * + `BUSINESS`: The event is held at a business location.
3775
- * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
3776
- * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
3777
- */
3778
- type?: LocationType;
3779
- /**
3780
- * Location name. For `BUSINESS` locations, it's identical to the
3781
- * [location](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction)
3782
- * `name`.
3783
- *
3784
- * Min: 1 character
3785
- * Max: 150 characters
3786
- */
3787
- name?: string | null;
3788
- /**
3789
- * Location address. For `BUSINESS` locations, it's identical to the
3790
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
3791
- * `formattedAddress`.
3792
- */
3793
- address?: string | null;
3794
- }
3795
- declare enum LocationType {
3796
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
3797
- /** The event is held at a business location. */
3798
- BUSINESS = "BUSINESS",
3799
- /** The event is held at the customer's location, such as their home or office. */
3800
- CUSTOMER = "CUSTOMER",
3801
- /** The event is held at an address or venue not tied to the business or customer. */
3802
- CUSTOM = "CUSTOM"
3803
- }
3804
- interface ConferencingDetails {
3805
- /** Conference type. For example, `Zoom`. */
3806
- type?: Type;
3807
- /**
3808
- * URL used by the host to start the conference.
3809
- *
3810
- * Min: 1 character
3811
- * Max: 2000 characters
3812
- */
3813
- hostUrl?: string | null;
3814
- /**
3815
- * URL used by a guest to join the conference.
3816
- *
3817
- * Min: 1 character
3818
- * Max: 2000 characters
3819
- */
3820
- guestUrl?: string | null;
3821
- /**
3822
- * Conference password.
3823
- *
3824
- * Min: 1 character
3825
- * Max: 100 characters
3826
- */
3827
- password?: string | null;
3828
- /**
3829
- * Conference ID in an external system.
3830
- *
3831
- * Min: 1 character
3832
- * Max: 150 characters
3833
- */
3834
- externalId?: string | null;
3835
- }
3836
- declare enum Type {
3837
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
3838
- ZOOM = "ZOOM",
3839
- CUSTOM = "CUSTOM"
3840
- }
3841
- interface Permission {
3842
- /**
3843
- * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
3844
- * granted the permission.
3845
- */
3846
- identity?: CommonIdentificationData;
3847
- /**
3848
- * Permission role.
3849
- *
3850
- * Supported values:
3851
- * + `WRITER`: Full read and write access.
3852
- * + `COMMENTER`: Full read access, write access limited to `event.notes`.
3853
- */
3854
- role?: Role;
3855
- }
3856
- interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
3857
- /**
3858
- * ID of a Wix user. For example, the site owner or a
3859
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
3860
- */
3861
- wixUserId?: string;
3862
- }
3863
- /** @oneof */
3864
- interface CommonIdentificationDataIdOneOf {
3865
- /**
3866
- * ID of a Wix user. For example, the site owner or a
3867
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
3868
- */
3869
- wixUserId?: string;
3870
- }
3871
- declare enum IdentityType {
3872
- UNKNOWN = "UNKNOWN",
3873
- WIX_USER = "WIX_USER"
3874
- }
3875
- declare enum Role {
3876
- UNKNOWN_ROLE = "UNKNOWN_ROLE",
3877
- /** Full read and write access. */
3878
- WRITER = "WRITER",
3879
- /** Full read access, write access limited to `event.notes`. */
3880
- COMMENTER = "COMMENTER"
3881
- }
3882
- interface ExtendedFields {
3883
- /**
3884
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
3885
- * The value of each key is structured according to the schema defined when the extended fields were configured.
3886
- *
3887
- * You can only access fields for which you have the appropriate permissions.
3888
- *
3889
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
3890
- */
3891
- namespaces?: Record<string, Record<string, any>>;
3892
- }
3893
- interface GetScheduleRequest {
3894
- /** ID of the schedule to retrieve. */
3895
- scheduleId: string | null;
3896
- /**
3897
- * Information about which fields containing personal data to return. Refer to the
3898
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
3899
- * for more information.
3900
- *
3901
- * Supported values:
3902
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
3903
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
3904
- *
3905
- * Max: 1 field
3906
- * Default: No personal data is returned.
3907
- */
3908
- fields?: RequestedFields[];
3909
- }
3910
- declare enum RequestedFields {
3911
- UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
3912
- /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
3913
- PI_FIELDS = "PI_FIELDS",
3914
- /** Returns only fields containing your own personal data. */
3915
- OWN_PI_FIELDS = "OWN_PI_FIELDS"
3916
- }
3917
- interface GetScheduleResponse {
3918
- /** Retrieved schedule. */
3919
- schedule?: Schedule;
3920
- }
3921
- interface QuerySchedulesRequest {
3922
- /** Query containing filters and paging. */
3923
- query?: CursorQuery;
3924
- /**
3925
- * Information about which fields containing personal data to return. Refer to the
3926
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
3927
- * for more information.
3928
- *
3929
- * Supported values:
3930
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
3931
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
3932
- *
3933
- * Max: 1 field
3934
- * Default: No personal data is returned.
3935
- */
3936
- fields?: RequestedFields[];
3937
- }
3938
- /** TODO Diverge */
3939
- interface CursorQuery extends CursorQueryPagingMethodOneOf {
3940
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
3941
- cursorPaging?: CursorPaging;
3942
- /**
3943
- * Filter object.
3944
- * See [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language)
3945
- * for more information.
3946
- *
3947
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
3948
- *
3949
- * For a detailed list of supported filters, see Supported Filters.
3950
- */
3951
- filter?: Record<string, any> | null;
3952
- }
3953
- /** @oneof */
3954
- interface CursorQueryPagingMethodOneOf {
3955
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
3956
- cursorPaging?: CursorPaging;
3957
- }
3958
- /** TODO Diverge */
3959
- interface CursorPaging {
3960
- /**
3961
- * Number of schedules to return.
3962
- *
3963
- * Min: `1`
3964
- * Max: `100`
3965
- * Default: `50`
3966
- */
3967
- limit?: number | null;
3968
- /**
3969
- * Pointer to the next or previous page in the list of results.
3970
- *
3971
- * You can get the relevant cursor token
3972
- * from the `pagingMetadata` object in the previous call's response.
3973
- * Not relevant for the first request.
3974
- */
3975
- cursor?: string | null;
3976
- }
3977
- interface QuerySchedulesResponse {
3978
- /** Retrieved schedules matching the provided query. */
3979
- schedules?: Schedule[];
3980
- /** Paging metadata. */
3981
- pagingMetadata?: CursorPagingMetadata;
3982
- }
3983
- /** TODO Diverge */
3984
- interface CursorPagingMetadata {
3985
- /** Number of schedules returned in the current page of the response. */
3986
- count?: number | null;
3987
- /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
3988
- cursors?: Cursors;
3989
- /**
3990
- * Indicates if there are more results after the current page.
3991
- * If `true`, another page of results can be retrieved.
3992
- * If `false`, this is the last page.
3993
- */
3994
- hasNext?: boolean | null;
3995
- }
3996
- interface Cursors {
3997
- /** Cursor pointing to next page in the list of results. */
3998
- next?: string | null;
3999
- /** Cursor pointing to previous page in the list of results. */
4000
- prev?: string | null;
4001
- }
4002
- interface CreateScheduleRequest {
4003
- /** Schedule to create. */
4004
- schedule: Schedule;
4005
- /**
4006
- * Idempotency key guaranteeing that you don't create the same schedule more
4007
- * than once.
4008
- */
4009
- idempotencyKey?: string | null;
4010
- }
4011
- interface CreateScheduleResponse {
4012
- /** Created schedule. */
4013
- schedule?: Schedule;
4014
- }
4015
- interface UpdateScheduleRequest {
4016
- /** Schedule to update. */
4017
- schedule: Schedule;
4018
- /**
4019
- * Information about whether participants of the schedule's updated events are
4020
- * notified and the message they receive.
4021
- */
4022
- participantNotification?: ParticipantNotification;
4023
- }
4024
- interface ParticipantNotification {
4025
- /**
4026
- * Whether to notify the participants about changes made to the schedule or event.
4027
- *
4028
- * Default: `false`
4029
- */
4030
- notifyParticipants?: boolean | null;
4031
- /**
4032
- * Message to send.
4033
- *
4034
- * Min: 1 character
4035
- * Max: 5000 characters
4036
- */
4037
- message?: string | null;
4038
- }
4039
- interface UpdateScheduleResponse {
4040
- /** Updated schedule. */
4041
- schedule?: Schedule;
4042
- }
4043
- interface CancelScheduleRequest {
4044
- /** ID of the schedule to cancel. */
4045
- scheduleId: string | null;
4046
- /**
4047
- * Whether to preserve future events with participants.
4048
- * Default: `false`.
4049
- */
4050
- preserveFutureEventsWithParticipants?: boolean | null;
4051
- /**
4052
- * Information about whether participants of the schedule's updated events are
4053
- * notified and the message they receive.
4054
- */
4055
- participantNotification?: ParticipantNotification;
4056
- }
4057
- interface CancelScheduleResponse {
4058
- /** Canceled schedule. */
4059
- schedule?: Schedule;
4060
- }
4061
- interface LocationNonNullableFields {
4062
- type: LocationType;
4063
- }
4064
- interface ConferencingDetailsNonNullableFields {
4065
- type: Type;
4066
- }
4067
- interface CommonIdentificationDataNonNullableFields {
4068
- wixUserId: string;
4069
- identityType: IdentityType;
4070
- }
4071
- interface PermissionNonNullableFields {
4072
- identity?: CommonIdentificationDataNonNullableFields;
4073
- role: Role;
4074
- }
4075
- interface ScheduleNonNullableFields {
4076
- status: Status$2;
4077
- defaultLocation?: LocationNonNullableFields;
4078
- defaultConferencingDetails?: ConferencingDetailsNonNullableFields;
4079
- permissions: PermissionNonNullableFields[];
4080
- }
4081
- interface GetScheduleResponseNonNullableFields {
4082
- schedule?: ScheduleNonNullableFields;
4083
- }
4084
- interface QuerySchedulesResponseNonNullableFields {
4085
- schedules: ScheduleNonNullableFields[];
4086
- }
4087
- interface CreateScheduleResponseNonNullableFields {
4088
- schedule?: ScheduleNonNullableFields;
4089
- }
4090
- interface UpdateScheduleResponseNonNullableFields {
4091
- schedule?: ScheduleNonNullableFields;
4092
- }
4093
- interface CancelScheduleResponseNonNullableFields {
4094
- schedule?: ScheduleNonNullableFields;
4095
- }
4096
-
4097
- type __PublicMethodMetaInfo$1<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
4098
- getUrl: (context: any) => string;
4099
- httpMethod: K;
4100
- path: string;
4101
- pathParams: M;
4102
- __requestType: T;
4103
- __originalRequestType: S;
4104
- __responseType: Q;
4105
- __originalResponseType: R;
4106
- };
4107
- declare function getSchedule(): __PublicMethodMetaInfo$1<'GET', {
4108
- scheduleId: string;
4109
- }, GetScheduleRequest, GetScheduleRequest$1, GetScheduleResponse & GetScheduleResponseNonNullableFields, GetScheduleResponse$1 & GetScheduleResponseNonNullableFields$1>;
4110
- declare function querySchedules(): __PublicMethodMetaInfo$1<'POST', {}, QuerySchedulesRequest, QuerySchedulesRequest$1, QuerySchedulesResponse & QuerySchedulesResponseNonNullableFields, QuerySchedulesResponse$1 & QuerySchedulesResponseNonNullableFields$1>;
4111
- declare function createSchedule(): __PublicMethodMetaInfo$1<'POST', {}, CreateScheduleRequest, CreateScheduleRequest$1, CreateScheduleResponse & CreateScheduleResponseNonNullableFields, CreateScheduleResponse$1 & CreateScheduleResponseNonNullableFields$1>;
4112
- declare function updateSchedule(): __PublicMethodMetaInfo$1<'PATCH', {
4113
- scheduleId: string;
4114
- }, UpdateScheduleRequest, UpdateScheduleRequest$1, UpdateScheduleResponse & UpdateScheduleResponseNonNullableFields, UpdateScheduleResponse$1 & UpdateScheduleResponseNonNullableFields$1>;
4115
- declare function cancelSchedule(): __PublicMethodMetaInfo$1<'POST', {
4116
- scheduleId: string;
4117
- }, CancelScheduleRequest, CancelScheduleRequest$1, CancelScheduleResponse & CancelScheduleResponseNonNullableFields, CancelScheduleResponse$1 & CancelScheduleResponseNonNullableFields$1>;
4118
-
4119
- declare const meta$1_cancelSchedule: typeof cancelSchedule;
4120
- declare const meta$1_createSchedule: typeof createSchedule;
4121
- declare const meta$1_getSchedule: typeof getSchedule;
4122
- declare const meta$1_querySchedules: typeof querySchedules;
4123
- declare const meta$1_updateSchedule: typeof updateSchedule;
4124
- declare namespace meta$1 {
4125
- export { type __PublicMethodMetaInfo$1 as __PublicMethodMetaInfo, meta$1_cancelSchedule as cancelSchedule, meta$1_createSchedule as createSchedule, meta$1_getSchedule as getSchedule, meta$1_querySchedules as querySchedules, meta$1_updateSchedule as updateSchedule };
4126
- }
4127
-
4128
- /**
4129
- * Information about the start and end dates of the first and last
4130
- * [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)
4131
- * that belong to a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)
4132
- * and whether any events follow an unlimited repetition pattern.
4133
- */
4134
- interface ScheduleTimeFrame$1 {
4135
- /**
4136
- * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
4137
- * to which the time frame belongs.
4138
- * @readonly
4139
- */
4140
- id?: string | null;
4141
- /**
4142
- * Information about the presence of recurring events within the schedule.
4143
- *
4144
- * Supported values:
4145
- * + `NONE`: No [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object) are scheduled within the schedule.
4146
- * + `FINITE`: All recurring events within the schedule have a defined end date, or there are no recurring events.
4147
- * + `INFINITE`: At least one recurring event within the schedule has no end date, meaning it follows an unlimited repetition pattern.
4148
- * @readonly
4149
- */
4150
- status?: Status$1;
4151
- /**
4152
- * Start date of the first [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
4153
- * within the schedule. Identical to `event.start.localDate`. Available only if
4154
- * `status` is set to `FINITE` or `INFINITE`.
4155
- * @readonly
4156
- */
4157
- firstEventStartDate?: ZonedDate$1;
4158
- /**
4159
- * End date of the last [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
4160
- * belonging to the schedule. Identical to `event.end.localDate`. Available only if
4161
- * `status` is set to `FINITE`.
4162
- * @readonly
4163
- */
4164
- lastEventEndDate?: ZonedDate$1;
4165
- /**
4166
- * Start date of the first [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
4167
- * belonging to the schedule, adjusted to `timeZone` of the
4168
- * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4169
- * or the `timeZone` specified in the request.
4170
- * Identical to `event.adjustedStart.localDate`.
4171
- * @readonly
4172
- */
4173
- adjustedFirstEventStartDate?: ZonedDate$1;
4174
- /**
4175
- * End date of the last [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
4176
- * belonging to the schedule, adjusted to `timeZone` of the
4177
- * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4178
- * or the `timeZone` specified in the request.
4179
- * Identical to `event.adjustedEnd.localDate`.
4180
- * @readonly
4181
- */
4182
- adjustedLastEventEndDate?: ZonedDate$1;
4183
- /**
4184
- * Revision number, which increments by 1 each time the schedule time frame is updated.
4185
- * @readonly
4186
- */
4187
- revision?: string | null;
4188
- }
4189
- declare enum Status$1 {
4190
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
4191
- /** No [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object) that belong to the schedule. */
4192
- NONE = "NONE",
4193
- /** There are no recurring events or all recurring events belonging to the schedule have a defined end date. */
4194
- FINITE = "FINITE",
4195
- /** At least one recurring event belonging to the schedule has an unlimited repetition pattern (no end date). */
4196
- INFINITE = "INFINITE"
4197
- }
4198
- /** A date time with a time zone, having the UTC offset and date determined by the server. */
4199
- interface ZonedDate$1 {
4200
- /**
4201
- * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
4202
- * For example, `2024-01-30T13:30:00`.
4203
- * Wix Calendar APIs ignore seconds.
4204
- */
4205
- localDate?: string | null;
4206
- /**
4207
- * Time zone in
4208
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
4209
- * For example, `America/New_York`.
4210
- * @readonly
4211
- */
4212
- timeZone?: string | null;
4213
- /**
4214
- * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
4215
- * For example, `2024-01-30T13:30:00`.
4216
- * Not available for adjusted date fields.
4217
- * @readonly
4218
- */
4219
- utcDate?: Date | null;
4220
- }
4221
- interface GetScheduleTimeFrameRequest$1 {
4222
- /**
4223
- * [Schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
4224
- * ID for which to retrieve the schedule time frame.
4225
- */
4226
- id: string | null;
4227
- /**
4228
- * Time zone for adjusting the times of the returned schedule time frame.
4229
- *
4230
- * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4231
- */
4232
- timeZone?: string | null;
4233
- }
4234
- interface GetScheduleTimeFrameResponse$1 {
4235
- /** Retrieved schedule time frame. */
4236
- scheduleTimeFrame?: ScheduleTimeFrame$1;
4237
- }
4238
- interface ListScheduleTimeFramesRequest$1 {
4239
- /**
4240
- * IDs of the schedules for which to retrieve schedule time frames.
4241
- *
4242
- * Min: 1 schedule ID
4243
- * Max: 100 schedule IDs
4244
- */
4245
- ids: string[];
4246
- /**
4247
- * Time zone for adjusting the times of the returned schedule time frames.
4248
- *
4249
- * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4250
- */
4251
- timeZone?: string | null;
4252
- }
4253
- interface ListScheduleTimeFramesResponse$1 {
4254
- /** Retrieved schedule time frames. */
4255
- scheduleTimeFrames?: ScheduleTimeFrame$1[];
4256
- }
4257
- interface ScheduleTimeFrameNonNullableFields$1 {
4258
- status: Status$1;
4259
- }
4260
- interface GetScheduleTimeFrameResponseNonNullableFields$1 {
4261
- scheduleTimeFrame?: ScheduleTimeFrameNonNullableFields$1;
4262
- }
4263
- interface ListScheduleTimeFramesResponseNonNullableFields$1 {
4264
- scheduleTimeFrames: ScheduleTimeFrameNonNullableFields$1[];
4265
- }
4266
-
4267
- /**
4268
- * Information about the start and end dates of the first and last
4269
- * [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)
4270
- * that belong to a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)
4271
- * and whether any events follow an unlimited repetition pattern.
4272
- */
4273
- interface ScheduleTimeFrame {
4274
- /**
4275
- * ID of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
4276
- * to which the time frame belongs.
4277
- * @readonly
4278
- */
4279
- _id?: string | null;
4280
- /**
4281
- * Information about the presence of recurring events within the schedule.
4282
- *
4283
- * Supported values:
4284
- * + `NONE`: No [events](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction) are scheduled within the schedule.
4285
- * + `FINITE`: All recurring events within the schedule have a defined end date, or there are no recurring events.
4286
- * + `INFINITE`: At least one recurring event within the schedule has no end date, meaning it follows an unlimited repetition pattern.
4287
- * @readonly
4288
- */
4289
- status?: Status;
4290
- /**
4291
- * Start date of the first [event](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
4292
- * within the schedule. Identical to `event.start.localDate`. Available only if
4293
- * `status` is set to `FINITE` or `INFINITE`.
4294
- * @readonly
4295
- */
4296
- firstEventStartDate?: ZonedDate;
4297
- /**
4298
- * End date of the last [event](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
4299
- * belonging to the schedule. Identical to `event.end.localDate`. Available only if
4300
- * `status` is set to `FINITE`.
4301
- * @readonly
4302
- */
4303
- lastEventEndDate?: ZonedDate;
4304
- /**
4305
- * Start date of the first [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
4306
- * belonging to the schedule, adjusted to `timeZone` of the
4307
- * [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
4308
- * or the `timeZone` specified in the request.
4309
- * Identical to `event.adjustedStart.localDate`.
4310
- * @readonly
4311
- */
4312
- adjustedFirstEventStartDate?: ZonedDate;
4313
- /**
4314
- * End date of the last [event](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction)
4315
- * belonging to the schedule, adjusted to `timeZone` of the
4316
- * [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
4317
- * or the `timeZone` specified in the request.
4318
- * Identical to `event.adjustedEnd.localDate`.
4319
- * @readonly
4320
- */
4321
- adjustedLastEventEndDate?: ZonedDate;
4322
- /**
4323
- * Revision number, which increments by 1 each time the schedule time frame is updated.
4324
- * @readonly
4325
- */
4326
- revision?: string | null;
4327
- }
4328
- declare enum Status {
4329
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
4330
- /** No [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object) that belong to the schedule. */
4331
- NONE = "NONE",
4332
- /** There are no recurring events or all recurring events belonging to the schedule have a defined end date. */
4333
- FINITE = "FINITE",
4334
- /** At least one recurring event belonging to the schedule has an unlimited repetition pattern (no end date). */
4335
- INFINITE = "INFINITE"
4336
- }
4337
- /** A date time with a time zone, having the UTC offset and date determined by the server. */
4338
- interface ZonedDate {
4339
- /**
4340
- * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
4341
- * For example, `2024-01-30T13:30:00`.
4342
- * Wix Calendar APIs ignore seconds.
4343
- */
4344
- localDate?: string | null;
4345
- /**
4346
- * Time zone in
4347
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
4348
- * For example, `America/New_York`.
4349
- * @readonly
4350
- */
4351
- timeZone?: string | null;
4352
- /**
4353
- * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
4354
- * For example, `2024-01-30T13:30:00`.
4355
- * Not available for adjusted date fields.
4356
- * @readonly
4357
- */
4358
- utcDate?: Date | null;
4359
- }
4360
- interface GetScheduleTimeFrameRequest {
4361
- /**
4362
- * [Schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
4363
- * ID for which to retrieve the schedule time frame.
4364
- */
4365
- _id: string | null;
4366
- /**
4367
- * Time zone for adjusting the times of the returned schedule time frame.
4368
- *
4369
- * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4370
- */
4371
- timeZone?: string | null;
4372
- }
4373
- interface GetScheduleTimeFrameResponse {
4374
- /** Retrieved schedule time frame. */
4375
- scheduleTimeFrame?: ScheduleTimeFrame;
4376
- }
4377
- interface ListScheduleTimeFramesRequest {
4378
- /**
4379
- * IDs of the schedules for which to retrieve schedule time frames.
4380
- *
4381
- * Min: 1 schedule ID
4382
- * Max: 100 schedule IDs
4383
- */
4384
- ids: string[];
4385
- /**
4386
- * Time zone for adjusting the times of the returned schedule time frames.
4387
- *
4388
- * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
4389
- */
4390
- timeZone?: string | null;
4391
- }
4392
- interface ListScheduleTimeFramesResponse {
4393
- /** Retrieved schedule time frames. */
4394
- scheduleTimeFrames?: ScheduleTimeFrame[];
4395
- }
4396
- interface ScheduleTimeFrameNonNullableFields {
4397
- status: Status;
4398
- }
4399
- interface GetScheduleTimeFrameResponseNonNullableFields {
4400
- scheduleTimeFrame?: ScheduleTimeFrameNonNullableFields;
4401
- }
4402
- interface ListScheduleTimeFramesResponseNonNullableFields {
4403
- scheduleTimeFrames: ScheduleTimeFrameNonNullableFields[];
4404
- }
4405
-
4406
- type __PublicMethodMetaInfo<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
4407
- getUrl: (context: any) => string;
4408
- httpMethod: K;
4409
- path: string;
4410
- pathParams: M;
4411
- __requestType: T;
4412
- __originalRequestType: S;
4413
- __responseType: Q;
4414
- __originalResponseType: R;
4415
- };
4416
- declare function getScheduleTimeFrame(): __PublicMethodMetaInfo<'GET', {
4417
- id: string;
4418
- }, GetScheduleTimeFrameRequest, GetScheduleTimeFrameRequest$1, GetScheduleTimeFrameResponse & GetScheduleTimeFrameResponseNonNullableFields, GetScheduleTimeFrameResponse$1 & GetScheduleTimeFrameResponseNonNullableFields$1>;
4419
- declare function listScheduleTimeFrames(): __PublicMethodMetaInfo<'GET', {}, ListScheduleTimeFramesRequest, ListScheduleTimeFramesRequest$1, ListScheduleTimeFramesResponse & ListScheduleTimeFramesResponseNonNullableFields, ListScheduleTimeFramesResponse$1 & ListScheduleTimeFramesResponseNonNullableFields$1>;
4420
-
4421
- type meta___PublicMethodMetaInfo<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = __PublicMethodMetaInfo<K, M, T, S, Q, R>;
4422
- declare const meta_getScheduleTimeFrame: typeof getScheduleTimeFrame;
4423
- declare const meta_listScheduleTimeFrames: typeof listScheduleTimeFrames;
4424
- declare namespace meta {
4425
- export { type meta___PublicMethodMetaInfo as __PublicMethodMetaInfo, meta_getScheduleTimeFrame as getScheduleTimeFrame, meta_listScheduleTimeFrames as listScheduleTimeFrames };
4426
- }
4427
-
4428
- export { meta$3 as eventViews, meta$4 as events, meta$2 as participations, meta as scheduleTimeFrames, meta$1 as schedules };