@wix/auto_sdk_calendar_events 1.0.28 → 1.0.30

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.
Files changed (130) hide show
  1. package/build/{cjs/src/calendar-v3-event-events.types.d.ts → calendar-v3-event-events.universal-Cfq4Piiv.d.mts} +983 -564
  2. package/build/{internal/cjs/src/calendar-v3-event-events.types.d.ts → calendar-v3-event-events.universal-Cfq4Piiv.d.ts} +983 -564
  3. package/build/{internal/cjs/src/calendar-v3-event-events.public.d.ts → index.d.mts} +62 -55
  4. package/build/{es/src/calendar-v3-event-events.public.d.ts → index.d.ts} +62 -55
  5. package/build/index.js +1340 -0
  6. package/build/index.js.map +1 -0
  7. package/build/index.mjs +1285 -0
  8. package/build/index.mjs.map +1 -0
  9. package/build/internal/{es/src/calendar-v3-event-events.types.d.ts → calendar-v3-event-events.universal-Cfq4Piiv.d.mts} +983 -564
  10. package/build/{es/src/calendar-v3-event-events.types.d.ts → internal/calendar-v3-event-events.universal-Cfq4Piiv.d.ts} +983 -564
  11. package/build/{cjs/src/calendar-v3-event-events.public.d.ts → internal/index.d.mts} +62 -55
  12. package/build/internal/{es/src/calendar-v3-event-events.public.d.ts → index.d.ts} +62 -55
  13. package/build/internal/index.js +1340 -0
  14. package/build/internal/index.js.map +1 -0
  15. package/build/internal/index.mjs +1285 -0
  16. package/build/internal/index.mjs.map +1 -0
  17. package/build/internal/meta.d.mts +1195 -0
  18. package/build/internal/meta.d.ts +1195 -0
  19. package/build/internal/meta.js +777 -0
  20. package/build/internal/meta.js.map +1 -0
  21. package/build/internal/meta.mjs +740 -0
  22. package/build/internal/meta.mjs.map +1 -0
  23. package/build/meta.d.mts +1195 -0
  24. package/build/meta.d.ts +1195 -0
  25. package/build/meta.js +777 -0
  26. package/build/meta.js.map +1 -0
  27. package/build/meta.mjs +740 -0
  28. package/build/meta.mjs.map +1 -0
  29. package/package.json +12 -11
  30. package/build/cjs/index.d.ts +0 -1
  31. package/build/cjs/index.js +0 -18
  32. package/build/cjs/index.js.map +0 -1
  33. package/build/cjs/index.typings.d.ts +0 -1
  34. package/build/cjs/index.typings.js +0 -18
  35. package/build/cjs/index.typings.js.map +0 -1
  36. package/build/cjs/meta.d.ts +0 -1
  37. package/build/cjs/meta.js +0 -18
  38. package/build/cjs/meta.js.map +0 -1
  39. package/build/cjs/src/calendar-v3-event-events.context.d.ts +0 -51
  40. package/build/cjs/src/calendar-v3-event-events.context.js +0 -71
  41. package/build/cjs/src/calendar-v3-event-events.context.js.map +0 -1
  42. package/build/cjs/src/calendar-v3-event-events.http.d.ts +0 -144
  43. package/build/cjs/src/calendar-v3-event-events.http.js +0 -785
  44. package/build/cjs/src/calendar-v3-event-events.http.js.map +0 -1
  45. package/build/cjs/src/calendar-v3-event-events.meta.d.ts +0 -39
  46. package/build/cjs/src/calendar-v3-event-events.meta.js +0 -275
  47. package/build/cjs/src/calendar-v3-event-events.meta.js.map +0 -1
  48. package/build/cjs/src/calendar-v3-event-events.public.js +0 -196
  49. package/build/cjs/src/calendar-v3-event-events.public.js.map +0 -1
  50. package/build/cjs/src/calendar-v3-event-events.types.js +0 -157
  51. package/build/cjs/src/calendar-v3-event-events.types.js.map +0 -1
  52. package/build/cjs/src/calendar-v3-event-events.universal.d.ts +0 -3198
  53. package/build/cjs/src/calendar-v3-event-events.universal.js +0 -1185
  54. package/build/cjs/src/calendar-v3-event-events.universal.js.map +0 -1
  55. package/build/es/index.d.ts +0 -1
  56. package/build/es/index.js +0 -2
  57. package/build/es/index.js.map +0 -1
  58. package/build/es/index.typings.d.ts +0 -1
  59. package/build/es/index.typings.js +0 -2
  60. package/build/es/index.typings.js.map +0 -1
  61. package/build/es/meta.d.ts +0 -1
  62. package/build/es/meta.js +0 -2
  63. package/build/es/meta.js.map +0 -1
  64. package/build/es/package.json +0 -3
  65. package/build/es/src/calendar-v3-event-events.context.d.ts +0 -51
  66. package/build/es/src/calendar-v3-event-events.context.js +0 -51
  67. package/build/es/src/calendar-v3-event-events.context.js.map +0 -1
  68. package/build/es/src/calendar-v3-event-events.http.d.ts +0 -144
  69. package/build/es/src/calendar-v3-event-events.http.js +0 -769
  70. package/build/es/src/calendar-v3-event-events.http.js.map +0 -1
  71. package/build/es/src/calendar-v3-event-events.meta.d.ts +0 -39
  72. package/build/es/src/calendar-v3-event-events.meta.js +0 -236
  73. package/build/es/src/calendar-v3-event-events.meta.js.map +0 -1
  74. package/build/es/src/calendar-v3-event-events.public.js +0 -163
  75. package/build/es/src/calendar-v3-event-events.public.js.map +0 -1
  76. package/build/es/src/calendar-v3-event-events.types.js +0 -154
  77. package/build/es/src/calendar-v3-event-events.types.js.map +0 -1
  78. package/build/es/src/calendar-v3-event-events.universal.d.ts +0 -3198
  79. package/build/es/src/calendar-v3-event-events.universal.js +0 -1146
  80. package/build/es/src/calendar-v3-event-events.universal.js.map +0 -1
  81. package/build/internal/cjs/index.d.ts +0 -1
  82. package/build/internal/cjs/index.js +0 -18
  83. package/build/internal/cjs/index.js.map +0 -1
  84. package/build/internal/cjs/index.typings.d.ts +0 -1
  85. package/build/internal/cjs/index.typings.js +0 -18
  86. package/build/internal/cjs/index.typings.js.map +0 -1
  87. package/build/internal/cjs/meta.d.ts +0 -1
  88. package/build/internal/cjs/meta.js +0 -18
  89. package/build/internal/cjs/meta.js.map +0 -1
  90. package/build/internal/cjs/src/calendar-v3-event-events.context.d.ts +0 -51
  91. package/build/internal/cjs/src/calendar-v3-event-events.context.js +0 -71
  92. package/build/internal/cjs/src/calendar-v3-event-events.context.js.map +0 -1
  93. package/build/internal/cjs/src/calendar-v3-event-events.http.d.ts +0 -144
  94. package/build/internal/cjs/src/calendar-v3-event-events.http.js +0 -785
  95. package/build/internal/cjs/src/calendar-v3-event-events.http.js.map +0 -1
  96. package/build/internal/cjs/src/calendar-v3-event-events.meta.d.ts +0 -39
  97. package/build/internal/cjs/src/calendar-v3-event-events.meta.js +0 -275
  98. package/build/internal/cjs/src/calendar-v3-event-events.meta.js.map +0 -1
  99. package/build/internal/cjs/src/calendar-v3-event-events.public.js +0 -196
  100. package/build/internal/cjs/src/calendar-v3-event-events.public.js.map +0 -1
  101. package/build/internal/cjs/src/calendar-v3-event-events.types.js +0 -157
  102. package/build/internal/cjs/src/calendar-v3-event-events.types.js.map +0 -1
  103. package/build/internal/cjs/src/calendar-v3-event-events.universal.d.ts +0 -3198
  104. package/build/internal/cjs/src/calendar-v3-event-events.universal.js +0 -1185
  105. package/build/internal/cjs/src/calendar-v3-event-events.universal.js.map +0 -1
  106. package/build/internal/es/index.d.ts +0 -1
  107. package/build/internal/es/index.js +0 -2
  108. package/build/internal/es/index.js.map +0 -1
  109. package/build/internal/es/index.typings.d.ts +0 -1
  110. package/build/internal/es/index.typings.js +0 -2
  111. package/build/internal/es/index.typings.js.map +0 -1
  112. package/build/internal/es/meta.d.ts +0 -1
  113. package/build/internal/es/meta.js +0 -2
  114. package/build/internal/es/meta.js.map +0 -1
  115. package/build/internal/es/src/calendar-v3-event-events.context.d.ts +0 -51
  116. package/build/internal/es/src/calendar-v3-event-events.context.js +0 -51
  117. package/build/internal/es/src/calendar-v3-event-events.context.js.map +0 -1
  118. package/build/internal/es/src/calendar-v3-event-events.http.d.ts +0 -144
  119. package/build/internal/es/src/calendar-v3-event-events.http.js +0 -769
  120. package/build/internal/es/src/calendar-v3-event-events.http.js.map +0 -1
  121. package/build/internal/es/src/calendar-v3-event-events.meta.d.ts +0 -39
  122. package/build/internal/es/src/calendar-v3-event-events.meta.js +0 -236
  123. package/build/internal/es/src/calendar-v3-event-events.meta.js.map +0 -1
  124. package/build/internal/es/src/calendar-v3-event-events.public.js +0 -163
  125. package/build/internal/es/src/calendar-v3-event-events.public.js.map +0 -1
  126. package/build/internal/es/src/calendar-v3-event-events.types.js +0 -154
  127. package/build/internal/es/src/calendar-v3-event-events.types.js.map +0 -1
  128. package/build/internal/es/src/calendar-v3-event-events.universal.d.ts +0 -3198
  129. package/build/internal/es/src/calendar-v3-event-events.universal.js +0 -1146
  130. package/build/internal/es/src/calendar-v3-event-events.universal.js.map +0 -1
@@ -1,3198 +0,0 @@
1
- import { NonNullablePaths } from '@wix/sdk-types';
2
- /**
3
- * An event is a scheduled entry on a calendar that includes details like timing,
4
- * location, and participants. Each event is associated with
5
- * a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
6
- * from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
7
- * Events can either be standalone, part of a recurring series, or define a
8
- * recurrence pattern. You can also specify whether events block time on the
9
- * schedule or allow other events to be scheduled concurrently.
10
- */
11
- export interface Event {
12
- /**
13
- * Event ID.
14
- * @minLength 36
15
- * @maxLength 250
16
- * @readonly
17
- */
18
- _id?: string | null;
19
- /**
20
- * ID of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
21
- * the event belongs to.
22
- * After creating an event, you can't assign it to a different schedule.
23
- * @format GUID
24
- * @immutable
25
- */
26
- scheduleId?: string | null;
27
- /**
28
- * ID of the external schedule the event belongs to.
29
- *
30
- * 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).
31
- * @format GUID
32
- * @readonly
33
- */
34
- externalScheduleId?: string | null;
35
- /**
36
- * Schedule name.
37
- * @readonly
38
- */
39
- scheduleName?: string | null;
40
- /**
41
- * Event type. You can set the event type but you can't update it.
42
- *
43
- * Supported values:
44
- * + `DEFAULT`: A standard event that's not further specified.
45
- * + `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).
46
- *
47
- * Additional supported values, if Wix Bookings is installed:
48
- * + `APPOINTMENT`: Bookings appointment event.
49
- * + `CLASS`: Bookings class event.
50
- * + `COURSE`: Bookings course event.
51
- * @immutable
52
- */
53
- type?: string | null;
54
- /**
55
- * Event status.
56
- *
57
- * Supported values:
58
- * + `CONFIRMED`: Event is scheduled to happen or has happened.
59
- * + `CANCELLED`: Event has been canceled.
60
- *
61
- * Default: `CONFIRMED`
62
- * @readonly
63
- */
64
- status?: StatusWithLiterals;
65
- /**
66
- * Event title.
67
- *
68
- * Min: 1 character
69
- * Max: 200 characters
70
- * @minLength 1
71
- * @maxLength 200
72
- */
73
- title?: string | null;
74
- /** Information about when the event starts. */
75
- start?: ZonedDate;
76
- /**
77
- * Information about when the event ends.
78
- *
79
- * Maximum allowed date: Year 2100, or up to 100 years from the event's start date (whichever comes first).
80
- */
81
- end?: ZonedDate;
82
- /**
83
- * Information about when the event starts adjusted to the `timeZone` of the
84
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
85
- * or a different `timeZone` you provide in the call's request.
86
- * @readonly
87
- */
88
- adjustedStart?: ZonedDate;
89
- /**
90
- * Information about when the event ends adjusted to the `timeZone` of the
91
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
92
- * or a different `timeZone` you provide in the call's request.
93
- * @readonly
94
- */
95
- adjustedEnd?: ZonedDate;
96
- /**
97
- * Time zone the event is associated with in
98
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
99
- * Only regional time zones and UTC are supported.
100
- * For example, `America/New_York` or `UTC`.
101
- *
102
- * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
103
- */
104
- timeZone?: string | null;
105
- /**
106
- * Information about whether the event is a single occurrence or part of a
107
- * recurring series.
108
- *
109
- * Supported values:
110
- * + `NONE`: The event occurs only once and doesn't repeat.
111
- * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
112
- * + `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`.
113
- * + `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.
114
- *
115
- * Default: `NONE`
116
- * @readonly
117
- */
118
- recurrenceType?: RecurrenceTypeWithLiterals;
119
- /**
120
- * Recurrence pattern for a series of events. This field is required when
121
- * creating a `MASTER` event and isn't available for non-recurring events.
122
- * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
123
- *
124
- * For example, an event that repeats every second Monday until January 7, 2026,
125
- * at 8:00 AM has the following `recurrenceRule`:
126
- * - `frequency = WEEKLY`
127
- * - `interval = 2`
128
- * - `days = [MONDAY]`
129
- * - `until = 20260107T08:00:00Z`
130
- */
131
- recurrenceRule?: RecurrenceRule;
132
- /**
133
- * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
134
- * and `EXCEPTION` events.
135
- * @minLength 64
136
- * @maxLength 64
137
- * @readonly
138
- */
139
- recurringEventId?: string | null;
140
- /**
141
- * Specifies whether the event blocks time in the schedule it belongs to.
142
- *
143
- * Supported values:
144
- * + `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.
145
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
146
- *
147
- * Default: `OPAQUE`
148
- */
149
- transparency?: TransparencyWithLiterals;
150
- /**
151
- * Event location.
152
- *
153
- * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to
154
- */
155
- location?: Location;
156
- /**
157
- * List of [Wix Bookings resources](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction)
158
- * affected by the event. This could include, for example, the
159
- * [Wix Bookings staff member](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction)
160
- * providing the service or the room where the appointment takes place.
161
- *
162
- * Max: 100 resources
163
- * @maxSize 100
164
- */
165
- resources?: Resource[];
166
- /**
167
- * Maximum number of participants who can participate in the event.
168
- *
169
- * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
170
- */
171
- totalCapacity?: number | null;
172
- /**
173
- * Number of participants who can still be added to the event.
174
- * @readonly
175
- */
176
- remainingCapacity?: number | null;
177
- /**
178
- * Information about the event's participants.
179
- * 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).
180
- * @readonly
181
- */
182
- participants?: Participants;
183
- /**
184
- * Information about the event's online conferencing.
185
- * 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).
186
- *
187
- * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
188
- */
189
- conferencingDetails?: ConferencingDetails;
190
- /**
191
- * Additional notes about the event.
192
- * 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).
193
- *
194
- * Min: 1 character
195
- * Max: 5000 characters
196
- * @minLength 1
197
- * @maxLength 5000
198
- */
199
- notes?: string | null;
200
- /**
201
- * List of fields whose values are inherited.
202
- * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
203
- * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related `MASTER` event.
204
- * @readonly
205
- */
206
- inheritedFields?: FieldWithLiterals[];
207
- /**
208
- * ID of the app that owns the event. Identical to `appId` of the
209
- * [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
210
- * to which the event belongs.
211
- * @format GUID
212
- * @readonly
213
- */
214
- appId?: string | null;
215
- /**
216
- * List of permissions associated with the event. Refer to the
217
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#roles)
218
- * for more information.
219
- * @readonly
220
- */
221
- permissions?: Permission[];
222
- /** Extensions enabling applications or users to save custom data related to the event. */
223
- extendedFields?: ExtendedFields;
224
- /**
225
- * Revision number, which increments each time the event is updated.
226
- * To prevent conflicting changes, the current revision must be passed when updating the event.
227
- * Ignored when creating an event.
228
- * @readonly
229
- */
230
- revision?: string | null;
231
- /**
232
- * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
233
- * @readonly
234
- */
235
- _createdDate?: Date | null;
236
- /**
237
- * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
238
- * @readonly
239
- */
240
- _updatedDate?: Date | null;
241
- }
242
- export declare enum Status {
243
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
244
- /** Event is scheduled to happen or has happened. */
245
- CONFIRMED = "CONFIRMED",
246
- /** Event has been canceled. */
247
- CANCELLED = "CANCELLED"
248
- }
249
- /** @enumType */
250
- export type StatusWithLiterals = Status | 'UNKNOWN_STATUS' | 'CONFIRMED' | 'CANCELLED';
251
- /** A date time with a time zone, having the UTC offset and date determined by the server. */
252
- export interface ZonedDate {
253
- /**
254
- * Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
255
- * For example, `2024-01-30T13:30:00`.
256
- * Wix Calendar APIs ignore seconds.
257
- * @format LOCAL_DATE_TIME
258
- */
259
- localDate?: string | null;
260
- /**
261
- * Time zone in
262
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
263
- * For example, `America/New_York`.
264
- * @readonly
265
- */
266
- timeZone?: string | null;
267
- /**
268
- * UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
269
- * For example, `2024-01-30T13:30:00`.
270
- * Not available for adjusted date fields.
271
- * @readonly
272
- */
273
- utcDate?: Date | null;
274
- }
275
- export declare enum RecurrenceType {
276
- UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
277
- /** The event occurs only once and doesn't repeat. */
278
- NONE = "NONE",
279
- /** Defines the recurrence pattern for a series of recurring events. */
280
- MASTER = "MASTER",
281
- /** 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`. */
282
- INSTANCE = "INSTANCE",
283
- /** 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. */
284
- EXCEPTION = "EXCEPTION"
285
- }
286
- /** @enumType */
287
- export type RecurrenceTypeWithLiterals = RecurrenceType | 'UNKNOWN_RECURRENCE_TYPE' | 'NONE' | 'MASTER' | 'INSTANCE' | 'EXCEPTION';
288
- export interface RecurrenceRule {
289
- /**
290
- * Frequency how often the event repeats. Works together with `interval`.
291
- *
292
- * Supported values:
293
- * + `WEEKLY`: The event's recurrence pattern is based on weeks.
294
- */
295
- frequency?: FrequencyWithLiterals;
296
- /**
297
- * Interval how often the event repeats. Works together with `frequency`.
298
- * For example, `frequency` set to `WEEKLY` and `interval` set to `2` means
299
- * the event repeats every 2 weeks.
300
- *
301
- * Min: `1`
302
- * Max: `4`
303
- * Default: `1`
304
- * @min 1
305
- * @max 4
306
- */
307
- interval?: number | null;
308
- /**
309
- * Days of the week when the recurring event takes place.
310
- * Currently, only a single day is supported.
311
- *
312
- * Min: 1 day
313
- * Max: 1 day
314
- * @minSize 1
315
- * @maxSize 1
316
- */
317
- days?: DayWithLiterals[];
318
- /**
319
- * Date until when the event repeats.
320
- * If not specified, the event repeats forever.
321
- */
322
- until?: ZonedDate;
323
- /**
324
- * Date until when the event repeats
325
- * adjusted to the `timeZone` of the business
326
- * [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
327
- * or a different `timeZone` you provide in the call's request.
328
- * @readonly
329
- */
330
- adjustedUntil?: ZonedDate;
331
- }
332
- export declare enum Frequency {
333
- UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
334
- /** The event's recurrence pattern is based on weeks. */
335
- WEEKLY = "WEEKLY"
336
- }
337
- /** @enumType */
338
- export type FrequencyWithLiterals = Frequency | 'UNKNOWN_FREQUENCY' | 'WEEKLY';
339
- export declare enum Day {
340
- /** The recurring event takes place on Mondays. */
341
- MONDAY = "MONDAY",
342
- /** The recurring event takes place on Tuesdays. */
343
- TUESDAY = "TUESDAY",
344
- /** The recurring event takes place on Wednesday. */
345
- WEDNESDAY = "WEDNESDAY",
346
- /** The recurring event takes place on Thursdays. */
347
- THURSDAY = "THURSDAY",
348
- /** The recurring event takes place on Fridays. */
349
- FRIDAY = "FRIDAY",
350
- /** The recurring event takes place on Saturdays. */
351
- SATURDAY = "SATURDAY",
352
- /** The recurring event takes place on Sundays. */
353
- SUNDAY = "SUNDAY"
354
- }
355
- /** @enumType */
356
- export type DayWithLiterals = Day | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY';
357
- export declare enum Transparency {
358
- UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
359
- /** 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. */
360
- OPAQUE = "OPAQUE",
361
- /** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
362
- TRANSPARENT = "TRANSPARENT"
363
- }
364
- /** @enumType */
365
- export type TransparencyWithLiterals = Transparency | 'UNKNOWN_TRANSPARENCY' | 'OPAQUE' | 'TRANSPARENT';
366
- export interface Location {
367
- /**
368
- * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
369
- * ID. Available only for `BUSINESS` locations.
370
- * @format GUID
371
- */
372
- _id?: string | null;
373
- /**
374
- * Location type.
375
- *
376
- * Supported values:
377
- * + `BUSINESS`: The event is held at a business location.
378
- * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
379
- * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
380
- */
381
- type?: LocationTypeWithLiterals;
382
- /**
383
- * Location name. For `BUSINESS` locations, it's identical to the
384
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
385
- * `name`.
386
- *
387
- * Min: 1 character
388
- * Max: 150 characters
389
- * @minLength 1
390
- * @maxLength 150
391
- */
392
- name?: string | null;
393
- /**
394
- * Location address. For `BUSINESS` locations, it's identical to the
395
- * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
396
- * `formattedAddress`.
397
- * @minLength 1
398
- * @maxLength 300
399
- */
400
- address?: string | null;
401
- }
402
- export declare enum LocationType {
403
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
404
- /** The event is held at a business location. */
405
- BUSINESS = "BUSINESS",
406
- /** The event is held at the customer's location, such as their home or office. */
407
- CUSTOMER = "CUSTOMER",
408
- /** The event is held at an address or venue not tied to the business or customer. */
409
- CUSTOM = "CUSTOM"
410
- }
411
- /** @enumType */
412
- export type LocationTypeWithLiterals = LocationType | 'UNKNOWN_TYPE' | 'BUSINESS' | 'CUSTOMER' | 'CUSTOM';
413
- export interface Resource {
414
- /**
415
- * Resource ID.
416
- * @format GUID
417
- */
418
- _id?: string | null;
419
- /**
420
- * Resource name.
421
- * @readonly
422
- */
423
- name?: string | null;
424
- /**
425
- * Resource type.
426
- * @readonly
427
- */
428
- type?: string | null;
429
- /**
430
- * Specifies whether the event blocks time in the resource's schedule.
431
- *
432
- * Supported values:
433
- * + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
434
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
435
- *
436
- * Default: `OPAQUE`.
437
- */
438
- transparency?: TransparencyWithLiterals;
439
- /**
440
- * Permission role associated with the resource. Refer to the
441
- * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
442
- * for more information.
443
- */
444
- permissionRole?: RoleWithLiterals;
445
- }
446
- export declare enum Role {
447
- UNKNOWN_ROLE = "UNKNOWN_ROLE",
448
- /** Full read and write access. */
449
- WRITER = "WRITER",
450
- /** Full read access, write access limited to `event.notes`. */
451
- COMMENTER = "COMMENTER"
452
- }
453
- /** @enumType */
454
- export type RoleWithLiterals = Role | 'UNKNOWN_ROLE' | 'WRITER' | 'COMMENTER';
455
- export interface Participants {
456
- /**
457
- * Total number of participants.
458
- *
459
- * Min: `0`
460
- */
461
- total?: number | null;
462
- /**
463
- * Full or partial list of the participants.
464
- *
465
- * Max: 50 participants
466
- * @maxSize 50
467
- */
468
- list?: Participant[];
469
- /**
470
- * Whether there are more participants for the event than listed.
471
- *
472
- * + `false`: The list includes all participants.
473
- * + `true`: The list doesn't include all participants.
474
- */
475
- hasMore?: boolean | null;
476
- /**
477
- * Participant's status.
478
- *
479
- * Supported values:
480
- * + `CONFIRMED`: All participants are confirmed.
481
- * + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
482
- */
483
- status?: ParticipantsStatusWithLiterals;
484
- }
485
- export interface Participant {
486
- /**
487
- * Participant name.
488
- *
489
- * Min: 1 character
490
- * Max: 200 characters
491
- * @minLength 1
492
- * @maxLength 200
493
- */
494
- name?: string | null;
495
- /**
496
- * Participant's phone number.
497
- * @format PHONE
498
- */
499
- phone?: string | null;
500
- /**
501
- * Participant's email address.
502
- * @format EMAIL
503
- */
504
- email?: string | null;
505
- /**
506
- * [Contact](https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/introduction)
507
- * ID of the participant.
508
- * @format GUID
509
- */
510
- contactId?: string | null;
511
- }
512
- export declare enum ParticipantsStatus {
513
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
514
- /** All participants are confirmed. */
515
- CONFIRMED = "CONFIRMED",
516
- /** At least one participant isn't confirmed yet. */
517
- PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
518
- }
519
- /** @enumType */
520
- export type ParticipantsStatusWithLiterals = ParticipantsStatus | 'UNKNOWN_STATUS' | 'CONFIRMED' | 'PENDING_CONFIRMATION';
521
- export interface ConferencingDetails {
522
- /** Conference type. For example, `Zoom`. */
523
- type?: TypeWithLiterals;
524
- /**
525
- * URL used by the host to start the conference.
526
- *
527
- * Min: 1 character
528
- * Max: 2000 characters
529
- * @minLength 1
530
- * @maxLength 2000
531
- */
532
- hostUrl?: string | null;
533
- /**
534
- * URL used by a guest to join the conference.
535
- *
536
- * Min: 1 character
537
- * Max: 2000 characters
538
- * @minLength 1
539
- * @maxLength 2000
540
- */
541
- guestUrl?: string | null;
542
- /**
543
- * Conference password.
544
- *
545
- * Min: 1 character
546
- * Max: 100 characters
547
- * @minLength 1
548
- * @maxLength 100
549
- */
550
- password?: string | null;
551
- /**
552
- * Conference ID in an external system.
553
- *
554
- * Min: 1 character
555
- * Max: 150 characters
556
- * @minLength 1
557
- * @maxLength 150
558
- */
559
- externalId?: string | null;
560
- }
561
- export declare enum Type {
562
- UNKNOWN_TYPE = "UNKNOWN_TYPE",
563
- ZOOM = "ZOOM",
564
- CUSTOM = "CUSTOM"
565
- }
566
- /** @enumType */
567
- export type TypeWithLiterals = Type | 'UNKNOWN_TYPE' | 'ZOOM' | 'CUSTOM';
568
- export declare enum Field {
569
- UNKNOWN_FIELD = "UNKNOWN_FIELD",
570
- /** `title` is inherited from the schedule or `MASTER` event. */
571
- TITLE = "TITLE",
572
- /** `timeZone` is inherited from the schedule or `MASTER` event. */
573
- TIME_ZONE = "TIME_ZONE",
574
- /** `start` and `end` are inherited from the `MASTER` event. */
575
- TIME = "TIME",
576
- /** `location` is inherited from the schedule or `MASTER` event. */
577
- LOCATION = "LOCATION",
578
- /** `resources` is inherited from the `MASTER` event. */
579
- RESOURCES = "RESOURCES",
580
- /** `capacity` is inherited from the schedule or `MASTER` event. */
581
- CAPACITY = "CAPACITY",
582
- /** `participants` is inherited from the `MASTER` event. */
583
- PARTICIPANTS = "PARTICIPANTS",
584
- /** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
585
- CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
586
- }
587
- /** @enumType */
588
- export type FieldWithLiterals = Field | 'UNKNOWN_FIELD' | 'TITLE' | 'TIME_ZONE' | 'TIME' | 'LOCATION' | 'RESOURCES' | 'CAPACITY' | 'PARTICIPANTS' | 'CONFERENCING_DETAILS';
589
- export interface Permission {
590
- /**
591
- * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
592
- * granted the permission.
593
- */
594
- identity?: CommonIdentificationData;
595
- /**
596
- * Permission role.
597
- *
598
- * Supported values:
599
- * + `WRITER`: Full read and write access.
600
- * + `COMMENTER`: Full read access, write access limited to `event.notes`.
601
- */
602
- role?: RoleWithLiterals;
603
- }
604
- export interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
605
- /**
606
- * ID of a Wix user. For example, the site owner or a
607
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
608
- * @format GUID
609
- */
610
- wixUserId?: string;
611
- }
612
- /** @oneof */
613
- export interface CommonIdentificationDataIdOneOf {
614
- /**
615
- * ID of a Wix user. For example, the site owner or a
616
- * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
617
- * @format GUID
618
- */
619
- wixUserId?: string;
620
- }
621
- export declare enum IdentityType {
622
- UNKNOWN = "UNKNOWN",
623
- WIX_USER = "WIX_USER"
624
- }
625
- /** @enumType */
626
- export type IdentityTypeWithLiterals = IdentityType | 'UNKNOWN' | 'WIX_USER';
627
- export interface ExtendedFields {
628
- /**
629
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
630
- * The value of each key is structured according to the schema defined when the extended fields were configured.
631
- *
632
- * You can only access fields for which you have the appropriate permissions.
633
- *
634
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
635
- */
636
- namespaces?: Record<string, Record<string, any>>;
637
- }
638
- export interface RecurringEventSplit {
639
- /** Original `MASTER` event that was shortened. */
640
- updatedRecurringEventEndingBeforeSplit?: Event;
641
- /** New `MASTER` event starting with the first event after the split date. */
642
- newRecurringEventStartingFromSplit?: Event;
643
- }
644
- export interface EventCancelled {
645
- /** Canceled event. */
646
- event?: Event;
647
- }
648
- export interface ParticipantNotification {
649
- /**
650
- * Whether to notify the participants about changes made to the schedule or event.
651
- *
652
- * Default: `false`
653
- */
654
- notifyParticipants?: boolean | null;
655
- /**
656
- * Message to send.
657
- *
658
- * Min: 1 character
659
- * Max: 5000 characters
660
- * @minLength 1
661
- * @maxLength 5000
662
- */
663
- message?: string | null;
664
- }
665
- /** Deprecated. Use EventUpdated instead, which includes the modified fields and additional metadata. */
666
- export interface EventUpdatedWithMetadata {
667
- /** The updated event. */
668
- event?: Event;
669
- /**
670
- * Information about whether participants of the updated event are notified and
671
- * the message they receive.
672
- */
673
- participantNotification?: ParticipantNotification;
674
- }
675
- export interface UpdateScheduleWithFixedBusinessResourceIdRequest {
676
- /** @format GUID */
677
- metaSiteId?: string;
678
- /** @format GUID */
679
- currentBusinessResourceId?: string;
680
- migrateBusinessConferenceId?: boolean;
681
- }
682
- export interface UpdateScheduleWithFixedBusinessResourceIdResponse {
683
- }
684
- export interface UpdateEventsWithFixedBusinessResourceIdRequest {
685
- /** @format GUID */
686
- metaSiteId?: string;
687
- /** @format GUID */
688
- currentBusinessResourceId?: string;
689
- migrateBusinessConferenceId?: boolean;
690
- }
691
- export interface UpdateEventsWithFixedBusinessResourceIdResponse {
692
- }
693
- export interface DomainEvent extends DomainEventBodyOneOf {
694
- createdEvent?: EntityCreatedEvent;
695
- updatedEvent?: EntityUpdatedEvent;
696
- deletedEvent?: EntityDeletedEvent;
697
- actionEvent?: ActionEvent;
698
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
699
- _id?: string;
700
- /**
701
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
702
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
703
- */
704
- entityFqdn?: string;
705
- /**
706
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
707
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
708
- */
709
- slug?: string;
710
- /** ID of the entity associated with the event. */
711
- entityId?: string;
712
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
713
- eventTime?: Date | null;
714
- /**
715
- * Whether the event was triggered as a result of a privacy regulation application
716
- * (for example, GDPR).
717
- */
718
- triggeredByAnonymizeRequest?: boolean | null;
719
- /** If present, indicates the action that triggered the event. */
720
- originatedFrom?: string | null;
721
- /**
722
- * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
723
- * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
724
- */
725
- entityEventSequence?: string | null;
726
- }
727
- /** @oneof */
728
- export interface DomainEventBodyOneOf {
729
- createdEvent?: EntityCreatedEvent;
730
- updatedEvent?: EntityUpdatedEvent;
731
- deletedEvent?: EntityDeletedEvent;
732
- actionEvent?: ActionEvent;
733
- }
734
- export interface EntityCreatedEvent {
735
- entity?: string;
736
- }
737
- export interface RestoreInfo {
738
- deletedDate?: Date | null;
739
- }
740
- export interface EntityUpdatedEvent {
741
- /**
742
- * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
743
- * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
744
- * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
745
- */
746
- currentEntity?: string;
747
- }
748
- export interface EntityDeletedEvent {
749
- /** Entity that was deleted. */
750
- deletedEntity?: string | null;
751
- }
752
- export interface ActionEvent {
753
- body?: string;
754
- }
755
- export interface MessageEnvelope {
756
- /**
757
- * App instance ID.
758
- * @format GUID
759
- */
760
- instanceId?: string | null;
761
- /**
762
- * Event type.
763
- * @maxLength 150
764
- */
765
- eventType?: string;
766
- /** The identification type and identity data. */
767
- identity?: IdentificationData;
768
- /** Stringify payload. */
769
- data?: string;
770
- }
771
- export interface IdentificationData extends IdentificationDataIdOneOf {
772
- /**
773
- * ID of a site visitor that has not logged in to the site.
774
- * @format GUID
775
- */
776
- anonymousVisitorId?: string;
777
- /**
778
- * ID of a site visitor that has logged in to the site.
779
- * @format GUID
780
- */
781
- memberId?: string;
782
- /**
783
- * ID of a Wix user (site owner, contributor, etc.).
784
- * @format GUID
785
- */
786
- wixUserId?: string;
787
- /**
788
- * ID of an app.
789
- * @format GUID
790
- */
791
- appId?: string;
792
- /** @readonly */
793
- identityType?: WebhookIdentityTypeWithLiterals;
794
- }
795
- /** @oneof */
796
- export interface IdentificationDataIdOneOf {
797
- /**
798
- * ID of a site visitor that has not logged in to the site.
799
- * @format GUID
800
- */
801
- anonymousVisitorId?: string;
802
- /**
803
- * ID of a site visitor that has logged in to the site.
804
- * @format GUID
805
- */
806
- memberId?: string;
807
- /**
808
- * ID of a Wix user (site owner, contributor, etc.).
809
- * @format GUID
810
- */
811
- wixUserId?: string;
812
- /**
813
- * ID of an app.
814
- * @format GUID
815
- */
816
- appId?: string;
817
- }
818
- export declare enum WebhookIdentityType {
819
- UNKNOWN = "UNKNOWN",
820
- ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
821
- MEMBER = "MEMBER",
822
- WIX_USER = "WIX_USER",
823
- APP = "APP"
824
- }
825
- /** @enumType */
826
- export type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
827
- export interface ListEventsByContactIdRequest {
828
- /**
829
- * ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
830
- * to retrieve events for. Required, unless you provide `cursorPaging`.
831
- * @format GUID
832
- */
833
- contactId: string | null;
834
- /**
835
- * Local start date and time from which events are returned in
836
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
837
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
838
- *
839
- * Events that start before the `fromLocalDate` but end after it are included in
840
- * the results. Must be earlier than `toLocalDate`.
841
- * @format LOCAL_DATE_TIME
842
- */
843
- fromLocalDate?: string | null;
844
- /**
845
- * Local end date and time up to which events are returned in
846
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
847
- * `2024-01-30T13:30:00`. Can't be more than a full year after
848
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
849
- *
850
- * Events that start before `toLocalDate` but end after it are included in the
851
- * results. Must be later than `fromLocalDate`.
852
- * @format LOCAL_DATE_TIME
853
- */
854
- toLocalDate?: string | null;
855
- /**
856
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
857
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
858
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
859
- *
860
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
861
- */
862
- timeZone?: string | null;
863
- /**
864
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
865
- * to filter events by.
866
- * @format GUID
867
- */
868
- appId?: string | null;
869
- /** Cursor to retrieve the next page of the results. */
870
- cursorPaging?: CommonCursorPaging;
871
- }
872
- /** TODO Diverge */
873
- export interface CommonCursorPaging {
874
- /**
875
- * Number of events to return.
876
- * Defaults to `50`. Maximum `100`.
877
- * @min 1
878
- * @max 100
879
- */
880
- limit?: number | null;
881
- /**
882
- * Pointer to the next or previous page in the list of results.
883
- *
884
- * You can get the relevant cursor token
885
- * from the `pagingMetadata` object in the previous call's response.
886
- * Not relevant for the first request.
887
- */
888
- cursor?: string | null;
889
- }
890
- export interface ListEventsByContactIdResponse {
891
- /** Retrieved events. */
892
- events?: Event[];
893
- /** Paging metadata. */
894
- pagingMetadata?: CommonCursorPagingMetadata;
895
- }
896
- /** TODO Diverge */
897
- export interface CommonCursorPagingMetadata {
898
- /** Number of items returned in the response. */
899
- count?: number | null;
900
- /** 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). */
901
- cursors?: CommonCursors;
902
- /**
903
- * Indicates if there are more results after the current page.
904
- * If `true`, another page of results can be retrieved.
905
- * If `false`, this is the last page.
906
- */
907
- hasNext?: boolean | null;
908
- }
909
- export interface CommonCursors {
910
- /** Cursor pointing to next page in the list of results. */
911
- next?: string | null;
912
- }
913
- export interface ListEventsByMemberIdRequest {
914
- /**
915
- * ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
916
- * to retrieve events for. Required, unless you provide `cursorPaging`.
917
- * Provide `me` to retrieve events for the currently logged-in member.
918
- * You must have the `Read Calendars - Including PI`
919
- * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
920
- * to retrieve events for members who aren't the currently logged in member.
921
- * @minLength 2
922
- * @maxLength 36
923
- */
924
- memberId: string | null;
925
- /**
926
- * Local start date and time from which events are returned in
927
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
928
- * `2024-01-30T13:30:00`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
929
- *
930
- * Events that start before the `fromLocalDate` but end after it are included in
931
- * the results. Must be earlier than `toLocalDate`.
932
- * @format LOCAL_DATE_TIME
933
- */
934
- fromLocalDate?: string | null;
935
- /**
936
- * Local end date and time up to which events are returned in
937
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
938
- * `2024-01-30T13:30:00`. Can't be more than a full year after
939
- * `fromLocalDate`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
940
- *
941
- * Events that start before `toLocalDate` but end after it are included in the
942
- * results. Must be later than `fromLocalDate`.
943
- * @format LOCAL_DATE_TIME
944
- */
945
- toLocalDate?: string | null;
946
- /**
947
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
948
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
949
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
950
- *
951
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
952
- */
953
- timeZone?: string | null;
954
- /**
955
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
956
- * to filter events by.
957
- * @format GUID
958
- */
959
- appId?: string | null;
960
- /** Cursor to retrieve the next page of the results. */
961
- cursorPaging?: CommonCursorPaging;
962
- /**
963
- * IDs of the events to retrieve.
964
- * If you provide a list of IDs, all other filters are ignored.
965
- *
966
- * Max: 100 `eventId`s
967
- * @maxSize 100
968
- * @minLength 36
969
- * @maxLength 250
970
- */
971
- eventIds?: string[];
972
- }
973
- export interface ListEventsByMemberIdResponse {
974
- /** Retrieved events. */
975
- events?: Event[];
976
- /** Paging metadata. */
977
- pagingMetadata?: CommonCursorPagingMetadata;
978
- }
979
- /** Encapsulates all details written to the Greyhound topic when a site's properties are updated. */
980
- export interface SitePropertiesNotification {
981
- /** The site ID for which this update notification applies. */
982
- metasiteId?: string;
983
- /** The actual update event. */
984
- event?: SitePropertiesEvent;
985
- /**
986
- * A convenience set of mappings from the MetaSite ID to its constituent services.
987
- * @maxSize 500
988
- */
989
- translations?: Translation[];
990
- /** Context of the notification */
991
- changeContext?: ChangeContext;
992
- }
993
- /** The actual update event for a particular notification. */
994
- export interface SitePropertiesEvent {
995
- /** Version of the site's properties represented by this update. */
996
- version?: number;
997
- /** Set of properties that were updated - corresponds to the fields in "properties". */
998
- fields?: string[];
999
- /** Updated properties. */
1000
- properties?: Properties;
1001
- }
1002
- export interface Properties {
1003
- /** Site categories. */
1004
- categories?: Categories;
1005
- /** Site locale. */
1006
- locale?: Locale;
1007
- /**
1008
- * Site language.
1009
- *
1010
- * Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
1011
- */
1012
- language?: string | null;
1013
- /**
1014
- * Site currency format used to bill customers.
1015
- *
1016
- * Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
1017
- */
1018
- paymentCurrency?: string | null;
1019
- /** Timezone in `America/New_York` format. */
1020
- timeZone?: string | null;
1021
- /** Email address. */
1022
- email?: string | null;
1023
- /** Phone number. */
1024
- phone?: string | null;
1025
- /** Fax number. */
1026
- fax?: string | null;
1027
- /** Address. */
1028
- address?: Address;
1029
- /** Site display name. */
1030
- siteDisplayName?: string | null;
1031
- /** Business name. */
1032
- businessName?: string | null;
1033
- /** Path to the site's logo in Wix Media (without Wix Media base URL). */
1034
- logo?: string | null;
1035
- /** Site description. */
1036
- description?: string | null;
1037
- /**
1038
- * Business schedule. Regular and exceptional time periods when the business is open or the service is available.
1039
- *
1040
- * __Note:__ Not supported by Wix Bookings.
1041
- */
1042
- businessSchedule?: BusinessSchedule;
1043
- /** Supported languages of a site and the primary language. */
1044
- multilingual?: Multilingual;
1045
- /** Cookie policy the Wix user defined for their site (before the site visitor interacts with/limits it). */
1046
- consentPolicy?: ConsentPolicy;
1047
- /**
1048
- * Supported values: `FITNESS SERVICE`, `RESTAURANT`, `BLOG`, `STORE`, `EVENT`, `UNKNOWN`.
1049
- *
1050
- * Site business type.
1051
- */
1052
- businessConfig?: string | null;
1053
- /** External site URL that uses Wix as its headless business solution. */
1054
- externalSiteUrl?: string | null;
1055
- /** Track clicks analytics. */
1056
- trackClicksAnalytics?: boolean;
1057
- }
1058
- export interface Categories {
1059
- /** Primary site category. */
1060
- primary?: string;
1061
- /**
1062
- * Secondary site category.
1063
- * @maxSize 50
1064
- */
1065
- secondary?: string[];
1066
- /** Business Term Id */
1067
- businessTermId?: string | null;
1068
- }
1069
- export interface Locale {
1070
- /** Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. */
1071
- languageCode?: string;
1072
- /** Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. */
1073
- country?: string;
1074
- }
1075
- export interface Address {
1076
- /** Street name. */
1077
- street?: string;
1078
- /** City name. */
1079
- city?: string;
1080
- /** Two-letter country code in an [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. */
1081
- country?: string;
1082
- /** State. */
1083
- state?: string;
1084
- /**
1085
- * Zip or postal code.
1086
- * @maxLength 20
1087
- */
1088
- zip?: string;
1089
- /** Extra information to be displayed in the address. */
1090
- hint?: AddressHint;
1091
- /** Whether this address represents a physical location. */
1092
- isPhysical?: boolean;
1093
- /** Google-formatted version of this address. */
1094
- googleFormattedAddress?: string;
1095
- /** Street number. */
1096
- streetNumber?: string;
1097
- /** Apartment number. */
1098
- apartmentNumber?: string;
1099
- /** Geographic coordinates of location. */
1100
- coordinates?: GeoCoordinates;
1101
- }
1102
- /**
1103
- * Extra information on displayed addresses.
1104
- * This is used for display purposes. Used to add additional data about the address, such as "In the passage".
1105
- * Free text. In addition, the user can state where to display the additional description - before, after, or instead of the address string.
1106
- */
1107
- export interface AddressHint {
1108
- /** Extra text displayed next to, or instead of, the actual address. */
1109
- text?: string;
1110
- /** Where the extra text should be displayed. */
1111
- placement?: PlacementTypeWithLiterals;
1112
- }
1113
- /** Where the extra text should be displayed: before, after or instead of the actual address. */
1114
- export declare enum PlacementType {
1115
- BEFORE = "BEFORE",
1116
- AFTER = "AFTER",
1117
- REPLACE = "REPLACE"
1118
- }
1119
- /** @enumType */
1120
- export type PlacementTypeWithLiterals = PlacementType | 'BEFORE' | 'AFTER' | 'REPLACE';
1121
- /** Geocoordinates for a particular address. */
1122
- export interface GeoCoordinates {
1123
- /** Latitude of the location. Must be between -90 and 90. */
1124
- latitude?: number;
1125
- /** Longitude of the location. Must be between -180 and 180. */
1126
- longitude?: number;
1127
- }
1128
- /** Business schedule. Regular and exceptional time periods when the business is open or the service is available. */
1129
- export interface BusinessSchedule {
1130
- /**
1131
- * Weekly recurring time periods when the business is regularly open or the service is available. Limited to 100 time periods.
1132
- * @maxSize 100
1133
- */
1134
- periods?: TimePeriod[];
1135
- /**
1136
- * Exceptions to the business's regular hours. The business can be open or closed during the exception.
1137
- * @maxSize 100
1138
- */
1139
- specialHourPeriod?: SpecialHourPeriod[];
1140
- }
1141
- /** Weekly recurring time periods when the business is regularly open or the service is available. */
1142
- export interface TimePeriod {
1143
- /** Day of the week the period starts on. */
1144
- openDay?: DayOfWeekWithLiterals;
1145
- /**
1146
- * Time the period starts in 24-hour [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) extended format. Valid values are `00:00` to `24:00`, where `24:00` represents
1147
- * midnight at the end of the specified day.
1148
- */
1149
- openTime?: string;
1150
- /** Day of the week the period ends on. */
1151
- closeDay?: DayOfWeekWithLiterals;
1152
- /**
1153
- * Time the period ends in 24-hour [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) extended format. Valid values are `00:00` to `24:00`, where `24:00` represents
1154
- * midnight at the end of the specified day.
1155
- *
1156
- * __Note:__ If `openDay` and `closeDay` specify the same day of the week `closeTime` must be later than `openTime`.
1157
- */
1158
- closeTime?: string;
1159
- }
1160
- /** Enumerates the days of the week. */
1161
- export declare enum DayOfWeek {
1162
- MONDAY = "MONDAY",
1163
- TUESDAY = "TUESDAY",
1164
- WEDNESDAY = "WEDNESDAY",
1165
- THURSDAY = "THURSDAY",
1166
- FRIDAY = "FRIDAY",
1167
- SATURDAY = "SATURDAY",
1168
- SUNDAY = "SUNDAY"
1169
- }
1170
- /** @enumType */
1171
- export type DayOfWeekWithLiterals = DayOfWeek | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY';
1172
- /** Exception to the business's regular hours. The business can be open or closed during the exception. */
1173
- export interface SpecialHourPeriod {
1174
- /** Start date and time of the exception in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format and [Coordinated Universal Time (UTC)](https://en.wikipedia.org/wiki/Coordinated_Universal_Time). */
1175
- startDate?: string;
1176
- /** End date and time of the exception in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format and [Coordinated Universal Time (UTC)](https://en.wikipedia.org/wiki/Coordinated_Universal_Time). */
1177
- endDate?: string;
1178
- /**
1179
- * Whether the business is closed (or the service is not available) during the exception.
1180
- *
1181
- * Default: `true`.
1182
- */
1183
- isClosed?: boolean;
1184
- /** Additional info about the exception. For example, "We close earlier on New Year's Eve." */
1185
- comment?: string;
1186
- }
1187
- export interface Multilingual {
1188
- /**
1189
- * Supported languages list.
1190
- * @maxSize 200
1191
- */
1192
- supportedLanguages?: SupportedLanguage[];
1193
- /** Whether to redirect to user language. */
1194
- autoRedirect?: boolean;
1195
- }
1196
- export interface SupportedLanguage {
1197
- /** Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. */
1198
- languageCode?: string;
1199
- /** Locale. */
1200
- locale?: Locale;
1201
- /** Whether the supported language is the primary language for the site. */
1202
- isPrimary?: boolean;
1203
- /** Language icon. */
1204
- countryCode?: string;
1205
- /** How the language will be resolved. For internal use. */
1206
- resolutionMethod?: ResolutionMethodWithLiterals;
1207
- /** Whether the supported language is the primary language for site visitors. */
1208
- isVisitorPrimary?: boolean | null;
1209
- }
1210
- export declare enum ResolutionMethod {
1211
- QUERY_PARAM = "QUERY_PARAM",
1212
- SUBDOMAIN = "SUBDOMAIN",
1213
- SUBDIRECTORY = "SUBDIRECTORY"
1214
- }
1215
- /** @enumType */
1216
- export type ResolutionMethodWithLiterals = ResolutionMethod | 'QUERY_PARAM' | 'SUBDOMAIN' | 'SUBDIRECTORY';
1217
- export interface ConsentPolicy {
1218
- /** Whether the site uses cookies that are essential to site operation. Always `true`. */
1219
- essential?: boolean | null;
1220
- /** Whether the site uses cookies that affect site performance and other functional measurements. */
1221
- functional?: boolean | null;
1222
- /** Whether the site uses cookies that collect analytics about how the site is used (in order to improve it). */
1223
- analytics?: boolean | null;
1224
- /** Whether the site uses cookies that collect information allowing better customization of the experience for a current visitor. */
1225
- advertising?: boolean | null;
1226
- /** CCPA compliance flag. */
1227
- dataToThirdParty?: boolean | null;
1228
- }
1229
- /** A single mapping from the MetaSite ID to a particular service. */
1230
- export interface Translation {
1231
- /** The service type. */
1232
- serviceType?: string;
1233
- /** The application definition ID; this only applies to services of type ThirdPartyApps. */
1234
- appDefId?: string;
1235
- /** The instance ID of the service. */
1236
- instanceId?: string;
1237
- }
1238
- export interface ChangeContext extends ChangeContextPayloadOneOf {
1239
- /** Properties were updated. */
1240
- propertiesChange?: PropertiesChange;
1241
- /** Default properties were created on site creation. */
1242
- siteCreated?: SiteCreated;
1243
- /** Properties were cloned on site cloning. */
1244
- siteCloned?: SiteCloned;
1245
- }
1246
- /** @oneof */
1247
- export interface ChangeContextPayloadOneOf {
1248
- /** Properties were updated. */
1249
- propertiesChange?: PropertiesChange;
1250
- /** Default properties were created on site creation. */
1251
- siteCreated?: SiteCreated;
1252
- /** Properties were cloned on site cloning. */
1253
- siteCloned?: SiteCloned;
1254
- }
1255
- export interface PropertiesChange {
1256
- }
1257
- export interface SiteCreated {
1258
- /** Origin template site id. */
1259
- originTemplateId?: string | null;
1260
- }
1261
- export interface SiteCloned {
1262
- /** Origin site id. */
1263
- originMetaSiteId?: string;
1264
- }
1265
- export interface Empty {
1266
- }
1267
- export interface GetEventRequest {
1268
- /**
1269
- * ID of the event to retrieve.
1270
- *
1271
- * Min: 36 characters
1272
- * Max: 250 characters
1273
- * @minLength 36
1274
- * @maxLength 250
1275
- */
1276
- eventId: string | null;
1277
- /**
1278
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1279
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1280
- * `America/New_York` or `UTC`.
1281
- *
1282
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1283
- */
1284
- timeZone?: string | null;
1285
- /**
1286
- * Information about which fields containing personal data to return. Refer to the
1287
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
1288
- * for more information.
1289
- *
1290
- * Supported values:
1291
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
1292
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
1293
- *
1294
- * Max: 1 field
1295
- * Default: No personal data is returned.
1296
- * @maxSize 1
1297
- */
1298
- fields?: RequestedFieldsWithLiterals[];
1299
- }
1300
- export declare enum RequestedFields {
1301
- UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
1302
- /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
1303
- PI_FIELDS = "PI_FIELDS",
1304
- /** Returns only fields containing your own personal data. */
1305
- OWN_PI_FIELDS = "OWN_PI_FIELDS"
1306
- }
1307
- /** @enumType */
1308
- export type RequestedFieldsWithLiterals = RequestedFields | 'UNKNOWN_REQUESTED_FIELDS' | 'PI_FIELDS' | 'OWN_PI_FIELDS';
1309
- export interface GetEventResponse {
1310
- /** Retrieved event. */
1311
- event?: Event;
1312
- }
1313
- export interface ListEventsRequest {
1314
- /**
1315
- * IDs of the events to retrieve.
1316
- *
1317
- * Min: 1 event ID
1318
- * Min: 100 event IDs
1319
- * @minSize 1
1320
- * @maxSize 100
1321
- * @minLength 36
1322
- * @maxLength 250
1323
- */
1324
- eventIds: string[];
1325
- /**
1326
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1327
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1328
- * `America/New_York` or `UTC`.
1329
- *
1330
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1331
- */
1332
- timeZone?: string | null;
1333
- /**
1334
- * Information about which fields containing personal data to return. Refer to the
1335
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
1336
- * for more information.
1337
- *
1338
- * Supported values:
1339
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
1340
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
1341
- *
1342
- * Max: 1 field
1343
- * Default: No personal data is returned.
1344
- * @maxSize 1
1345
- */
1346
- fields?: RequestedFieldsWithLiterals[];
1347
- }
1348
- export interface ListEventsResponse {
1349
- /** Retrieved events matching the provided IDs. */
1350
- events?: Event[];
1351
- }
1352
- export interface QueryEventsRequest {
1353
- /**
1354
- * Local start date and time from which events are returned in
1355
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1356
- * `2024-01-30T13:30:00`.
1357
- *
1358
- * Events that start before the `fromLocalDate` but end after it are included in
1359
- * the results. Must be earlier than `toLocalDate` unless the sort order is
1360
- * descending.
1361
- * @format LOCAL_DATE_TIME
1362
- */
1363
- fromLocalDate?: string | null;
1364
- /**
1365
- * Local end date and time up to which events are returned in
1366
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1367
- * `2024-01-30T13:30:00`.
1368
- *
1369
- * Events that start before `toLocalDate` but end after it are included in the
1370
- * results. Must be later than `fromLocalDate` unless the sort order is
1371
- * descending.
1372
- * @format LOCAL_DATE_TIME
1373
- */
1374
- toLocalDate?: string | null;
1375
- /**
1376
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1377
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
1378
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
1379
- *
1380
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
1381
- */
1382
- timeZone?: string | null;
1383
- /**
1384
- * Query containing filters and paging.
1385
- * Do not specify filters for start and end dates inside `query.filter`, instead
1386
- * specify `fromLocalDate` and `toLocalDate`.
1387
- */
1388
- query?: CursorQuery;
1389
- /**
1390
- * Filters events based on their `recurrenceType`.
1391
- *
1392
- * Max: 5 recurrence types can be specified.
1393
- * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
1394
- * @maxSize 5
1395
- */
1396
- recurrenceType?: RecurrenceTypeWithLiterals[];
1397
- /**
1398
- * Information about which fields containing personal data to return. Refer to the
1399
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
1400
- * for more information.
1401
- *
1402
- * Supported values:
1403
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
1404
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
1405
- *
1406
- * Max: 1 field
1407
- * Default: No personal data is returned.
1408
- * @maxSize 1
1409
- */
1410
- fields?: RequestedFieldsWithLiterals[];
1411
- }
1412
- /** TODO Diverge */
1413
- export interface CursorQuery extends CursorQueryPagingMethodOneOf {
1414
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
1415
- cursorPaging?: CursorPaging;
1416
- /**
1417
- * Filter object.
1418
- * See API Query Language
1419
- * ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/api-query-language) | [REST](https://dev.wix.com/api/rest/getting-started/api-query-language))
1420
- * for more information.
1421
- *
1422
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
1423
- *
1424
- * Do not specify filters for start and end dates inside `query.filter`, instead
1425
- * specify `fromLocalDate` and `toLocalDate`. For a detailed list of supported
1426
- * filters, refer to the supported filters article
1427
- * ([REST](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/supported-filters-and-sorting)).
1428
- */
1429
- filter?: Record<string, any> | null;
1430
- /**
1431
- * Whether to sort events by their start date in ascending order or by their end date in descending order.
1432
- * Default is start ascending.
1433
- * @maxSize 1
1434
- */
1435
- sort?: Sorting[];
1436
- }
1437
- /** @oneof */
1438
- export interface CursorQueryPagingMethodOneOf {
1439
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
1440
- cursorPaging?: CursorPaging;
1441
- }
1442
- /** TODO Diverge */
1443
- export interface Sorting {
1444
- /**
1445
- * The field to sort by.
1446
- * Either `start` or `end`.
1447
- * Default is `start`.
1448
- */
1449
- fieldName?: string;
1450
- /** Sort order. */
1451
- order?: SortOrderWithLiterals;
1452
- }
1453
- export declare enum SortOrder {
1454
- ASC = "ASC",
1455
- DESC = "DESC"
1456
- }
1457
- /** @enumType */
1458
- export type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
1459
- /** TODO Diverge */
1460
- export interface CursorPaging {
1461
- /**
1462
- * Number of events to return.
1463
- * Defaults to `50`. Maximum `1000`.
1464
- * @min 1
1465
- * @max 1000
1466
- */
1467
- limit?: number | null;
1468
- /**
1469
- * Pointer to the next or previous page in the list of results.
1470
- *
1471
- * You can get the relevant cursor token
1472
- * from the `pagingMetadata` object in the previous call's response.
1473
- * Not relevant for the first request.
1474
- */
1475
- cursor?: string | null;
1476
- }
1477
- export interface QueryEventsResponse {
1478
- /** Retrieved events matching the provided query. */
1479
- events?: Event[];
1480
- /** Paging metadata. */
1481
- pagingMetadata?: CursorPagingMetadata;
1482
- }
1483
- /** TODO Diverge */
1484
- export interface CursorPagingMetadata {
1485
- /** Number of items returned in the response. */
1486
- count?: number | null;
1487
- /** 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). */
1488
- cursors?: Cursors;
1489
- /**
1490
- * Indicates if there are more results after the current page.
1491
- * If `true`, another page of results can be retrieved.
1492
- * If `false`, this is the last page.
1493
- */
1494
- hasNext?: boolean | null;
1495
- }
1496
- export interface Cursors {
1497
- /** Cursor pointing to next page in the list of results. */
1498
- next?: string | null;
1499
- }
1500
- export interface ListRecurringEventInstancesHistoryRequest {
1501
- /**
1502
- * The ID of the recurring event.
1503
- * Required, unless `cursorPaging` is provided.
1504
- * @minLength 64
1505
- * @maxLength 64
1506
- */
1507
- recurringEventId?: string | null;
1508
- /**
1509
- * The revision of the recurring event.
1510
- * Required, unless `cursorPaging` is provided.
1511
- */
1512
- revision?: string | null;
1513
- /**
1514
- * Inclusive start date for which events are returned, in ISO-8601 format.
1515
- * Events that begin at or after the `fromDate` are included in the results.
1516
- * Required, unless `cursorPaging` is provided.
1517
- */
1518
- fromDate?: Date | null;
1519
- /**
1520
- * Exclusive end date for which events are returned, in ISO-8601 format.
1521
- * Events that begin before the `toDate` are included in the results.
1522
- * Required, unless `cursorPaging` is provided.
1523
- */
1524
- toDate?: Date | null;
1525
- /** Optional cursor pointing to the next page of events. */
1526
- cursorPaging?: CursorPaging;
1527
- }
1528
- export interface ListRecurringEventInstancesHistoryResponse {
1529
- /** The recurring event instances. */
1530
- recurringEventInstances?: Event[];
1531
- /** Paging metadata. */
1532
- pagingMetadata?: CursorPagingMetadata;
1533
- }
1534
- export interface CreateEventRequest {
1535
- /** Event to create. */
1536
- event: Event;
1537
- /**
1538
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1539
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1540
- * `America/New_York` or `UTC`.
1541
- *
1542
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1543
- */
1544
- timeZone?: string | null;
1545
- /**
1546
- * Idempotency key guaranteeing that you don't create the same event more
1547
- * than once.
1548
- * @format GUID
1549
- */
1550
- idempotencyKey?: string | null;
1551
- }
1552
- export interface CreateEventResponse {
1553
- /** Created event. */
1554
- event?: Event;
1555
- }
1556
- export interface BulkCreateEventRequest {
1557
- /**
1558
- * Events to create.
1559
- * @minSize 1
1560
- * @maxSize 50
1561
- */
1562
- events: MaskedEvent[];
1563
- /**
1564
- * Whether to return created events.
1565
- *
1566
- * Default: `false`.
1567
- */
1568
- returnEntity?: boolean | null;
1569
- /**
1570
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1571
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1572
- * `America/New_York` or `UTC`.
1573
- *
1574
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1575
- */
1576
- timeZone?: string | null;
1577
- }
1578
- export interface MaskedEvent {
1579
- /** Event to create. */
1580
- event?: Event;
1581
- }
1582
- export interface BulkCreateEventResponse {
1583
- /** The result for each event, containing the event and whether the action was successful. */
1584
- results?: BulkEventResult[];
1585
- /** Total successes and failures. */
1586
- bulkActionMetadata?: BulkActionMetadata;
1587
- }
1588
- export interface BulkEventResult {
1589
- /** Whether the requested action was successful. */
1590
- itemMetadata?: ItemMetadata;
1591
- /** The event. */
1592
- item?: Event;
1593
- }
1594
- export interface ItemMetadata {
1595
- /**
1596
- * Event ID.
1597
- * Should always be available, unless it's impossible (for example, when failing to create an event).
1598
- */
1599
- _id?: string | null;
1600
- /** Index of the item within the request array, for correlation between request and response items. */
1601
- originalIndex?: number;
1602
- /**
1603
- * Whether the requested action was successful for this event.
1604
- * When `false`, the `error` field is populated.
1605
- */
1606
- success?: boolean;
1607
- /** Details about the error in case of failure. */
1608
- error?: ApplicationError;
1609
- }
1610
- export interface ApplicationError {
1611
- /** Error code. */
1612
- code?: string;
1613
- /** Description of the error. */
1614
- description?: string;
1615
- /** Data related to the error. */
1616
- data?: Record<string, any> | null;
1617
- }
1618
- export interface BulkActionMetadata {
1619
- /** Number of events that were successfully processed. */
1620
- totalSuccesses?: number;
1621
- /** Number of events that couldn't be processed. */
1622
- totalFailures?: number;
1623
- }
1624
- export interface UpdateEventRequest {
1625
- /** Event to update. */
1626
- event: Event;
1627
- /**
1628
- * Information about whether participants of the updated event are notified and
1629
- * the message they receive.
1630
- */
1631
- participantNotification?: ParticipantNotification;
1632
- /**
1633
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1634
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1635
- * `America/New_York` or `UTC`.
1636
- *
1637
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1638
- */
1639
- timeZone?: string | null;
1640
- }
1641
- export interface UpdateEventResponse {
1642
- /** Updated event. */
1643
- event?: Event;
1644
- }
1645
- export interface BulkUpdateEventRequest {
1646
- /**
1647
- * Events to update.
1648
- *
1649
- * Min: 1 event
1650
- * Max: 50 events
1651
- * @minSize 1
1652
- * @maxSize 50
1653
- */
1654
- events: BulkUpdateEventRequestMaskedEvent[];
1655
- /**
1656
- * Whether to return the updated events.
1657
- *
1658
- * Default: `false`
1659
- */
1660
- returnEntity?: boolean | null;
1661
- /**
1662
- * Information about whether participants of the updated event are notified and
1663
- * the message they receive.
1664
- */
1665
- participantNotification?: ParticipantNotification;
1666
- /**
1667
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1668
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1669
- * `America/New_York` or `UTC`.
1670
- *
1671
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1672
- */
1673
- timeZone?: string | null;
1674
- }
1675
- export interface BulkUpdateEventRequestMaskedEvent {
1676
- /** Event to update. */
1677
- event?: Event;
1678
- }
1679
- export interface BulkUpdateEventResponse {
1680
- /** The result for each event, containing the event and whether the action was successful. */
1681
- results?: BulkEventResult[];
1682
- /** Total successes and failures. */
1683
- bulkActionMetadata?: BulkActionMetadata;
1684
- }
1685
- export interface UpdateEventParticipantsRequest {
1686
- /**
1687
- * ID of the event to update.
1688
- *
1689
- * Min: 36 characters
1690
- * Max: 250 characters
1691
- * @minLength 36
1692
- * @maxLength 250
1693
- */
1694
- eventId?: string | null;
1695
- /** The participants to update. */
1696
- participants?: Participants;
1697
- }
1698
- export interface UpdateEventParticipantsResponse {
1699
- /** Updated event. */
1700
- event?: Event;
1701
- }
1702
- export interface RestoreEventDefaultsRequest {
1703
- /**
1704
- * ID of the event for which to restore default values.
1705
- * @minLength 36
1706
- * @maxLength 250
1707
- */
1708
- eventId: string | null;
1709
- /**
1710
- * Fields for which to restore default values.
1711
- *
1712
- * `TIME` restores default values for `start` and `end`.
1713
- *
1714
- * Min: 1 field
1715
- * @minSize 1
1716
- */
1717
- fields: FieldWithLiterals[];
1718
- /**
1719
- * Information about whether participants of the updated event are notified and
1720
- * the message they receive.
1721
- */
1722
- participantNotification?: ParticipantNotification;
1723
- /**
1724
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1725
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1726
- * `America/New_York` or `UTC`.
1727
- *
1728
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1729
- */
1730
- timeZone?: string | null;
1731
- }
1732
- export interface RestoreEventDefaultsResponse {
1733
- /** Updated event. */
1734
- event?: Event;
1735
- }
1736
- export interface SplitRecurringEventRequest {
1737
- /**
1738
- * ID of the `MASTER` event to split.
1739
- * @minLength 36
1740
- * @maxLength 250
1741
- */
1742
- recurringEventId: string | null;
1743
- /**
1744
- * Local date and time at which the `MASTER` event is split in
1745
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
1746
- * `2025-03-11T09:00:00`.
1747
- * Must be a future date that's after the `start` date of the next `INSTANCE` or
1748
- * `EXCEPTION` event in the series. Additionally, there must be another
1749
- * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
1750
- * wouldn't affect any event without a subsequent occurrence.
1751
- * @format LOCAL_DATE_TIME
1752
- */
1753
- splitLocalDate: string | null;
1754
- /**
1755
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1756
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1757
- * `America/New_York` or `UTC`.
1758
- *
1759
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1760
- */
1761
- timeZone?: string | null;
1762
- }
1763
- export interface SplitRecurringEventResponse {
1764
- /** Original `MASTER` event that was shortened. */
1765
- updatedRecurringEventEndingBeforeSplit?: Event;
1766
- /** New `MASTER` event starting with the first event after the split date. */
1767
- newRecurringEventStartingFromSplit?: Event;
1768
- }
1769
- export interface CancelEventRequest {
1770
- /**
1771
- * ID of the event to cancel.
1772
- * @minLength 36
1773
- * @maxLength 250
1774
- */
1775
- eventId: string | null;
1776
- /**
1777
- * Information about whether participants of the canceled event are notified and
1778
- * the message they receive.
1779
- */
1780
- participantNotification?: ParticipantNotification;
1781
- /**
1782
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1783
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1784
- * `America/New_York` or `UTC`.
1785
- *
1786
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1787
- */
1788
- timeZone?: string | null;
1789
- }
1790
- export interface CancelEventResponse {
1791
- /** Canceled event. */
1792
- event?: Event;
1793
- }
1794
- export interface BulkCancelEventRequest {
1795
- /**
1796
- * IDs of the events to cancel.
1797
- * @minSize 1
1798
- * @maxSize 50
1799
- */
1800
- eventIds: string[];
1801
- /**
1802
- * Whether to return the canceled events.
1803
- *
1804
- * Default: `false`
1805
- */
1806
- returnEntity?: boolean | null;
1807
- /**
1808
- * Information about whether participants of the canceled events are notified and
1809
- * the message they receive.
1810
- */
1811
- participantNotification?: ParticipantNotification;
1812
- /**
1813
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
1814
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
1815
- * `America/New_York` or `UTC`.
1816
- *
1817
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
1818
- */
1819
- timeZone?: string | null;
1820
- }
1821
- export interface BulkCancelEventResponse {
1822
- /** The result for each event, containing the event and whether the action was successful. */
1823
- results?: BulkEventResult[];
1824
- /** Total successes and failures. */
1825
- bulkActionMetadata?: BulkActionMetadata;
1826
- }
1827
- export interface BaseEventMetadata {
1828
- /**
1829
- * App instance ID.
1830
- * @format GUID
1831
- */
1832
- instanceId?: string | null;
1833
- /**
1834
- * Event type.
1835
- * @maxLength 150
1836
- */
1837
- eventType?: string;
1838
- /** The identification type and identity data. */
1839
- identity?: IdentificationData;
1840
- }
1841
- export interface EventMetadata extends BaseEventMetadata {
1842
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
1843
- _id?: string;
1844
- /**
1845
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
1846
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
1847
- */
1848
- entityFqdn?: string;
1849
- /**
1850
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
1851
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
1852
- */
1853
- slug?: string;
1854
- /** ID of the entity associated with the event. */
1855
- entityId?: string;
1856
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
1857
- eventTime?: Date | null;
1858
- /**
1859
- * Whether the event was triggered as a result of a privacy regulation application
1860
- * (for example, GDPR).
1861
- */
1862
- triggeredByAnonymizeRequest?: boolean | null;
1863
- /** If present, indicates the action that triggered the event. */
1864
- originatedFrom?: string | null;
1865
- /**
1866
- * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
1867
- * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
1868
- */
1869
- entityEventSequence?: string | null;
1870
- }
1871
- export interface EventCancelledEnvelope {
1872
- data: EventCancelled;
1873
- metadata: EventMetadata;
1874
- }
1875
- /**
1876
- * Triggered when an event is canceled.
1877
- *
1878
- * Not triggered when `INSTANCE` events are canceled. You can use the
1879
- * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
1880
- * to get notified about `INSTANCE` events.
1881
- * @permissionScope Read Calendar - Including PI
1882
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
1883
- * @permissionScope Manage Calendars
1884
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
1885
- * @permissionScope Manage Bookings
1886
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
1887
- * @permissionScope Read Bookings - Including Participants
1888
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
1889
- * @permissionScope Read Bookings - all read permissions
1890
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
1891
- * @permissionScope Manage Bookings - all permissions
1892
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
1893
- * @permissionScope Read bookings calendar - including participants
1894
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
1895
- * @permissionId CALENDAR.EVENT_READ_PI
1896
- * @webhook
1897
- * @eventType wix.calendar.v3.event_cancelled
1898
- * @slug cancelled
1899
- */
1900
- export declare function onEventCancelled(handler: (event: EventCancelledEnvelope) => void | Promise<void>): void;
1901
- export interface EventCreatedEnvelope {
1902
- entity: Event;
1903
- metadata: EventMetadata;
1904
- }
1905
- /**
1906
- * Triggered when an event is created, including when an existing `MASTER`
1907
- * event is split.
1908
- *
1909
- * Not triggered when `INSTANCE` events are created. You can use the
1910
- * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
1911
- * to get notified about `INSTANCE` events.
1912
- * @permissionScope Read Calendar - Including PI
1913
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
1914
- * @permissionScope Manage Calendars
1915
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
1916
- * @permissionScope Manage Bookings
1917
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
1918
- * @permissionScope Read Bookings - Including Participants
1919
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
1920
- * @permissionScope Read Bookings - all read permissions
1921
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
1922
- * @permissionScope Manage Bookings - all permissions
1923
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
1924
- * @permissionScope Read bookings calendar - including participants
1925
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
1926
- * @permissionId CALENDAR.EVENT_READ_PI
1927
- * @webhook
1928
- * @eventType wix.calendar.v3.event_created
1929
- * @slug created
1930
- */
1931
- export declare function onEventCreated(handler: (event: EventCreatedEnvelope) => void | Promise<void>): void;
1932
- export interface EventRecurringSplitEnvelope {
1933
- data: RecurringEventSplit;
1934
- metadata: EventMetadata;
1935
- }
1936
- /**
1937
- * Triggered when a `MASTER` event is split.
1938
- * @permissionScope Read Calendar - Including PI
1939
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
1940
- * @permissionScope Manage Calendars
1941
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
1942
- * @permissionScope Manage Bookings
1943
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
1944
- * @permissionScope Read Bookings - Including Participants
1945
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
1946
- * @permissionScope Read Bookings - all read permissions
1947
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
1948
- * @permissionScope Manage Bookings - all permissions
1949
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
1950
- * @permissionScope Read bookings calendar - including participants
1951
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
1952
- * @permissionId CALENDAR.EVENT_READ_PI
1953
- * @webhook
1954
- * @eventType wix.calendar.v3.event_recurring_split
1955
- * @slug recurring_split
1956
- */
1957
- export declare function onEventRecurringSplit(handler: (event: EventRecurringSplitEnvelope) => void | Promise<void>): void;
1958
- export interface EventUpdatedEnvelope {
1959
- entity: Event;
1960
- metadata: EventMetadata;
1961
- }
1962
- /**
1963
- * Triggered when an event is updated, including when it's canceled.
1964
- *
1965
- * Not triggered when `INSTANCE` events are updated. You can use the
1966
- * [Events View API](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction)
1967
- * to get notified about `INSTANCE` events.
1968
- * @permissionScope Read Calendar - Including PI
1969
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
1970
- * @permissionScope Manage Calendars
1971
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
1972
- * @permissionScope Manage Bookings
1973
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
1974
- * @permissionScope Read Bookings - Including Participants
1975
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
1976
- * @permissionScope Read Bookings - all read permissions
1977
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
1978
- * @permissionScope Manage Bookings - all permissions
1979
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
1980
- * @permissionScope Read bookings calendar - including participants
1981
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
1982
- * @permissionId CALENDAR.EVENT_READ_PI
1983
- * @webhook
1984
- * @eventType wix.calendar.v3.event_updated
1985
- * @slug updated
1986
- */
1987
- export declare function onEventUpdated(handler: (event: EventUpdatedEnvelope) => void | Promise<void>): void;
1988
- type EventNonNullablePaths = `status` | `recurrenceType` | `recurrenceRule.frequency` | `recurrenceRule.days` | `transparency` | `location.type` | `resources` | `resources.${number}.transparency` | `resources.${number}.permissionRole` | `participants.list` | `participants.status` | `conferencingDetails.type` | `inheritedFields` | `permissions` | `permissions.${number}.identity.wixUserId` | `permissions.${number}.role`;
1989
- /**
1990
- * Retrieves a list of events filtered by the participant's
1991
- * [contact](https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/introduction)
1992
- * ID.
1993
- *
1994
- *
1995
- * You can't set `toLocalDate` to a value that's more than a full year after
1996
- * `fromLocalDate`.
1997
- * @param contactId - ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
1998
- * to retrieve events for. Required, unless you provide `cursorPaging`.
1999
- * @public
2000
- * @requiredField contactId
2001
- * @permissionId CALENDAR.EVENT_READ_PI
2002
- * @permissionScope Read Calendar - Including PI
2003
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2004
- * @permissionScope Manage Calendars
2005
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2006
- * @permissionScope Manage Bookings
2007
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2008
- * @permissionScope Read Bookings - Including Participants
2009
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2010
- * @permissionScope Read Bookings - all read permissions
2011
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2012
- * @permissionScope Manage Bookings - all permissions
2013
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2014
- * @permissionScope Read bookings calendar - including participants
2015
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2016
- * @applicableIdentity APP
2017
- * @fqn wix.calendar.participantevents.v3.ParticipantEventsService.ListEventsByContactId
2018
- */
2019
- export declare function listEventsByContactId(contactId: string, options?: ListEventsByContactIdOptions): Promise<NonNullablePaths<ListEventsByContactIdResponse, {
2020
- [P in EventNonNullablePaths]: `events.${number}.${P}`;
2021
- }[EventNonNullablePaths]>>;
2022
- export interface ListEventsByContactIdOptions {
2023
- /**
2024
- * Local start date and time from which events are returned in
2025
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2026
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
2027
- *
2028
- * Events that start before the `fromLocalDate` but end after it are included in
2029
- * the results. Must be earlier than `toLocalDate`.
2030
- * @format LOCAL_DATE_TIME
2031
- */
2032
- fromLocalDate?: string | null;
2033
- /**
2034
- * Local end date and time up to which events are returned in
2035
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2036
- * `2024-01-30T13:30:00`. Can't be more than a full year after
2037
- * `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
2038
- *
2039
- * Events that start before `toLocalDate` but end after it are included in the
2040
- * results. Must be later than `fromLocalDate`.
2041
- * @format LOCAL_DATE_TIME
2042
- */
2043
- toLocalDate?: string | null;
2044
- /**
2045
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2046
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
2047
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
2048
- *
2049
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2050
- */
2051
- timeZone?: string | null;
2052
- /**
2053
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
2054
- * to filter events by.
2055
- * @format GUID
2056
- */
2057
- appId?: string | null;
2058
- /** Cursor to retrieve the next page of the results. */
2059
- cursorPaging?: CommonCursorPaging;
2060
- }
2061
- /**
2062
- * Retrieves a list of events filtered by the participant's
2063
- * [member](https://dev.wix.com/docs/sdk/backend-modules/members/members/introduction)
2064
- * ID.
2065
- *
2066
- *
2067
- * You can't set `toLocalDate` to a value that's more than a full year after
2068
- * `fromLocalDate`.
2069
- * @param memberId - ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
2070
- * to retrieve events for. Required, unless you provide `cursorPaging`.
2071
- * Provide `me` to retrieve events for the currently logged-in member.
2072
- * You must have the `Read Calendars - Including PI`
2073
- * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
2074
- * to retrieve events for members who aren't the currently logged in member.
2075
- * @public
2076
- * @requiredField memberId
2077
- * @permissionId CALENDAR.EVENT_READ
2078
- * @permissionId CALENDAR.EVENT_READ_PI
2079
- * @permissionScope Read Bookings - Public Data
2080
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-PUBLIC
2081
- * @permissionScope Read Calendar - Including PI
2082
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2083
- * @permissionScope Manage Calendars
2084
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2085
- * @permissionScope Manage Bookings
2086
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2087
- * @permissionScope Read Bookings - Including Participants
2088
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2089
- * @permissionScope Read Bookings - all read permissions
2090
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2091
- * @permissionScope Read Bookings Calendar Availability
2092
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR
2093
- * @permissionScope Read Calendar
2094
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PUBLIC
2095
- * @permissionScope Manage Bookings - all permissions
2096
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2097
- * @permissionScope Read bookings calendar - including participants
2098
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2099
- * @permissionScope Read Bookings Calendar
2100
- * @permissionScopeId SCOPE.DC-BOOKINGS.SESSIONS-RESOURCES
2101
- * @permissionScope Read Calendar - Including PI
2102
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2103
- * @permissionScope Manage Calendars
2104
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2105
- * @permissionScope Manage Bookings
2106
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2107
- * @permissionScope Read Bookings - Including Participants
2108
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2109
- * @permissionScope Read Bookings - all read permissions
2110
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2111
- * @permissionScope Manage Bookings - all permissions
2112
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2113
- * @permissionScope Read bookings calendar - including participants
2114
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2115
- * @applicableIdentity APP
2116
- * @applicableIdentity VISITOR
2117
- * @fqn wix.calendar.participantevents.v3.ParticipantEventsService.ListEventsByMemberId
2118
- */
2119
- export declare function listEventsByMemberId(memberId: string, options?: ListEventsByMemberIdOptions): Promise<NonNullablePaths<ListEventsByMemberIdResponse, {
2120
- [P in EventNonNullablePaths]: `events.${number}.${P}`;
2121
- }[EventNonNullablePaths]>>;
2122
- export interface ListEventsByMemberIdOptions {
2123
- /**
2124
- * Local start date and time from which events are returned in
2125
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2126
- * `2024-01-30T13:30:00`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
2127
- *
2128
- * Events that start before the `fromLocalDate` but end after it are included in
2129
- * the results. Must be earlier than `toLocalDate`.
2130
- * @format LOCAL_DATE_TIME
2131
- */
2132
- fromLocalDate?: string | null;
2133
- /**
2134
- * Local end date and time up to which events are returned in
2135
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2136
- * `2024-01-30T13:30:00`. Can't be more than a full year after
2137
- * `fromLocalDate`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
2138
- *
2139
- * Events that start before `toLocalDate` but end after it are included in the
2140
- * results. Must be later than `fromLocalDate`.
2141
- * @format LOCAL_DATE_TIME
2142
- */
2143
- toLocalDate?: string | null;
2144
- /**
2145
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2146
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
2147
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
2148
- *
2149
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2150
- */
2151
- timeZone?: string | null;
2152
- /**
2153
- * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
2154
- * to filter events by.
2155
- * @format GUID
2156
- */
2157
- appId?: string | null;
2158
- /** Cursor to retrieve the next page of the results. */
2159
- cursorPaging?: CommonCursorPaging;
2160
- /**
2161
- * IDs of the events to retrieve.
2162
- * If you provide a list of IDs, all other filters are ignored.
2163
- *
2164
- * Max: 100 `eventId`s
2165
- * @maxSize 100
2166
- * @minLength 36
2167
- * @maxLength 250
2168
- */
2169
- eventIds?: string[];
2170
- }
2171
- /**
2172
- * Retrieves an event.
2173
- * @param eventId - ID of the event to retrieve.
2174
- *
2175
- * Min: 36 characters
2176
- * Max: 250 characters
2177
- * @public
2178
- * @requiredField eventId
2179
- * @permissionId CALENDAR.EVENT_READ
2180
- * @permissionId CALENDAR.EVENT_READ_PI
2181
- * @permissionScope Read Bookings - Public Data
2182
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-PUBLIC
2183
- * @permissionScope Read Calendar - Including PI
2184
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2185
- * @permissionScope Manage Calendars
2186
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2187
- * @permissionScope Manage Bookings
2188
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2189
- * @permissionScope Read Bookings - Including Participants
2190
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2191
- * @permissionScope Read Bookings - all read permissions
2192
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2193
- * @permissionScope Read Bookings Calendar Availability
2194
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR
2195
- * @permissionScope Read Calendar
2196
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PUBLIC
2197
- * @permissionScope Manage Bookings - all permissions
2198
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2199
- * @permissionScope Read bookings calendar - including participants
2200
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2201
- * @permissionScope Read Bookings Calendar
2202
- * @permissionScopeId SCOPE.DC-BOOKINGS.SESSIONS-RESOURCES
2203
- * @permissionScope Read Calendar - Including PI
2204
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2205
- * @permissionScope Manage Calendars
2206
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2207
- * @permissionScope Manage Bookings
2208
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2209
- * @permissionScope Read Bookings - Including Participants
2210
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2211
- * @permissionScope Read Bookings - all read permissions
2212
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2213
- * @permissionScope Manage Bookings - all permissions
2214
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2215
- * @permissionScope Read bookings calendar - including participants
2216
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2217
- * @applicableIdentity APP
2218
- * @applicableIdentity VISITOR
2219
- * @returns Retrieved event.
2220
- * @fqn wix.calendar.events.v3.EventsService.GetEvent
2221
- */
2222
- export declare function getEvent(eventId: string, options?: GetEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
2223
- export interface GetEventOptions {
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
- * Information about which fields containing personal data to return. Refer to the
2234
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2235
- * for more information.
2236
- *
2237
- * Supported values:
2238
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2239
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2240
- *
2241
- * Max: 1 field
2242
- * Default: No personal data is returned.
2243
- * @maxSize 1
2244
- */
2245
- fields?: RequestedFieldsWithLiterals[];
2246
- }
2247
- /**
2248
- * Retrieves a list of events by their IDs.
2249
- * @param eventIds - IDs of the events to retrieve.
2250
- *
2251
- * Min: 1 event ID
2252
- * Min: 100 event IDs
2253
- * @public
2254
- * @requiredField eventIds
2255
- * @permissionId CALENDAR.EVENT_READ
2256
- * @permissionId CALENDAR.EVENT_READ_PI
2257
- * @permissionScope Read Bookings - Public Data
2258
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-PUBLIC
2259
- * @permissionScope Read Calendar - Including PI
2260
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2261
- * @permissionScope Manage Calendars
2262
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2263
- * @permissionScope Manage Bookings
2264
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2265
- * @permissionScope Read Bookings - Including Participants
2266
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2267
- * @permissionScope Read Bookings - all read permissions
2268
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2269
- * @permissionScope Read Bookings Calendar Availability
2270
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR
2271
- * @permissionScope Read Calendar
2272
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PUBLIC
2273
- * @permissionScope Manage Bookings - all permissions
2274
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2275
- * @permissionScope Read bookings calendar - including participants
2276
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2277
- * @permissionScope Read Bookings Calendar
2278
- * @permissionScopeId SCOPE.DC-BOOKINGS.SESSIONS-RESOURCES
2279
- * @permissionScope Read Calendar - Including PI
2280
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2281
- * @permissionScope Manage Calendars
2282
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2283
- * @permissionScope Manage Bookings
2284
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2285
- * @permissionScope Read Bookings - Including Participants
2286
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2287
- * @permissionScope Read Bookings - all read permissions
2288
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2289
- * @permissionScope Manage Bookings - all permissions
2290
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2291
- * @permissionScope Read bookings calendar - including participants
2292
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2293
- * @applicableIdentity APP
2294
- * @applicableIdentity VISITOR
2295
- * @fqn wix.calendar.events.v3.EventsService.ListEvents
2296
- */
2297
- export declare function listEvents(eventIds: string[], options?: ListEventsOptions): Promise<NonNullablePaths<ListEventsResponse, {
2298
- [P in EventNonNullablePaths]: `events.${number}.${P}`;
2299
- }[EventNonNullablePaths]>>;
2300
- export interface ListEventsOptions {
2301
- /**
2302
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2303
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2304
- * `America/New_York` or `UTC`.
2305
- *
2306
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2307
- */
2308
- timeZone?: string | null;
2309
- /**
2310
- * Information about which fields containing personal data to return. Refer to the
2311
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2312
- * for more information.
2313
- *
2314
- * Supported values:
2315
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2316
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2317
- *
2318
- * Max: 1 field
2319
- * Default: No personal data is returned.
2320
- * @maxSize 1
2321
- */
2322
- fields?: RequestedFieldsWithLiterals[];
2323
- }
2324
- /**
2325
- * Creates a query to retrieve a list of events.
2326
- *
2327
- * The `queryEvents()` function builds a query to retrieve a list of events and returns an `EventsQueryBuilder` object.
2328
- *
2329
- * The returned object contains the query definition, which is typically used to run the query using the [find()](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/events-query-builder/find) function.
2330
- *
2331
- * You can refine the query by chaining `EventsQueryBuilder` functions onto the query. `EventsQueryBuilder` functions enable you to sort, filter, and control the results that `queryEvents()` returns.
2332
- *
2333
- * `queryEvents()` runs with the following `EventsQueryBuilder` default that you can override:
2334
- *
2335
- * + `limit` is `50`.
2336
- * + Sorted by `event.start` in ascending order.
2337
- *
2338
- * The functions that are chained to `queryEvents()` are applied in the order they are called.
2339
- *
2340
- * The following `EventsQueryBuilder` functions are supported for the `queryEvents()` function. For a full description of the events object, see the object returned for the [items](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/events-query-result/items) property in `EventsQueryResult`.
2341
- *
2342
- * @public
2343
- * @permissionScope Read Bookings - Public Data
2344
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-PUBLIC
2345
- * @permissionScope Read Calendar - Including PI
2346
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2347
- * @permissionScope Manage Calendars
2348
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2349
- * @permissionScope Manage Bookings
2350
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2351
- * @permissionScope Read Bookings - Including Participants
2352
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2353
- * @permissionScope Read Bookings - all read permissions
2354
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2355
- * @permissionScope Read Bookings Calendar Availability
2356
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR
2357
- * @permissionScope Read Calendar
2358
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PUBLIC
2359
- * @permissionScope Manage Bookings - all permissions
2360
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2361
- * @permissionScope Read bookings calendar - including participants
2362
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2363
- * @permissionScope Read Bookings Calendar
2364
- * @permissionScopeId SCOPE.DC-BOOKINGS.SESSIONS-RESOURCES
2365
- * @permissionScope Read Calendar - Including PI
2366
- * @permissionScopeId SCOPE.DC-CALENDAR.READ-PI
2367
- * @permissionScope Manage Calendars
2368
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2369
- * @permissionScope Manage Bookings
2370
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2371
- * @permissionScope Read Bookings - Including Participants
2372
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-BOOKINGS-SENSITIVE
2373
- * @permissionScope Read Bookings - all read permissions
2374
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.READ-BOOKINGS
2375
- * @permissionScope Manage Bookings - all permissions
2376
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2377
- * @permissionScope Read bookings calendar - including participants
2378
- * @permissionScopeId SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS
2379
- * @permissionId CALENDAR.EVENT_READ
2380
- * @permissionId CALENDAR.EVENT_READ_PI
2381
- * @applicableIdentity APP
2382
- * @applicableIdentity VISITOR
2383
- * @fqn wix.calendar.events.v3.EventsService.QueryEvents
2384
- */
2385
- export declare function queryEvents(options?: QueryEventsOptions): EventsQueryBuilder;
2386
- export interface QueryEventsOptions {
2387
- /**
2388
- * Local start date and time from which events are returned in
2389
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2390
- * `2024-01-30T13:30:00`.
2391
- *
2392
- * Events that start before the `fromLocalDate` but end after it are included in
2393
- * the results. Must be earlier than `toLocalDate` unless the sort order is
2394
- * descending.
2395
- * @format LOCAL_DATE_TIME
2396
- */
2397
- fromLocalDate?: string | null | undefined;
2398
- /**
2399
- * Local end date and time up to which events are returned in
2400
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
2401
- * `2024-01-30T13:30:00`.
2402
- *
2403
- * Events that start before `toLocalDate` but end after it are included in the
2404
- * results. Must be later than `fromLocalDate` unless the sort order is
2405
- * descending.
2406
- * @format LOCAL_DATE_TIME
2407
- */
2408
- toLocalDate?: string | null | undefined;
2409
- /**
2410
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2411
- * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
2412
- * `adjustedEnd`. For example, `America/New_York` or `UTC`.
2413
- *
2414
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
2415
- */
2416
- timeZone?: string | null | undefined;
2417
- /**
2418
- * Filters events based on their `recurrenceType`.
2419
- *
2420
- * Max: 5 recurrence types can be specified.
2421
- * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
2422
- * @maxSize 5
2423
- */
2424
- recurrenceType?: RecurrenceTypeWithLiterals[] | undefined;
2425
- /**
2426
- * Information about which fields containing personal data to return. Refer to the
2427
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions)
2428
- * for more information.
2429
- *
2430
- * Supported values:
2431
- * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
2432
- * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
2433
- *
2434
- * Max: 1 field
2435
- * Default: No personal data is returned.
2436
- * @maxSize 1
2437
- */
2438
- fields?: RequestedFieldsWithLiterals[] | undefined;
2439
- }
2440
- interface QueryCursorResult {
2441
- cursors: CommonCursors;
2442
- hasNext: () => boolean;
2443
- hasPrev: () => boolean;
2444
- length: number;
2445
- pageSize: number;
2446
- }
2447
- export interface EventsQueryResult extends QueryCursorResult {
2448
- items: Event[];
2449
- query: EventsQueryBuilder;
2450
- next: () => Promise<EventsQueryResult>;
2451
- prev: () => Promise<EventsQueryResult>;
2452
- }
2453
- export interface EventsQueryBuilder {
2454
- /** @param propertyName - Property whose value is compared with `value`.
2455
- * @param value - Value to compare against.
2456
- */
2457
- eq: (propertyName: 'scheduleId' | 'externalScheduleId' | 'type' | 'recurringEventId' | 'transparency' | 'location.id' | 'location.type' | 'totalCapacity' | 'remainingCapacity' | 'participants.total' | 'appId', value: any) => EventsQueryBuilder;
2458
- /** @param propertyName - Property whose value is compared with `value`.
2459
- * @param value - Value to compare against.
2460
- */
2461
- ne: (propertyName: 'totalCapacity' | 'remainingCapacity' | 'participants.total', value: any) => EventsQueryBuilder;
2462
- /** @param propertyName - Property whose value is compared with `value`.
2463
- * @param value - Value to compare against.
2464
- */
2465
- ge: (propertyName: 'totalCapacity' | 'remainingCapacity' | 'participants.total', value: any) => EventsQueryBuilder;
2466
- /** @param propertyName - Property whose value is compared with `value`.
2467
- * @param value - Value to compare against.
2468
- */
2469
- gt: (propertyName: 'totalCapacity' | 'remainingCapacity' | 'participants.total', value: any) => EventsQueryBuilder;
2470
- /** @param propertyName - Property whose value is compared with `value`.
2471
- * @param value - Value to compare against.
2472
- */
2473
- le: (propertyName: 'totalCapacity' | 'remainingCapacity' | 'participants.total', value: any) => EventsQueryBuilder;
2474
- /** @param propertyName - Property whose value is compared with `value`.
2475
- * @param value - Value to compare against.
2476
- */
2477
- lt: (propertyName: 'totalCapacity' | 'remainingCapacity' | 'participants.total', value: any) => EventsQueryBuilder;
2478
- /** @param propertyName - Property whose value is compared with `values`.
2479
- * @param values - List of values to compare against.
2480
- */
2481
- hasSome: (propertyName: string, value: any[]) => EventsQueryBuilder;
2482
- /** @param propertyName - Property whose value is compared with `values`.
2483
- * @param values - List of values to compare against.
2484
- */
2485
- hasAll: (propertyName: string, value: any[]) => EventsQueryBuilder;
2486
- in: (propertyName: 'scheduleId' | 'externalScheduleId' | 'type' | 'recurringEventId' | 'location.id' | 'location.type' | 'appId', value: any) => EventsQueryBuilder;
2487
- exists: (propertyName: 'location' | 'totalCapacity' | 'conferencingDetails', value: boolean) => EventsQueryBuilder;
2488
- /** @param limit - Number of items to return, which is also the `pageSize` of the results object. */
2489
- limit: (limit: number) => EventsQueryBuilder;
2490
- /** @param cursor - A pointer to specific record */
2491
- skipTo: (cursor: string) => EventsQueryBuilder;
2492
- find: () => Promise<EventsQueryResult>;
2493
- }
2494
- /**
2495
- * Creates an event.
2496
- *
2497
- *
2498
- * If you provide `recurrenceRule`, an event with `{"recurrenceType": "MASTER"}` is created. Then, you can't set `start.localDate` to a past date, though the time can be earlier on the same day. You can, however, create single-occurrence events for past dates.
2499
- *
2500
- * You can't create an event with `recurrenceType` set to `INSTANCE` or `EXCEPTION`. `INSTANCE` events are generated automatically based on the recurrence rule in the relevant `MASTER` event. `EXCEPTION` events are automatically created when you [update](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event) an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
2501
- * @param event - Event to create.
2502
- * @public
2503
- * @requiredField event
2504
- * @requiredField event.conferencingDetails.guestUrl
2505
- * @requiredField event.conferencingDetails.hostUrl
2506
- * @requiredField event.conferencingDetails.type
2507
- * @requiredField event.end
2508
- * @requiredField event.end.localDate
2509
- * @requiredField event.location.type
2510
- * @requiredField event.participants.list.name
2511
- * @requiredField event.recurrenceRule.days
2512
- * @requiredField event.recurrenceRule.frequency
2513
- * @requiredField event.recurrenceRule.until.localDate
2514
- * @requiredField event.resources._id
2515
- * @requiredField event.scheduleId
2516
- * @requiredField event.start
2517
- * @requiredField event.start.localDate
2518
- * @permissionId CALENDAR.EVENT_CREATE_OWN
2519
- * @permissionId CALENDAR.EVENT_CREATE
2520
- * @permissionScope Manage Calendars
2521
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2522
- * @permissionScope Manage Bookings
2523
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2524
- * @permissionScope Manage Bookings - all permissions
2525
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2526
- * @permissionScope Manage Calendars
2527
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2528
- * @permissionScope Manage Bookings
2529
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2530
- * @permissionScope Manage Bookings - all permissions
2531
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2532
- * @applicableIdentity APP
2533
- * @returns Created event.
2534
- * @fqn wix.calendar.events.v3.EventsService.CreateEvent
2535
- */
2536
- export declare function createEvent(event: NonNullablePaths<Event, `conferencingDetails.guestUrl` | `conferencingDetails.hostUrl` | `conferencingDetails.type` | `end` | `end.localDate` | `location.type` | `participants.list.${number}.name` | `recurrenceRule.days` | `recurrenceRule.frequency` | `recurrenceRule.until.localDate` | `resources.${number}._id` | `scheduleId` | `start` | `start.localDate`>, options?: CreateEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
2537
- export interface CreateEventOptions {
2538
- /**
2539
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2540
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2541
- * `America/New_York` or `UTC`.
2542
- *
2543
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2544
- */
2545
- timeZone?: string | null;
2546
- /**
2547
- * Idempotency key guaranteeing that you don't create the same event more
2548
- * than once.
2549
- * @format GUID
2550
- */
2551
- idempotencyKey?: string | null;
2552
- }
2553
- /**
2554
- * Creates multiple events in bulk.
2555
- *
2556
- *
2557
- * If you provide `recurrenceRule`, an event with `{"recurrenceType": "MASTER"}` is
2558
- * created. Then, you can't set `start.localDate` to a past date, though the time can be
2559
- * earlier on the same day. You can, however, create single-occurrence events for
2560
- * past dates.
2561
- *
2562
- * You can't create an event with `recurrenceType` set to `INSTANCE` or `EXCEPTION`.
2563
- * `INSTANCE` events are generated automatically based on the recurrence rule in the
2564
- * relevant `MASTER` event. `EXCEPTION` events are automatically created when you
2565
- * [update](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event)
2566
- * an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
2567
- * @param events - Events to create.
2568
- * @public
2569
- * @requiredField events
2570
- * @requiredField events.event
2571
- * @requiredField events.event.conferencingDetails.guestUrl
2572
- * @requiredField events.event.conferencingDetails.hostUrl
2573
- * @requiredField events.event.conferencingDetails.type
2574
- * @requiredField events.event.end
2575
- * @requiredField events.event.end.localDate
2576
- * @requiredField events.event.location.type
2577
- * @requiredField events.event.participants.list.name
2578
- * @requiredField events.event.recurrenceRule.days
2579
- * @requiredField events.event.recurrenceRule.frequency
2580
- * @requiredField events.event.recurrenceRule.until.localDate
2581
- * @requiredField events.event.resources._id
2582
- * @requiredField events.event.scheduleId
2583
- * @requiredField events.event.start
2584
- * @requiredField events.event.start.localDate
2585
- * @permissionId CALENDAR.EVENT_CREATE_OWN
2586
- * @permissionId CALENDAR.EVENT_CREATE
2587
- * @permissionScope Manage Calendars
2588
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2589
- * @permissionScope Manage Bookings
2590
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2591
- * @permissionScope Manage Bookings - all permissions
2592
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2593
- * @permissionScope Manage Calendars
2594
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2595
- * @permissionScope Manage Bookings
2596
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2597
- * @permissionScope Manage Bookings - all permissions
2598
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2599
- * @applicableIdentity APP
2600
- * @fqn wix.calendar.events.v3.EventsService.BulkCreateEvent
2601
- */
2602
- export declare function bulkCreateEvent(events: NonNullablePaths<MaskedEvent, `event` | `event.conferencingDetails.guestUrl` | `event.conferencingDetails.hostUrl` | `event.conferencingDetails.type` | `event.end` | `event.end.localDate` | `event.location.type` | `event.participants.list.${number}.name` | `event.recurrenceRule.days` | `event.recurrenceRule.frequency` | `event.recurrenceRule.until.localDate` | `event.resources.${number}._id` | `event.scheduleId` | `event.start` | `event.start.localDate`>[], options?: BulkCreateEventOptions): Promise<NonNullablePaths<BulkCreateEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
2603
- [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
2604
- }[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`>>;
2605
- export interface BulkCreateEventOptions {
2606
- /**
2607
- * Whether to return created events.
2608
- *
2609
- * Default: `false`.
2610
- */
2611
- returnEntity?: boolean | null;
2612
- /**
2613
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2614
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2615
- * `America/New_York` or `UTC`.
2616
- *
2617
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2618
- */
2619
- timeZone?: string | null;
2620
- }
2621
- /**
2622
- * Updates an event.
2623
- *
2624
- *
2625
- * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
2626
- * `recurrenceType` automatically changes to `EXCEPTION`.
2627
- *
2628
- * When updating an event with `{"recurrenceType": "MASTER"}`:
2629
- * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
2630
- * + For future `INSTANCE` events, all relevant fields are updated.
2631
- * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
2632
- * applied, while other fields remain unchanged.
2633
- * @param _id - Event ID.
2634
- * @public
2635
- * @requiredField _id
2636
- * @requiredField event
2637
- * @requiredField event.conferencingDetails.guestUrl
2638
- * @requiredField event.conferencingDetails.hostUrl
2639
- * @requiredField event.conferencingDetails.type
2640
- * @requiredField event.end.localDate
2641
- * @requiredField event.location.type
2642
- * @requiredField event.participants.list.name
2643
- * @requiredField event.recurrenceRule.days
2644
- * @requiredField event.recurrenceRule.frequency
2645
- * @requiredField event.recurrenceRule.until.localDate
2646
- * @requiredField event.resources._id
2647
- * @requiredField event.revision
2648
- * @requiredField event.start.localDate
2649
- * @permissionId CALENDAR.EVENT_UPDATE_OWN
2650
- * @permissionId CALENDAR.EVENT_UPDATE
2651
- * @permissionScope Manage Calendars
2652
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2653
- * @permissionScope Manage Bookings
2654
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2655
- * @permissionScope Manage Bookings - all permissions
2656
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2657
- * @permissionScope Manage Calendars
2658
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2659
- * @permissionScope Manage Bookings
2660
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2661
- * @permissionScope Manage Bookings - all permissions
2662
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2663
- * @applicableIdentity APP
2664
- * @returns Updated event.
2665
- * @fqn wix.calendar.events.v3.EventsService.UpdateEvent
2666
- */
2667
- export declare function updateEvent(_id: string, event: NonNullablePaths<UpdateEvent, `conferencingDetails.guestUrl` | `conferencingDetails.hostUrl` | `conferencingDetails.type` | `end.localDate` | `location.type` | `participants.list.${number}.name` | `recurrenceRule.days` | `recurrenceRule.frequency` | `recurrenceRule.until.localDate` | `resources.${number}._id` | `revision` | `start.localDate`>, options?: UpdateEventOptions): Promise<NonNullablePaths<Event, EventNonNullablePaths>>;
2668
- export interface UpdateEvent {
2669
- /**
2670
- * Event ID.
2671
- * @minLength 36
2672
- * @maxLength 250
2673
- * @readonly
2674
- */
2675
- _id?: string | null;
2676
- /**
2677
- * ID of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
2678
- * the event belongs to.
2679
- * After creating an event, you can't assign it to a different schedule.
2680
- * @format GUID
2681
- * @immutable
2682
- */
2683
- scheduleId?: string | null;
2684
- /**
2685
- * ID of the external schedule the event belongs to.
2686
- *
2687
- * 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).
2688
- * @format GUID
2689
- * @readonly
2690
- */
2691
- externalScheduleId?: string | null;
2692
- /**
2693
- * Schedule name.
2694
- * @readonly
2695
- */
2696
- scheduleName?: string | null;
2697
- /**
2698
- * Event type. You can set the event type but you can't update it.
2699
- *
2700
- * Supported values:
2701
- * + `DEFAULT`: A standard event that's not further specified.
2702
- * + `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).
2703
- *
2704
- * Additional supported values, if Wix Bookings is installed:
2705
- * + `APPOINTMENT`: Bookings appointment event.
2706
- * + `CLASS`: Bookings class event.
2707
- * + `COURSE`: Bookings course event.
2708
- * @immutable
2709
- */
2710
- type?: string | null;
2711
- /**
2712
- * Event status.
2713
- *
2714
- * Supported values:
2715
- * + `CONFIRMED`: Event is scheduled to happen or has happened.
2716
- * + `CANCELLED`: Event has been canceled.
2717
- *
2718
- * Default: `CONFIRMED`
2719
- * @readonly
2720
- */
2721
- status?: StatusWithLiterals;
2722
- /**
2723
- * Event title.
2724
- *
2725
- * Min: 1 character
2726
- * Max: 200 characters
2727
- * @minLength 1
2728
- * @maxLength 200
2729
- */
2730
- title?: string | null;
2731
- /** Information about when the event starts. */
2732
- start?: ZonedDate;
2733
- /**
2734
- * Information about when the event ends.
2735
- *
2736
- * Maximum allowed date: Year 2100, or up to 100 years from the event's start date (whichever comes first).
2737
- */
2738
- end?: ZonedDate;
2739
- /**
2740
- * Information about when the event starts adjusted to the `timeZone` of the
2741
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
2742
- * or a different `timeZone` you provide in the call's request.
2743
- * @readonly
2744
- */
2745
- adjustedStart?: ZonedDate;
2746
- /**
2747
- * Information about when the event ends adjusted to the `timeZone` of the
2748
- * business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties)
2749
- * or a different `timeZone` you provide in the call's request.
2750
- * @readonly
2751
- */
2752
- adjustedEnd?: ZonedDate;
2753
- /**
2754
- * Time zone the event is associated with in
2755
- * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
2756
- * Only regional time zones and UTC are supported.
2757
- * For example, `America/New_York` or `UTC`.
2758
- *
2759
- * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
2760
- */
2761
- timeZone?: string | null;
2762
- /**
2763
- * Information about whether the event is a single occurrence or part of a
2764
- * recurring series.
2765
- *
2766
- * Supported values:
2767
- * + `NONE`: The event occurs only once and doesn't repeat.
2768
- * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
2769
- * + `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`.
2770
- * + `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.
2771
- *
2772
- * Default: `NONE`
2773
- * @readonly
2774
- */
2775
- recurrenceType?: RecurrenceTypeWithLiterals;
2776
- /**
2777
- * Recurrence pattern for a series of events. This field is required when
2778
- * creating a `MASTER` event and isn't available for non-recurring events.
2779
- * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
2780
- *
2781
- * For example, an event that repeats every second Monday until January 7, 2026,
2782
- * at 8:00 AM has the following `recurrenceRule`:
2783
- * - `frequency = WEEKLY`
2784
- * - `interval = 2`
2785
- * - `days = [MONDAY]`
2786
- * - `until = 20260107T08:00:00Z`
2787
- */
2788
- recurrenceRule?: RecurrenceRule;
2789
- /**
2790
- * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
2791
- * and `EXCEPTION` events.
2792
- * @minLength 64
2793
- * @maxLength 64
2794
- * @readonly
2795
- */
2796
- recurringEventId?: string | null;
2797
- /**
2798
- * Specifies whether the event blocks time in the schedule it belongs to.
2799
- *
2800
- * Supported values:
2801
- * + `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.
2802
- * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
2803
- *
2804
- * Default: `OPAQUE`
2805
- */
2806
- transparency?: TransparencyWithLiterals;
2807
- /**
2808
- * Event location.
2809
- *
2810
- * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to
2811
- */
2812
- location?: Location;
2813
- /**
2814
- * List of [Wix Bookings resources](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction)
2815
- * affected by the event. This could include, for example, the
2816
- * [Wix Bookings staff member](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction)
2817
- * providing the service or the room where the appointment takes place.
2818
- *
2819
- * Max: 100 resources
2820
- * @maxSize 100
2821
- */
2822
- resources?: Resource[];
2823
- /**
2824
- * Maximum number of participants who can participate in the event.
2825
- *
2826
- * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
2827
- */
2828
- totalCapacity?: number | null;
2829
- /**
2830
- * Number of participants who can still be added to the event.
2831
- * @readonly
2832
- */
2833
- remainingCapacity?: number | null;
2834
- /**
2835
- * Information about the event's participants.
2836
- * 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).
2837
- * @readonly
2838
- */
2839
- participants?: Participants;
2840
- /**
2841
- * Information about the event's online conferencing.
2842
- * 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).
2843
- *
2844
- * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) the event belongs to.
2845
- */
2846
- conferencingDetails?: ConferencingDetails;
2847
- /**
2848
- * Additional notes about the event.
2849
- * 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).
2850
- *
2851
- * Min: 1 character
2852
- * Max: 5000 characters
2853
- * @minLength 1
2854
- * @maxLength 5000
2855
- */
2856
- notes?: string | null;
2857
- /**
2858
- * List of fields whose values are inherited.
2859
- * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction).
2860
- * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related `MASTER` event.
2861
- * @readonly
2862
- */
2863
- inheritedFields?: FieldWithLiterals[];
2864
- /**
2865
- * ID of the app that owns the event. Identical to `appId` of the
2866
- * [schedule](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction)
2867
- * to which the event belongs.
2868
- * @format GUID
2869
- * @readonly
2870
- */
2871
- appId?: string | null;
2872
- /**
2873
- * List of permissions associated with the event. Refer to the
2874
- * [permissions article](https://dev.wix.com/docs/sdk/backend-modules/calendar/permissions#roles)
2875
- * for more information.
2876
- * @readonly
2877
- */
2878
- permissions?: Permission[];
2879
- /** Extensions enabling applications or users to save custom data related to the event. */
2880
- extendedFields?: ExtendedFields;
2881
- /**
2882
- * Revision number, which increments each time the event is updated.
2883
- * To prevent conflicting changes, the current revision must be passed when updating the event.
2884
- * Ignored when creating an event.
2885
- * @readonly
2886
- */
2887
- revision?: string | null;
2888
- /**
2889
- * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2890
- * @readonly
2891
- */
2892
- _createdDate?: Date | null;
2893
- /**
2894
- * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
2895
- * @readonly
2896
- */
2897
- _updatedDate?: Date | null;
2898
- }
2899
- export interface UpdateEventOptions {
2900
- /**
2901
- * Information about whether participants of the updated event are notified and
2902
- * the message they receive.
2903
- */
2904
- participantNotification?: ParticipantNotification;
2905
- /**
2906
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2907
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2908
- * `America/New_York` or `UTC`.
2909
- *
2910
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2911
- */
2912
- timeZone?: string | null;
2913
- }
2914
- /**
2915
- * Updates multiple events in bulk.
2916
- *
2917
- *
2918
- * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
2919
- * `recurrenceType` automatically changes to `EXCEPTION`.
2920
- *
2921
- * When updating an event with `{"recurrenceType": "MASTER"}`:
2922
- * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
2923
- * + For future `INSTANCE` events, all relevant fields are updated.
2924
- * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
2925
- * applied, while other fields remain unchanged.
2926
- * @param events - Events to update.
2927
- *
2928
- * Min: 1 event
2929
- * Max: 50 events
2930
- * @public
2931
- * @requiredField events
2932
- * @requiredField events.event
2933
- * @requiredField events.event._id
2934
- * @requiredField events.event.conferencingDetails.guestUrl
2935
- * @requiredField events.event.conferencingDetails.hostUrl
2936
- * @requiredField events.event.conferencingDetails.type
2937
- * @requiredField events.event.end.localDate
2938
- * @requiredField events.event.location.type
2939
- * @requiredField events.event.participants.list.name
2940
- * @requiredField events.event.recurrenceRule.days
2941
- * @requiredField events.event.recurrenceRule.frequency
2942
- * @requiredField events.event.recurrenceRule.until.localDate
2943
- * @requiredField events.event.resources._id
2944
- * @requiredField events.event.revision
2945
- * @requiredField events.event.start.localDate
2946
- * @permissionId CALENDAR.EVENT_UPDATE_OWN
2947
- * @permissionId CALENDAR.EVENT_UPDATE
2948
- * @permissionScope Manage Calendars
2949
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2950
- * @permissionScope Manage Bookings
2951
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2952
- * @permissionScope Manage Bookings - all permissions
2953
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2954
- * @permissionScope Manage Calendars
2955
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
2956
- * @permissionScope Manage Bookings
2957
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
2958
- * @permissionScope Manage Bookings - all permissions
2959
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
2960
- * @applicableIdentity APP
2961
- * @fqn wix.calendar.events.v3.EventsService.BulkUpdateEvent
2962
- */
2963
- export declare function bulkUpdateEvent(events: NonNullablePaths<BulkUpdateEventRequestMaskedEvent, `event` | `event._id` | `event.conferencingDetails.guestUrl` | `event.conferencingDetails.hostUrl` | `event.conferencingDetails.type` | `event.end.localDate` | `event.location.type` | `event.participants.list.${number}.name` | `event.recurrenceRule.days` | `event.recurrenceRule.frequency` | `event.recurrenceRule.until.localDate` | `event.resources.${number}._id` | `event.revision` | `event.start.localDate`>[], options?: BulkUpdateEventOptions): Promise<NonNullablePaths<BulkUpdateEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
2964
- [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
2965
- }[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`>>;
2966
- export interface BulkUpdateEventOptions {
2967
- /**
2968
- * Whether to return the updated events.
2969
- *
2970
- * Default: `false`
2971
- */
2972
- returnEntity?: boolean | null;
2973
- /**
2974
- * Information about whether participants of the updated event are notified and
2975
- * the message they receive.
2976
- */
2977
- participantNotification?: ParticipantNotification;
2978
- /**
2979
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
2980
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
2981
- * `America/New_York` or `UTC`.
2982
- *
2983
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
2984
- */
2985
- timeZone?: string | null;
2986
- }
2987
- /**
2988
- * Restores the event's default values from the relevant schedule or `MASTER`
2989
- * event.
2990
- *
2991
- *
2992
- * You must provide `fields` to specify which `inheritedFields` are restored.
2993
- *
2994
- * For example, if you've created an event that takes place in a non-default
2995
- * location with a custom title and capacity, but you want to reset only title
2996
- * and capacity to default values without affecting the location, provide the
2997
- * event ID and set `fields` to `["TITLE", "CAPACITY"]`.
2998
- *
2999
- * Refer to the [default values article](https://dev.wix.com/docs/sdk/backend-modules/calendar/default-values)
3000
- * for more information.
3001
- * @param eventId - ID of the event for which to restore default values.
3002
- * @param fields - Fields for which to restore default values.
3003
- *
3004
- * `TIME` restores default values for `start` and `end`.
3005
- *
3006
- * Min: 1 field
3007
- * @public
3008
- * @requiredField eventId
3009
- * @requiredField fields
3010
- * @permissionId CALENDAR.EVENT_UPDATE_OWN
3011
- * @permissionId CALENDAR.EVENT_UPDATE
3012
- * @permissionScope Manage Calendars
3013
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3014
- * @permissionScope Manage Bookings
3015
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3016
- * @permissionScope Manage Bookings - all permissions
3017
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3018
- * @permissionScope Manage Calendars
3019
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3020
- * @permissionScope Manage Bookings
3021
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3022
- * @permissionScope Manage Bookings - all permissions
3023
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3024
- * @applicableIdentity APP
3025
- * @fqn wix.calendar.events.v3.EventsService.RestoreEventDefaults
3026
- */
3027
- export declare function restoreEventDefaults(eventId: string, fields: FieldWithLiterals[], options?: RestoreEventDefaultsOptions): Promise<NonNullablePaths<RestoreEventDefaultsResponse, {
3028
- [P in EventNonNullablePaths]: `event.${P}`;
3029
- }[EventNonNullablePaths]>>;
3030
- export interface RestoreEventDefaultsOptions {
3031
- /**
3032
- * Information about whether participants of the updated event are notified and
3033
- * the message they receive.
3034
- */
3035
- participantNotification?: ParticipantNotification;
3036
- /**
3037
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
3038
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
3039
- * `America/New_York` or `UTC`.
3040
- *
3041
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3042
- */
3043
- timeZone?: string | null;
3044
- }
3045
- /**
3046
- * Splits a recurring `MASTER` event into 2 separate `MASTER` events.
3047
- *
3048
- *
3049
- * You must provide a `splitLocalDate` that's in the future and after the `start`
3050
- * date of the next `INSTANCE` or `EXCEPTION` event in the series. Additionally,
3051
- * there must be another `INSTANCE` or `EXCEPTION` event following this next event,
3052
- * as the changes wouldn't affect any event without a subsequent occurrence.
3053
- *
3054
- * If you want to modify a `MASTER` event with the changes already applying to
3055
- * the very next event, use
3056
- * [updateEvent()](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/update-event)
3057
- * instead, as this preserves past events and only modifies future events.
3058
- *
3059
- * The main consequences are:
3060
- * - **The original `MASTER` event is shortened**. Its `recurrenceRule.until.localDate`
3061
- * is updated to `end.localDate` of the latest `INSTANCE` or `EXCEPTION`
3062
- * event starting before `splitLocalDate`. If an `INSTANCE` or `EXCEPTION` event
3063
- * starts before but ends after `splitLocalDate`, `until.localDate` is set
3064
- * to value that's later than `splitLocalDate`.
3065
- * - **A new `MASTER` event is created**, starting from the first event that
3066
- * begins after `splitLocalDate`.
3067
- * - **Existing `INSTANCE` and `EXCEPTION` events that occur after the split are updated**.
3068
- * Their `recurringEventId` is set to the ID of the newly created `MASTER` event.
3069
- * @param recurringEventId - ID of the `MASTER` event to split.
3070
- * @param splitLocalDate - Local date and time at which the `MASTER` event is split in
3071
- * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
3072
- * `2025-03-11T09:00:00`.
3073
- * Must be a future date that's after the `start` date of the next `INSTANCE` or
3074
- * `EXCEPTION` event in the series. Additionally, there must be another
3075
- * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
3076
- * wouldn't affect any event without a subsequent occurrence.
3077
- * @public
3078
- * @requiredField recurringEventId
3079
- * @requiredField splitLocalDate
3080
- * @permissionId CALENDAR.EVENT_UPDATE_OWN
3081
- * @permissionId CALENDAR.EVENT_UPDATE
3082
- * @permissionScope Manage Calendars
3083
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3084
- * @permissionScope Manage Bookings
3085
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3086
- * @permissionScope Manage Bookings - all permissions
3087
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3088
- * @permissionScope Manage Calendars
3089
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3090
- * @permissionScope Manage Bookings
3091
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3092
- * @permissionScope Manage Bookings - all permissions
3093
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3094
- * @applicableIdentity APP
3095
- * @fqn wix.calendar.events.v3.EventsService.SplitRecurringEvent
3096
- */
3097
- export declare function splitRecurringEvent(recurringEventId: string, splitLocalDate: string, options?: SplitRecurringEventOptions): Promise<NonNullablePaths<SplitRecurringEventResponse, {
3098
- [P in EventNonNullablePaths]: `updatedRecurringEventEndingBeforeSplit.${P}`;
3099
- }[EventNonNullablePaths] | {
3100
- [P in EventNonNullablePaths]: `newRecurringEventStartingFromSplit.${P}`;
3101
- }[EventNonNullablePaths]>>;
3102
- export interface SplitRecurringEventOptions {
3103
- /**
3104
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
3105
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
3106
- * `America/New_York` or `UTC`.
3107
- *
3108
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3109
- */
3110
- timeZone?: string | null;
3111
- }
3112
- /**
3113
- * Cancels an event.
3114
- * @param eventId - ID of the event to cancel.
3115
- * @public
3116
- * @requiredField eventId
3117
- * @permissionId CALENDAR.EVENT_CANCEL_OWN
3118
- * @permissionId CALENDAR.EVENT_CANCEL
3119
- * @permissionScope Manage Calendars
3120
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3121
- * @permissionScope Manage Bookings
3122
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3123
- * @permissionScope Manage Bookings - all permissions
3124
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3125
- * @permissionScope Manage Calendars
3126
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3127
- * @permissionScope Manage Bookings
3128
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3129
- * @permissionScope Manage Bookings - all permissions
3130
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3131
- * @applicableIdentity APP
3132
- * @fqn wix.calendar.events.v3.EventsService.CancelEvent
3133
- */
3134
- export declare function cancelEvent(eventId: string, options?: CancelEventOptions): Promise<NonNullablePaths<CancelEventResponse, {
3135
- [P in EventNonNullablePaths]: `event.${P}`;
3136
- }[EventNonNullablePaths]>>;
3137
- export interface CancelEventOptions {
3138
- /**
3139
- * Information about whether participants of the canceled event are notified and
3140
- * the message they receive.
3141
- */
3142
- participantNotification?: ParticipantNotification;
3143
- /**
3144
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
3145
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
3146
- * `America/New_York` or `UTC`.
3147
- *
3148
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3149
- */
3150
- timeZone?: string | null;
3151
- }
3152
- /**
3153
- * Cancels multiple events in bulk.
3154
- * @param eventIds - IDs of the events to cancel.
3155
- * @public
3156
- * @requiredField eventIds
3157
- * @permissionId CALENDAR.EVENT_CANCEL_OWN
3158
- * @permissionId CALENDAR.EVENT_CANCEL
3159
- * @permissionScope Manage Calendars
3160
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3161
- * @permissionScope Manage Bookings
3162
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3163
- * @permissionScope Manage Bookings - all permissions
3164
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3165
- * @permissionScope Manage Calendars
3166
- * @permissionScopeId SCOPE.DC-CALENDAR.MANAGE
3167
- * @permissionScope Manage Bookings
3168
- * @permissionScopeId SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS
3169
- * @permissionScope Manage Bookings - all permissions
3170
- * @permissionScopeId SCOPE.DC-BOOKINGS-MEGA.MANAGE-BOOKINGS
3171
- * @applicableIdentity APP
3172
- * @fqn wix.calendar.events.v3.EventsService.BulkCancelEvent
3173
- */
3174
- export declare function bulkCancelEvent(eventIds: string[], options?: BulkCancelEventOptions): Promise<NonNullablePaths<BulkCancelEventResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
3175
- [P in EventNonNullablePaths]: `results.${number}.item.${P}`;
3176
- }[EventNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures`>>;
3177
- export interface BulkCancelEventOptions {
3178
- /**
3179
- * Whether to return the canceled events.
3180
- *
3181
- * Default: `false`
3182
- */
3183
- returnEntity?: boolean | null;
3184
- /**
3185
- * Information about whether participants of the canceled events are notified and
3186
- * the message they receive.
3187
- */
3188
- participantNotification?: ParticipantNotification;
3189
- /**
3190
- * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
3191
- * for calculating `adjustedStart` and `adjustedEnd`. For example,
3192
- * `America/New_York` or `UTC`.
3193
- *
3194
- * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/sdk/backend-modules/business-tools/site-properties/get-site-properties).
3195
- */
3196
- timeZone?: string | null;
3197
- }
3198
- export {};