@wix/auto_sdk_calendar_events 1.0.0
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.
- package/build/cjs/index.d.ts +1 -0
- package/build/cjs/index.js +18 -0
- package/build/cjs/index.js.map +1 -0
- package/build/cjs/index.typings.d.ts +1 -0
- package/build/cjs/index.typings.js +18 -0
- package/build/cjs/index.typings.js.map +1 -0
- package/build/cjs/meta.d.ts +1 -0
- package/build/cjs/meta.js +18 -0
- package/build/cjs/meta.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.context.d.ts +51 -0
- package/build/cjs/src/calendar-v3-event-events.context.js +71 -0
- package/build/cjs/src/calendar-v3-event-events.context.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.http.d.ts +144 -0
- package/build/cjs/src/calendar-v3-event-events.http.js +777 -0
- package/build/cjs/src/calendar-v3-event-events.http.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.meta.d.ts +39 -0
- package/build/cjs/src/calendar-v3-event-events.meta.js +275 -0
- package/build/cjs/src/calendar-v3-event-events.meta.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.public.d.ts +242 -0
- package/build/cjs/src/calendar-v3-event-events.public.js +196 -0
- package/build/cjs/src/calendar-v3-event-events.public.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.types.d.ts +1750 -0
- package/build/cjs/src/calendar-v3-event-events.types.js +157 -0
- package/build/cjs/src/calendar-v3-event-events.types.js.map +1 -0
- package/build/cjs/src/calendar-v3-event-events.universal.d.ts +3063 -0
- package/build/cjs/src/calendar-v3-event-events.universal.js +1182 -0
- package/build/cjs/src/calendar-v3-event-events.universal.js.map +1 -0
- package/build/es/index.d.ts +1 -0
- package/build/es/index.js +2 -0
- package/build/es/index.js.map +1 -0
- package/build/es/index.typings.d.ts +1 -0
- package/build/es/index.typings.js +2 -0
- package/build/es/index.typings.js.map +1 -0
- package/build/es/meta.d.ts +1 -0
- package/build/es/meta.js +2 -0
- package/build/es/meta.js.map +1 -0
- package/build/es/package.json +3 -0
- package/build/es/src/calendar-v3-event-events.context.d.ts +51 -0
- package/build/es/src/calendar-v3-event-events.context.js +51 -0
- package/build/es/src/calendar-v3-event-events.context.js.map +1 -0
- package/build/es/src/calendar-v3-event-events.http.d.ts +144 -0
- package/build/es/src/calendar-v3-event-events.http.js +761 -0
- package/build/es/src/calendar-v3-event-events.http.js.map +1 -0
- package/build/es/src/calendar-v3-event-events.meta.d.ts +39 -0
- package/build/es/src/calendar-v3-event-events.meta.js +236 -0
- package/build/es/src/calendar-v3-event-events.meta.js.map +1 -0
- package/build/es/src/calendar-v3-event-events.public.d.ts +242 -0
- package/build/es/src/calendar-v3-event-events.public.js +163 -0
- package/build/es/src/calendar-v3-event-events.public.js.map +1 -0
- package/build/es/src/calendar-v3-event-events.types.d.ts +1750 -0
- package/build/es/src/calendar-v3-event-events.types.js +154 -0
- package/build/es/src/calendar-v3-event-events.types.js.map +1 -0
- package/build/es/src/calendar-v3-event-events.universal.d.ts +3063 -0
- package/build/es/src/calendar-v3-event-events.universal.js +1143 -0
- package/build/es/src/calendar-v3-event-events.universal.js.map +1 -0
- package/build/internal/cjs/index.d.ts +1 -0
- package/build/internal/cjs/index.js +18 -0
- package/build/internal/cjs/index.js.map +1 -0
- package/build/internal/cjs/index.typings.d.ts +1 -0
- package/build/internal/cjs/index.typings.js +18 -0
- package/build/internal/cjs/index.typings.js.map +1 -0
- package/build/internal/cjs/meta.d.ts +1 -0
- package/build/internal/cjs/meta.js +18 -0
- package/build/internal/cjs/meta.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.context.d.ts +51 -0
- package/build/internal/cjs/src/calendar-v3-event-events.context.js +71 -0
- package/build/internal/cjs/src/calendar-v3-event-events.context.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.http.d.ts +144 -0
- package/build/internal/cjs/src/calendar-v3-event-events.http.js +777 -0
- package/build/internal/cjs/src/calendar-v3-event-events.http.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.meta.d.ts +39 -0
- package/build/internal/cjs/src/calendar-v3-event-events.meta.js +275 -0
- package/build/internal/cjs/src/calendar-v3-event-events.meta.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.public.d.ts +242 -0
- package/build/internal/cjs/src/calendar-v3-event-events.public.js +196 -0
- package/build/internal/cjs/src/calendar-v3-event-events.public.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.types.d.ts +1750 -0
- package/build/internal/cjs/src/calendar-v3-event-events.types.js +157 -0
- package/build/internal/cjs/src/calendar-v3-event-events.types.js.map +1 -0
- package/build/internal/cjs/src/calendar-v3-event-events.universal.d.ts +3063 -0
- package/build/internal/cjs/src/calendar-v3-event-events.universal.js +1182 -0
- package/build/internal/cjs/src/calendar-v3-event-events.universal.js.map +1 -0
- package/build/internal/es/index.d.ts +1 -0
- package/build/internal/es/index.js +2 -0
- package/build/internal/es/index.js.map +1 -0
- package/build/internal/es/index.typings.d.ts +1 -0
- package/build/internal/es/index.typings.js +2 -0
- package/build/internal/es/index.typings.js.map +1 -0
- package/build/internal/es/meta.d.ts +1 -0
- package/build/internal/es/meta.js +2 -0
- package/build/internal/es/meta.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.context.d.ts +51 -0
- package/build/internal/es/src/calendar-v3-event-events.context.js +51 -0
- package/build/internal/es/src/calendar-v3-event-events.context.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.http.d.ts +144 -0
- package/build/internal/es/src/calendar-v3-event-events.http.js +761 -0
- package/build/internal/es/src/calendar-v3-event-events.http.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.meta.d.ts +39 -0
- package/build/internal/es/src/calendar-v3-event-events.meta.js +236 -0
- package/build/internal/es/src/calendar-v3-event-events.meta.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.public.d.ts +242 -0
- package/build/internal/es/src/calendar-v3-event-events.public.js +163 -0
- package/build/internal/es/src/calendar-v3-event-events.public.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.types.d.ts +1750 -0
- package/build/internal/es/src/calendar-v3-event-events.types.js +154 -0
- package/build/internal/es/src/calendar-v3-event-events.types.js.map +1 -0
- package/build/internal/es/src/calendar-v3-event-events.universal.d.ts +3063 -0
- package/build/internal/es/src/calendar-v3-event-events.universal.js +1143 -0
- package/build/internal/es/src/calendar-v3-event-events.universal.js.map +1 -0
- package/meta/package.json +3 -0
- package/package.json +52 -0
|
@@ -0,0 +1,1750 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* An event is a scheduled entry on a calendar that includes details like timing,
|
|
3
|
+
* location, and participants. Each event is associated with
|
|
4
|
+
* a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
|
|
5
|
+
* from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
|
|
6
|
+
* Events can either be standalone, part of a recurring series, or define a
|
|
7
|
+
* recurrence pattern. You can also specify whether events block time on the
|
|
8
|
+
* schedule or allow other events to be scheduled concurrently.
|
|
9
|
+
*/
|
|
10
|
+
export interface Event {
|
|
11
|
+
/**
|
|
12
|
+
* Event ID.
|
|
13
|
+
* @readonly
|
|
14
|
+
*/
|
|
15
|
+
id?: string | null;
|
|
16
|
+
/**
|
|
17
|
+
* ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
|
|
18
|
+
* the event belongs to.
|
|
19
|
+
* After creating an event, you can't assign it to a different schedule.
|
|
20
|
+
*/
|
|
21
|
+
scheduleId?: string | null;
|
|
22
|
+
/**
|
|
23
|
+
* ID of the external schedule the event belongs to.
|
|
24
|
+
*
|
|
25
|
+
* For example, if the event belongs to a Bookings staff member, identical to
|
|
26
|
+
* the ID of the [resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
|
|
27
|
+
* If the schedule belongs to a Bookings service,
|
|
28
|
+
* identical to the ID of the [service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object).
|
|
29
|
+
* @readonly
|
|
30
|
+
*/
|
|
31
|
+
externalScheduleId?: string | null;
|
|
32
|
+
/**
|
|
33
|
+
* Schedule name.
|
|
34
|
+
* @readonly
|
|
35
|
+
*/
|
|
36
|
+
scheduleName?: string | null;
|
|
37
|
+
/**
|
|
38
|
+
* Event type. You can set the event type but you can't update it.
|
|
39
|
+
*
|
|
40
|
+
* Supported values:
|
|
41
|
+
* + `DEFAULT`: A standard event that's not further specified.
|
|
42
|
+
* + `WORKING_HOURS`: The event adds working hours to a schedule. By default not returned in [Query Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/query-events).
|
|
43
|
+
*
|
|
44
|
+
* Additional supported values, if Wix Bookings is installed:
|
|
45
|
+
* + `APPOINTMENT`: Bookings appointment event.
|
|
46
|
+
* + `CLASS`: Bookings class event.
|
|
47
|
+
* + `COURSE`: Bookings course event.
|
|
48
|
+
*/
|
|
49
|
+
type?: string | null;
|
|
50
|
+
/**
|
|
51
|
+
* Event status.
|
|
52
|
+
*
|
|
53
|
+
* Supported values:
|
|
54
|
+
* + `CONFIRMED`: Event is scheduled to happen or has happened.
|
|
55
|
+
* + `CANCELLED`: Event has been canceled.
|
|
56
|
+
*
|
|
57
|
+
* Default: `CONFIRMED`
|
|
58
|
+
* @readonly
|
|
59
|
+
*/
|
|
60
|
+
status?: Status;
|
|
61
|
+
/**
|
|
62
|
+
* Event title.
|
|
63
|
+
*
|
|
64
|
+
* Min: 1 character
|
|
65
|
+
* Max: 200 characters
|
|
66
|
+
*/
|
|
67
|
+
title?: string | null;
|
|
68
|
+
/** Information about when the event starts. */
|
|
69
|
+
start?: ZonedDate;
|
|
70
|
+
/**
|
|
71
|
+
* Information about when the event ends.
|
|
72
|
+
*
|
|
73
|
+
* Maximum allowed date: Year 2100, or up to 100 years from the event's start date (whichever comes first).
|
|
74
|
+
*/
|
|
75
|
+
end?: ZonedDate;
|
|
76
|
+
/**
|
|
77
|
+
* Information about when the event starts adjusted to the `timeZone` of the
|
|
78
|
+
* business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
|
|
79
|
+
* or a different `timeZone` you provide in the call's request.
|
|
80
|
+
* @readonly
|
|
81
|
+
*/
|
|
82
|
+
adjustedStart?: ZonedDate;
|
|
83
|
+
/**
|
|
84
|
+
* Information about when the event ends adjusted to the `timeZone` of the
|
|
85
|
+
* business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
|
|
86
|
+
* or a different `timeZone` you provide in the call's request.
|
|
87
|
+
* @readonly
|
|
88
|
+
*/
|
|
89
|
+
adjustedEnd?: ZonedDate;
|
|
90
|
+
/**
|
|
91
|
+
* Time zone the event is associated with in
|
|
92
|
+
* [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
|
|
93
|
+
* Only regional time zones and UTC are supported.
|
|
94
|
+
* For example, `America/New_York` or `UTC`.
|
|
95
|
+
*
|
|
96
|
+
* Default: `timeZone` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
|
|
97
|
+
*/
|
|
98
|
+
timeZone?: string | null;
|
|
99
|
+
/**
|
|
100
|
+
* Information about whether the event is a single occurrence or part of a
|
|
101
|
+
* recurring series.
|
|
102
|
+
*
|
|
103
|
+
* Supported values:
|
|
104
|
+
* + `NONE`: The event occurs only once and doesn't repeat.
|
|
105
|
+
* + `MASTER`: Defines the recurrence pattern for a series of recurring events.
|
|
106
|
+
* + `INSTANCE`: A specific occurrence of a recurring event. You can't create an event with `{"recurrenceType": "INSTANCE"}`, instead it's automatically generated based on the recurrence rule. If you update an `INSTANCE` event, `recurrenceType` automatically changes to `EXCEPTION`.
|
|
107
|
+
* + `EXCEPTION`: A modified instance of a recurring event that differs from the recurrence pattern. For example, an event with a different time or location. You can't create an `EXCEPTION` event directly, instead it's set automatically when you update an `INSTANCE` event.
|
|
108
|
+
*
|
|
109
|
+
* Default: `NONE`
|
|
110
|
+
* @readonly
|
|
111
|
+
*/
|
|
112
|
+
recurrenceType?: RecurrenceType;
|
|
113
|
+
/**
|
|
114
|
+
* Recurrence pattern for a series of events. This field is required when
|
|
115
|
+
* creating a `MASTER` event and isn't available for non-recurring events.
|
|
116
|
+
* You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
|
|
117
|
+
*
|
|
118
|
+
* For example, an event that repeats every second Monday until January 7, 2026,
|
|
119
|
+
* at 8:00 AM has the following `recurrenceRule`:
|
|
120
|
+
* - `frequency = WEEKLY`
|
|
121
|
+
* - `interval = 2`
|
|
122
|
+
* - `days = [MONDAY]`
|
|
123
|
+
* - `until = 20260107T08:00:00Z`
|
|
124
|
+
*/
|
|
125
|
+
recurrenceRule?: RecurrenceRule;
|
|
126
|
+
/**
|
|
127
|
+
* ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
|
|
128
|
+
* and `EXCEPTION` events.
|
|
129
|
+
* @readonly
|
|
130
|
+
*/
|
|
131
|
+
recurringEventId?: string | null;
|
|
132
|
+
/**
|
|
133
|
+
* Specifies whether the event blocks time in the schedule it belongs to.
|
|
134
|
+
*
|
|
135
|
+
* Supported values:
|
|
136
|
+
* + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same entities (for example, Booking staff members) from being scheduled at the same time.
|
|
137
|
+
* + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
|
|
138
|
+
*
|
|
139
|
+
* Default: `OPAQUE`
|
|
140
|
+
*/
|
|
141
|
+
transparency?: Transparency;
|
|
142
|
+
/**
|
|
143
|
+
* Event location.
|
|
144
|
+
*
|
|
145
|
+
* Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
|
|
146
|
+
*/
|
|
147
|
+
location?: Location;
|
|
148
|
+
/**
|
|
149
|
+
* List of [Wix Bookings resources](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object)
|
|
150
|
+
* affected by the event. This could include, for example, the
|
|
151
|
+
* [Wix Bookings staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/staff-member-object)
|
|
152
|
+
* providing the service or the room where the appointment takes place.
|
|
153
|
+
*
|
|
154
|
+
* Max: 100 resources
|
|
155
|
+
*/
|
|
156
|
+
resources?: Resource[];
|
|
157
|
+
/**
|
|
158
|
+
* Maximum number of participants who can participate in the event.
|
|
159
|
+
*
|
|
160
|
+
* Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
|
|
161
|
+
*/
|
|
162
|
+
totalCapacity?: number | null;
|
|
163
|
+
/**
|
|
164
|
+
* Number of participants who can still be added to the event.
|
|
165
|
+
* @readonly
|
|
166
|
+
*/
|
|
167
|
+
remainingCapacity?: number | null;
|
|
168
|
+
/**
|
|
169
|
+
* Information about the event's participants.
|
|
170
|
+
* Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
|
|
171
|
+
* @readonly
|
|
172
|
+
*/
|
|
173
|
+
participants?: Participants;
|
|
174
|
+
/**
|
|
175
|
+
* Information about the event's online conferencing.
|
|
176
|
+
* Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
|
|
177
|
+
*
|
|
178
|
+
* Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
|
|
179
|
+
*/
|
|
180
|
+
conferencingDetails?: ConferencingDetails;
|
|
181
|
+
/**
|
|
182
|
+
* Additional notes about the event.
|
|
183
|
+
* Returned only if explicitly requested. For more details, see the [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#retrieve-personal-information).
|
|
184
|
+
*
|
|
185
|
+
* Min: 1 character
|
|
186
|
+
* Max: 5000 characters
|
|
187
|
+
*/
|
|
188
|
+
notes?: string | null;
|
|
189
|
+
/**
|
|
190
|
+
* List of fields whose values are inherited.
|
|
191
|
+
* + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
|
|
192
|
+
* + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related `MASTER` event.
|
|
193
|
+
* @readonly
|
|
194
|
+
*/
|
|
195
|
+
inheritedFields?: Field[];
|
|
196
|
+
/**
|
|
197
|
+
* ID of the app that owns the event. Identical to `appId` of the
|
|
198
|
+
* [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
|
|
199
|
+
* to which the event belongs.
|
|
200
|
+
* @readonly
|
|
201
|
+
*/
|
|
202
|
+
appId?: string | null;
|
|
203
|
+
/**
|
|
204
|
+
* List of permissions associated with the event. Refer to the
|
|
205
|
+
* [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
|
|
206
|
+
* for more information.
|
|
207
|
+
* @readonly
|
|
208
|
+
*/
|
|
209
|
+
permissions?: Permission[];
|
|
210
|
+
/** Extensions enabling applications or users to save custom data related to the event. */
|
|
211
|
+
extendedFields?: ExtendedFields;
|
|
212
|
+
/**
|
|
213
|
+
* Revision number, which increments each time the event is updated.
|
|
214
|
+
* To prevent conflicting changes, the current revision must be passed when updating the event.
|
|
215
|
+
* Ignored when creating an event.
|
|
216
|
+
* @readonly
|
|
217
|
+
*/
|
|
218
|
+
revision?: string | null;
|
|
219
|
+
/**
|
|
220
|
+
* Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
|
|
221
|
+
* @readonly
|
|
222
|
+
*/
|
|
223
|
+
createdDate?: Date | null;
|
|
224
|
+
/**
|
|
225
|
+
* Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
|
|
226
|
+
* @readonly
|
|
227
|
+
*/
|
|
228
|
+
updatedDate?: Date | null;
|
|
229
|
+
}
|
|
230
|
+
export declare enum Status {
|
|
231
|
+
UNKNOWN_STATUS = "UNKNOWN_STATUS",
|
|
232
|
+
/** Event is scheduled to happen or has happened. */
|
|
233
|
+
CONFIRMED = "CONFIRMED",
|
|
234
|
+
/** Event has been canceled. */
|
|
235
|
+
CANCELLED = "CANCELLED"
|
|
236
|
+
}
|
|
237
|
+
/** A date time with a time zone, having the UTC offset and date determined by the server. */
|
|
238
|
+
export interface ZonedDate {
|
|
239
|
+
/**
|
|
240
|
+
* Local date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
|
|
241
|
+
* For example, `2024-01-30T13:30:00`.
|
|
242
|
+
* Wix Calendar APIs ignore seconds.
|
|
243
|
+
*/
|
|
244
|
+
localDate?: string | null;
|
|
245
|
+
/**
|
|
246
|
+
* Time zone in
|
|
247
|
+
* [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
|
|
248
|
+
* For example, `America/New_York`.
|
|
249
|
+
* @readonly
|
|
250
|
+
*/
|
|
251
|
+
timeZone?: string | null;
|
|
252
|
+
/**
|
|
253
|
+
* UTC date time in [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
|
|
254
|
+
* For example, `2024-01-30T13:30:00`.
|
|
255
|
+
* Not available for adjusted date fields.
|
|
256
|
+
* @readonly
|
|
257
|
+
*/
|
|
258
|
+
utcDate?: Date | null;
|
|
259
|
+
}
|
|
260
|
+
export declare enum RecurrenceType {
|
|
261
|
+
UNKNOWN_RECURRENCE_TYPE = "UNKNOWN_RECURRENCE_TYPE",
|
|
262
|
+
/** The event occurs only once and doesn't repeat. */
|
|
263
|
+
NONE = "NONE",
|
|
264
|
+
/** Defines the recurrence pattern for a series of recurring events. */
|
|
265
|
+
MASTER = "MASTER",
|
|
266
|
+
/** 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`. */
|
|
267
|
+
INSTANCE = "INSTANCE",
|
|
268
|
+
/** 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. */
|
|
269
|
+
EXCEPTION = "EXCEPTION"
|
|
270
|
+
}
|
|
271
|
+
export interface RecurrenceRule {
|
|
272
|
+
/**
|
|
273
|
+
* Frequency how often the event repeats. Works together with `interval`.
|
|
274
|
+
*
|
|
275
|
+
* Supported values:
|
|
276
|
+
* + `WEEKLY`: The event's recurrence pattern is based on weeks.
|
|
277
|
+
*/
|
|
278
|
+
frequency?: Frequency;
|
|
279
|
+
/**
|
|
280
|
+
* Interval how often the event repeats. Works together with `frequency`.
|
|
281
|
+
* For example, `frequency` set to `WEEKLY` and `interval` set to `2` means
|
|
282
|
+
* the event repeats every 2 weeks.
|
|
283
|
+
*
|
|
284
|
+
* Min: `1`
|
|
285
|
+
* Max: `4`
|
|
286
|
+
* Default: `1`
|
|
287
|
+
*/
|
|
288
|
+
interval?: number | null;
|
|
289
|
+
/**
|
|
290
|
+
* Days of the week when the recurring event takes place.
|
|
291
|
+
* Currently, only a single day is supported.
|
|
292
|
+
*
|
|
293
|
+
* Min: 1 day
|
|
294
|
+
* Max: 1 day
|
|
295
|
+
*/
|
|
296
|
+
days?: Day[];
|
|
297
|
+
/**
|
|
298
|
+
* Date until when the event repeats.
|
|
299
|
+
* If not specified, the event repeats forever.
|
|
300
|
+
*/
|
|
301
|
+
until?: ZonedDate;
|
|
302
|
+
/**
|
|
303
|
+
* Date until when the event repeats
|
|
304
|
+
* adjusted to the `timeZone` of the business
|
|
305
|
+
* [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
|
|
306
|
+
* or a different `timeZone` you provide in the call's request.
|
|
307
|
+
* @readonly
|
|
308
|
+
*/
|
|
309
|
+
adjustedUntil?: ZonedDate;
|
|
310
|
+
}
|
|
311
|
+
export declare enum Frequency {
|
|
312
|
+
UNKNOWN_FREQUENCY = "UNKNOWN_FREQUENCY",
|
|
313
|
+
/** The event's recurrence pattern is based on weeks. */
|
|
314
|
+
WEEKLY = "WEEKLY"
|
|
315
|
+
}
|
|
316
|
+
export declare enum Day {
|
|
317
|
+
/** The recurring event takes place on Mondays. */
|
|
318
|
+
MONDAY = "MONDAY",
|
|
319
|
+
/** The recurring event takes place on Tuesdays. */
|
|
320
|
+
TUESDAY = "TUESDAY",
|
|
321
|
+
/** The recurring event takes place on Wednesday. */
|
|
322
|
+
WEDNESDAY = "WEDNESDAY",
|
|
323
|
+
/** The recurring event takes place on Thursdays. */
|
|
324
|
+
THURSDAY = "THURSDAY",
|
|
325
|
+
/** The recurring event takes place on Fridays. */
|
|
326
|
+
FRIDAY = "FRIDAY",
|
|
327
|
+
/** The recurring event takes place on Saturdays. */
|
|
328
|
+
SATURDAY = "SATURDAY",
|
|
329
|
+
/** The recurring event takes place on Sundays. */
|
|
330
|
+
SUNDAY = "SUNDAY"
|
|
331
|
+
}
|
|
332
|
+
export declare enum Transparency {
|
|
333
|
+
UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
|
|
334
|
+
/** 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. */
|
|
335
|
+
OPAQUE = "OPAQUE",
|
|
336
|
+
/** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
|
|
337
|
+
TRANSPARENT = "TRANSPARENT"
|
|
338
|
+
}
|
|
339
|
+
export interface Location {
|
|
340
|
+
/**
|
|
341
|
+
* [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
|
|
342
|
+
* ID. Available only for `BUSINESS` locations.
|
|
343
|
+
*/
|
|
344
|
+
id?: string | null;
|
|
345
|
+
/**
|
|
346
|
+
* Location type.
|
|
347
|
+
*
|
|
348
|
+
* Supported values:
|
|
349
|
+
* + `BUSINESS`: The event is held at a business location.
|
|
350
|
+
* + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
|
|
351
|
+
* + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
|
|
352
|
+
*/
|
|
353
|
+
type?: LocationType;
|
|
354
|
+
/**
|
|
355
|
+
* Location name. For `BUSINESS` locations, it's identical to the
|
|
356
|
+
* [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
|
|
357
|
+
* `name`.
|
|
358
|
+
*
|
|
359
|
+
* Min: 1 character
|
|
360
|
+
* Max: 150 characters
|
|
361
|
+
*/
|
|
362
|
+
name?: string | null;
|
|
363
|
+
/**
|
|
364
|
+
* Location address. For `BUSINESS` locations, it's identical to the
|
|
365
|
+
* [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
|
|
366
|
+
* `formattedAddress`.
|
|
367
|
+
*/
|
|
368
|
+
address?: string | null;
|
|
369
|
+
}
|
|
370
|
+
export declare enum LocationType {
|
|
371
|
+
UNKNOWN_TYPE = "UNKNOWN_TYPE",
|
|
372
|
+
/** The event is held at a business location. */
|
|
373
|
+
BUSINESS = "BUSINESS",
|
|
374
|
+
/** The event is held at the customer's location, such as their home or office. */
|
|
375
|
+
CUSTOMER = "CUSTOMER",
|
|
376
|
+
/** The event is held at an address or venue not tied to the business or customer. */
|
|
377
|
+
CUSTOM = "CUSTOM"
|
|
378
|
+
}
|
|
379
|
+
export interface Resource {
|
|
380
|
+
/** Resource ID. */
|
|
381
|
+
id?: string | null;
|
|
382
|
+
/**
|
|
383
|
+
* Resource name.
|
|
384
|
+
* @readonly
|
|
385
|
+
*/
|
|
386
|
+
name?: string | null;
|
|
387
|
+
/**
|
|
388
|
+
* Resource type.
|
|
389
|
+
* @readonly
|
|
390
|
+
*/
|
|
391
|
+
type?: string | null;
|
|
392
|
+
/**
|
|
393
|
+
* Specifies whether the event blocks time in the resource's schedule.
|
|
394
|
+
*
|
|
395
|
+
* Supported values:
|
|
396
|
+
* + `OPAQUE`: The schedule is blocked during the event, preventing other events that involve the same resource from being scheduled at the same time.
|
|
397
|
+
* + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
|
|
398
|
+
*
|
|
399
|
+
* Default: `OPAQUE`.
|
|
400
|
+
*/
|
|
401
|
+
transparency?: Transparency;
|
|
402
|
+
/**
|
|
403
|
+
* Permission role associated with the resource. Refer to the
|
|
404
|
+
* [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
|
|
405
|
+
* for more information.
|
|
406
|
+
*/
|
|
407
|
+
permissionRole?: Role;
|
|
408
|
+
}
|
|
409
|
+
export declare enum Role {
|
|
410
|
+
UNKNOWN_ROLE = "UNKNOWN_ROLE",
|
|
411
|
+
/** Full read and write access. */
|
|
412
|
+
WRITER = "WRITER",
|
|
413
|
+
/** Full read access, write access limited to `event.notes`. */
|
|
414
|
+
COMMENTER = "COMMENTER"
|
|
415
|
+
}
|
|
416
|
+
export interface Participants {
|
|
417
|
+
/**
|
|
418
|
+
* Total number of participants.
|
|
419
|
+
*
|
|
420
|
+
* Min: `0`
|
|
421
|
+
*/
|
|
422
|
+
total?: number | null;
|
|
423
|
+
/**
|
|
424
|
+
* Full or partial list of the participants.
|
|
425
|
+
*
|
|
426
|
+
* Max: 50 participants
|
|
427
|
+
*/
|
|
428
|
+
list?: Participant[];
|
|
429
|
+
/**
|
|
430
|
+
* Whether there are more participants for the event than listed.
|
|
431
|
+
*
|
|
432
|
+
* + `false`: The list includes all participants.
|
|
433
|
+
* + `true`: The list doesn't include all participants.
|
|
434
|
+
*/
|
|
435
|
+
hasMore?: boolean | null;
|
|
436
|
+
/**
|
|
437
|
+
* Participant's status.
|
|
438
|
+
*
|
|
439
|
+
* Supported values:
|
|
440
|
+
* + `CONFIRMED`: All participants are confirmed.
|
|
441
|
+
* + `PENDING_CONFIRMATION`: At least one participant isn't confirmed yet.
|
|
442
|
+
*/
|
|
443
|
+
status?: ParticipantsStatus;
|
|
444
|
+
}
|
|
445
|
+
export interface Participant {
|
|
446
|
+
/**
|
|
447
|
+
* Participant name.
|
|
448
|
+
*
|
|
449
|
+
* Min: 1 character
|
|
450
|
+
* Max: 200 characters
|
|
451
|
+
*/
|
|
452
|
+
name?: string | null;
|
|
453
|
+
/** Participant's phone number. */
|
|
454
|
+
phone?: string | null;
|
|
455
|
+
/** Participant's email address. */
|
|
456
|
+
email?: string | null;
|
|
457
|
+
/**
|
|
458
|
+
* [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
|
|
459
|
+
* ID of the participant.
|
|
460
|
+
*/
|
|
461
|
+
contactId?: string | null;
|
|
462
|
+
}
|
|
463
|
+
export declare enum ParticipantsStatus {
|
|
464
|
+
UNKNOWN_STATUS = "UNKNOWN_STATUS",
|
|
465
|
+
/** All participants are confirmed. */
|
|
466
|
+
CONFIRMED = "CONFIRMED",
|
|
467
|
+
/** At least one participant isn't confirmed yet. */
|
|
468
|
+
PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
|
|
469
|
+
}
|
|
470
|
+
export interface ConferencingDetails {
|
|
471
|
+
/** Conference type. For example, `Zoom`. */
|
|
472
|
+
type?: Type;
|
|
473
|
+
/**
|
|
474
|
+
* URL used by the host to start the conference.
|
|
475
|
+
*
|
|
476
|
+
* Min: 1 character
|
|
477
|
+
* Max: 2000 characters
|
|
478
|
+
*/
|
|
479
|
+
hostUrl?: string | null;
|
|
480
|
+
/**
|
|
481
|
+
* URL used by a guest to join the conference.
|
|
482
|
+
*
|
|
483
|
+
* Min: 1 character
|
|
484
|
+
* Max: 2000 characters
|
|
485
|
+
*/
|
|
486
|
+
guestUrl?: string | null;
|
|
487
|
+
/**
|
|
488
|
+
* Conference password.
|
|
489
|
+
*
|
|
490
|
+
* Min: 1 character
|
|
491
|
+
* Max: 100 characters
|
|
492
|
+
*/
|
|
493
|
+
password?: string | null;
|
|
494
|
+
/**
|
|
495
|
+
* Conference ID in an external system.
|
|
496
|
+
*
|
|
497
|
+
* Min: 1 character
|
|
498
|
+
* Max: 150 characters
|
|
499
|
+
*/
|
|
500
|
+
externalId?: string | null;
|
|
501
|
+
}
|
|
502
|
+
export declare enum Type {
|
|
503
|
+
UNKNOWN_TYPE = "UNKNOWN_TYPE",
|
|
504
|
+
ZOOM = "ZOOM",
|
|
505
|
+
CUSTOM = "CUSTOM"
|
|
506
|
+
}
|
|
507
|
+
export declare enum Field {
|
|
508
|
+
UNKNOWN_FIELD = "UNKNOWN_FIELD",
|
|
509
|
+
/** `title` is inherited from the schedule or `MASTER` event. */
|
|
510
|
+
TITLE = "TITLE",
|
|
511
|
+
/** `timeZone` is inherited from the schedule or `MASTER` event. */
|
|
512
|
+
TIME_ZONE = "TIME_ZONE",
|
|
513
|
+
/** `start` and `end` are inherited from the `MASTER` event. */
|
|
514
|
+
TIME = "TIME",
|
|
515
|
+
/** `location` is inherited from the schedule or `MASTER` event. */
|
|
516
|
+
LOCATION = "LOCATION",
|
|
517
|
+
/** `resources` is inherited from the `MASTER` event. */
|
|
518
|
+
RESOURCES = "RESOURCES",
|
|
519
|
+
/** `capacity` is inherited from the schedule or `MASTER` event. */
|
|
520
|
+
CAPACITY = "CAPACITY",
|
|
521
|
+
/** `participants` is inherited from the `MASTER` event. */
|
|
522
|
+
PARTICIPANTS = "PARTICIPANTS",
|
|
523
|
+
/** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
|
|
524
|
+
CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
|
|
525
|
+
}
|
|
526
|
+
export interface Permission {
|
|
527
|
+
/**
|
|
528
|
+
* [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
|
|
529
|
+
* granted the permission.
|
|
530
|
+
*/
|
|
531
|
+
identity?: CommonIdentificationData;
|
|
532
|
+
/**
|
|
533
|
+
* Permission role.
|
|
534
|
+
*
|
|
535
|
+
* Supported values:
|
|
536
|
+
* + `WRITER`: Full read and write access.
|
|
537
|
+
* + `COMMENTER`: Full read access, write access limited to `event.notes`.
|
|
538
|
+
*/
|
|
539
|
+
role?: Role;
|
|
540
|
+
}
|
|
541
|
+
export interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
|
|
542
|
+
/**
|
|
543
|
+
* ID of a Wix user. For example, the site owner or a
|
|
544
|
+
* [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
|
|
545
|
+
*/
|
|
546
|
+
wixUserId?: string;
|
|
547
|
+
}
|
|
548
|
+
/** @oneof */
|
|
549
|
+
export interface CommonIdentificationDataIdOneOf {
|
|
550
|
+
/**
|
|
551
|
+
* ID of a Wix user. For example, the site owner or a
|
|
552
|
+
* [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
|
|
553
|
+
*/
|
|
554
|
+
wixUserId?: string;
|
|
555
|
+
}
|
|
556
|
+
export declare enum IdentityType {
|
|
557
|
+
UNKNOWN = "UNKNOWN",
|
|
558
|
+
WIX_USER = "WIX_USER"
|
|
559
|
+
}
|
|
560
|
+
export interface ExtendedFields {
|
|
561
|
+
/**
|
|
562
|
+
* Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
|
|
563
|
+
* The value of each key is structured according to the schema defined when the extended fields were configured.
|
|
564
|
+
*
|
|
565
|
+
* You can only access fields for which you have the appropriate permissions.
|
|
566
|
+
*
|
|
567
|
+
* Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
568
|
+
*/
|
|
569
|
+
namespaces?: Record<string, Record<string, any>>;
|
|
570
|
+
}
|
|
571
|
+
export interface MigrateSiteRequest {
|
|
572
|
+
metaSiteId?: string;
|
|
573
|
+
/**
|
|
574
|
+
* Whether to run in safe, dry run mode, and only print logs without applying any changes.
|
|
575
|
+
* Default to `true`.
|
|
576
|
+
*/
|
|
577
|
+
dryRun?: boolean | null;
|
|
578
|
+
/**
|
|
579
|
+
* Whether to skip the migration if target data is already present.
|
|
580
|
+
* Default to `true`.
|
|
581
|
+
*/
|
|
582
|
+
skipIfTargetDataPresent?: boolean | null;
|
|
583
|
+
}
|
|
584
|
+
export interface MigrateSiteResponse {
|
|
585
|
+
dryRun?: boolean | null;
|
|
586
|
+
skipped?: boolean | null;
|
|
587
|
+
}
|
|
588
|
+
export interface UpdateScheduleWithFixedBusinessResourceIdRequest {
|
|
589
|
+
metaSiteId?: string;
|
|
590
|
+
currentBusinessResourceId?: string;
|
|
591
|
+
migrateBusinessConferenceId?: boolean;
|
|
592
|
+
}
|
|
593
|
+
export interface UpdateScheduleWithFixedBusinessResourceIdResponse {
|
|
594
|
+
}
|
|
595
|
+
export interface UpdateEventsWithFixedBusinessResourceIdRequest {
|
|
596
|
+
metaSiteId?: string;
|
|
597
|
+
currentBusinessResourceId?: string;
|
|
598
|
+
migrateBusinessConferenceId?: boolean;
|
|
599
|
+
}
|
|
600
|
+
export interface UpdateEventsWithFixedBusinessResourceIdResponse {
|
|
601
|
+
}
|
|
602
|
+
export interface RecurringEventSplit {
|
|
603
|
+
/** Original `MASTER` event that was shortened. */
|
|
604
|
+
updatedRecurringEventEndingBeforeSplit?: Event;
|
|
605
|
+
/** New `MASTER` event starting with the first event after the split date. */
|
|
606
|
+
newRecurringEventStartingFromSplit?: Event;
|
|
607
|
+
}
|
|
608
|
+
export interface EventCancelled {
|
|
609
|
+
/** Canceled event. */
|
|
610
|
+
event?: Event;
|
|
611
|
+
}
|
|
612
|
+
export interface ParticipantNotification {
|
|
613
|
+
/**
|
|
614
|
+
* Whether to notify the participants about changes made to the schedule or event.
|
|
615
|
+
*
|
|
616
|
+
* Default: `false`
|
|
617
|
+
*/
|
|
618
|
+
notifyParticipants?: boolean | null;
|
|
619
|
+
/**
|
|
620
|
+
* Message to send.
|
|
621
|
+
*
|
|
622
|
+
* Min: 1 character
|
|
623
|
+
* Max: 5000 characters
|
|
624
|
+
*/
|
|
625
|
+
message?: string | null;
|
|
626
|
+
}
|
|
627
|
+
/** Deprecated. Use EventUpdated instead, which includes the modified fields and additional metadata. */
|
|
628
|
+
export interface EventUpdatedWithMetadata {
|
|
629
|
+
/** The updated event. */
|
|
630
|
+
event?: Event;
|
|
631
|
+
/**
|
|
632
|
+
* Information about whether participants of the updated event are notified and
|
|
633
|
+
* the message they receive.
|
|
634
|
+
*/
|
|
635
|
+
participantNotification?: ParticipantNotification;
|
|
636
|
+
}
|
|
637
|
+
export interface GetEventRequest {
|
|
638
|
+
/**
|
|
639
|
+
* ID of the event to retrieve.
|
|
640
|
+
*
|
|
641
|
+
* Min: 36 characters
|
|
642
|
+
* Max: 250 characters
|
|
643
|
+
*/
|
|
644
|
+
eventId: string | null;
|
|
645
|
+
/**
|
|
646
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
647
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
648
|
+
* `America/New_York` or `UTC`.
|
|
649
|
+
*
|
|
650
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
651
|
+
*/
|
|
652
|
+
timeZone?: string | null;
|
|
653
|
+
/**
|
|
654
|
+
* Information about which fields containing personal data to return. Refer to the
|
|
655
|
+
* [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
|
|
656
|
+
* for more information.
|
|
657
|
+
*
|
|
658
|
+
* Supported values:
|
|
659
|
+
* + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
|
|
660
|
+
* + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
|
|
661
|
+
*
|
|
662
|
+
* Max: 1 field
|
|
663
|
+
* Default: No personal data is returned.
|
|
664
|
+
*/
|
|
665
|
+
fields?: RequestedFields[];
|
|
666
|
+
}
|
|
667
|
+
export declare enum RequestedFields {
|
|
668
|
+
UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
|
|
669
|
+
/** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
|
|
670
|
+
PI_FIELDS = "PI_FIELDS",
|
|
671
|
+
/** Returns only fields containing your own personal data. */
|
|
672
|
+
OWN_PI_FIELDS = "OWN_PI_FIELDS"
|
|
673
|
+
}
|
|
674
|
+
export interface GetEventResponse {
|
|
675
|
+
/** Retrieved event. */
|
|
676
|
+
event?: Event;
|
|
677
|
+
}
|
|
678
|
+
export interface ListEventsRequest {
|
|
679
|
+
/**
|
|
680
|
+
* IDs of the events to retrieve.
|
|
681
|
+
*
|
|
682
|
+
* Min: 1 event ID
|
|
683
|
+
* Min: 100 event IDs
|
|
684
|
+
*/
|
|
685
|
+
eventIds: string[];
|
|
686
|
+
/**
|
|
687
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
688
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
689
|
+
* `America/New_York` or `UTC`.
|
|
690
|
+
*
|
|
691
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
692
|
+
*/
|
|
693
|
+
timeZone?: string | null;
|
|
694
|
+
/**
|
|
695
|
+
* Information about which fields containing personal data to return. Refer to the
|
|
696
|
+
* [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
|
|
697
|
+
* for more information.
|
|
698
|
+
*
|
|
699
|
+
* Supported values:
|
|
700
|
+
* + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
|
|
701
|
+
* + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
|
|
702
|
+
*
|
|
703
|
+
* Max: 1 field
|
|
704
|
+
* Default: No personal data is returned.
|
|
705
|
+
*/
|
|
706
|
+
fields?: RequestedFields[];
|
|
707
|
+
}
|
|
708
|
+
export interface ListEventsResponse {
|
|
709
|
+
/** Retrieved events matching the provided IDs. */
|
|
710
|
+
events?: Event[];
|
|
711
|
+
}
|
|
712
|
+
export interface QueryEventsRequest {
|
|
713
|
+
/**
|
|
714
|
+
* Local start date and time from which events are returned in
|
|
715
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
716
|
+
* `2024-01-30T13:30:00`.
|
|
717
|
+
*
|
|
718
|
+
* Events that start before the `fromLocalDate` but end after it are included in
|
|
719
|
+
* the results. Must be earlier than `toLocalDate` unless the sort order is
|
|
720
|
+
* descending.
|
|
721
|
+
*/
|
|
722
|
+
fromLocalDate?: string | null;
|
|
723
|
+
/**
|
|
724
|
+
* Local end date and time up to which events are returned in
|
|
725
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
726
|
+
* `2024-01-30T13:30:00`.
|
|
727
|
+
*
|
|
728
|
+
* Events that start before `toLocalDate` but end after it are included in the
|
|
729
|
+
* results. Must be later than `fromLocalDate` unless the sort order is
|
|
730
|
+
* descending.
|
|
731
|
+
*/
|
|
732
|
+
toLocalDate?: string | null;
|
|
733
|
+
/**
|
|
734
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
735
|
+
* for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
|
|
736
|
+
* `adjustedEnd`. For example, `America/New_York` or `UTC`.
|
|
737
|
+
*
|
|
738
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
739
|
+
*/
|
|
740
|
+
timeZone?: string | null;
|
|
741
|
+
/** Query containing filters and paging. */
|
|
742
|
+
query?: CursorQuery;
|
|
743
|
+
/**
|
|
744
|
+
* Filters events based on their `recurrenceType`.
|
|
745
|
+
*
|
|
746
|
+
* Max: 5 recurrence types can be specified.
|
|
747
|
+
* Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
|
|
748
|
+
*/
|
|
749
|
+
recurrenceType?: RecurrenceType[];
|
|
750
|
+
/**
|
|
751
|
+
* Information about which fields containing personal data to return. Refer to the
|
|
752
|
+
* [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
|
|
753
|
+
* for more information.
|
|
754
|
+
*
|
|
755
|
+
* Supported values:
|
|
756
|
+
* + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
|
|
757
|
+
* + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
|
|
758
|
+
*
|
|
759
|
+
* Max: 1 field
|
|
760
|
+
* Default: No personal data is returned.
|
|
761
|
+
*/
|
|
762
|
+
fields?: RequestedFields[];
|
|
763
|
+
}
|
|
764
|
+
/** TODO Diverge */
|
|
765
|
+
export interface CursorQuery extends CursorQueryPagingMethodOneOf {
|
|
766
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
|
|
767
|
+
cursorPaging?: CursorPaging;
|
|
768
|
+
/**
|
|
769
|
+
* Filter object.
|
|
770
|
+
* See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
|
|
771
|
+
* for more information.
|
|
772
|
+
*
|
|
773
|
+
* Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
|
|
774
|
+
*
|
|
775
|
+
* For a detailed list of supported filters, see Supported Filters.
|
|
776
|
+
*/
|
|
777
|
+
filter?: Record<string, any> | null;
|
|
778
|
+
/**
|
|
779
|
+
* Whether to sort events by their start date in ascending order or by their end date in descending order.
|
|
780
|
+
* Default is start ascending.
|
|
781
|
+
*/
|
|
782
|
+
sort?: Sorting[];
|
|
783
|
+
}
|
|
784
|
+
/** @oneof */
|
|
785
|
+
export interface CursorQueryPagingMethodOneOf {
|
|
786
|
+
/** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter`. */
|
|
787
|
+
cursorPaging?: CursorPaging;
|
|
788
|
+
}
|
|
789
|
+
/** TODO Diverge */
|
|
790
|
+
export interface Sorting {
|
|
791
|
+
/**
|
|
792
|
+
* The field to sort by.
|
|
793
|
+
* Either `start` or `end`.
|
|
794
|
+
* Default is `start`.
|
|
795
|
+
*/
|
|
796
|
+
fieldName?: string;
|
|
797
|
+
/** Sort order. */
|
|
798
|
+
order?: SortOrder;
|
|
799
|
+
}
|
|
800
|
+
export declare enum SortOrder {
|
|
801
|
+
ASC = "ASC",
|
|
802
|
+
DESC = "DESC"
|
|
803
|
+
}
|
|
804
|
+
/** TODO Diverge */
|
|
805
|
+
export interface CursorPaging {
|
|
806
|
+
/**
|
|
807
|
+
* Number of events to return.
|
|
808
|
+
* Defaults to `50`. Maximum `1000`.
|
|
809
|
+
*/
|
|
810
|
+
limit?: number | null;
|
|
811
|
+
/**
|
|
812
|
+
* Pointer to the next or previous page in the list of results.
|
|
813
|
+
*
|
|
814
|
+
* You can get the relevant cursor token
|
|
815
|
+
* from the `pagingMetadata` object in the previous call's response.
|
|
816
|
+
* Not relevant for the first request.
|
|
817
|
+
*/
|
|
818
|
+
cursor?: string | null;
|
|
819
|
+
}
|
|
820
|
+
export interface QueryEventsResponse {
|
|
821
|
+
/** Retrieved events matching the provided query. */
|
|
822
|
+
events?: Event[];
|
|
823
|
+
/** Paging metadata. */
|
|
824
|
+
pagingMetadata?: CursorPagingMetadata;
|
|
825
|
+
}
|
|
826
|
+
/** TODO Diverge */
|
|
827
|
+
export interface CursorPagingMetadata {
|
|
828
|
+
/** Number of items returned in the response. */
|
|
829
|
+
count?: number | null;
|
|
830
|
+
/** 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). */
|
|
831
|
+
cursors?: Cursors;
|
|
832
|
+
/**
|
|
833
|
+
* Indicates if there are more results after the current page.
|
|
834
|
+
* If `true`, another page of results can be retrieved.
|
|
835
|
+
* If `false`, this is the last page.
|
|
836
|
+
*/
|
|
837
|
+
hasNext?: boolean | null;
|
|
838
|
+
}
|
|
839
|
+
export interface Cursors {
|
|
840
|
+
/** Cursor pointing to next page in the list of results. */
|
|
841
|
+
next?: string | null;
|
|
842
|
+
}
|
|
843
|
+
export interface ListRecurringEventInstancesHistoryRequest {
|
|
844
|
+
/**
|
|
845
|
+
* The ID of the recurring event.
|
|
846
|
+
* Required, unless `cursorPaging` is provided.
|
|
847
|
+
*/
|
|
848
|
+
recurringEventId?: string | null;
|
|
849
|
+
/**
|
|
850
|
+
* The revision of the recurring event.
|
|
851
|
+
* Required, unless `cursorPaging` is provided.
|
|
852
|
+
*/
|
|
853
|
+
revision?: string | null;
|
|
854
|
+
/**
|
|
855
|
+
* Inclusive start date for which events are returned, in ISO-8601 format.
|
|
856
|
+
* Events that begin at or after the `fromDate` are included in the results.
|
|
857
|
+
* Required, unless `cursorPaging` is provided.
|
|
858
|
+
*/
|
|
859
|
+
fromDate?: Date | null;
|
|
860
|
+
/**
|
|
861
|
+
* Exclusive end date for which events are returned, in ISO-8601 format.
|
|
862
|
+
* Events that begin before the `toDate` are included in the results.
|
|
863
|
+
* Required, unless `cursorPaging` is provided.
|
|
864
|
+
*/
|
|
865
|
+
toDate?: Date | null;
|
|
866
|
+
/** Optional cursor pointing to the next page of events. */
|
|
867
|
+
cursorPaging?: CursorPaging;
|
|
868
|
+
}
|
|
869
|
+
export interface ListRecurringEventInstancesHistoryResponse {
|
|
870
|
+
/** The recurring event instances. */
|
|
871
|
+
recurringEventInstances?: Event[];
|
|
872
|
+
/** Paging metadata. */
|
|
873
|
+
pagingMetadata?: CursorPagingMetadata;
|
|
874
|
+
}
|
|
875
|
+
export interface CreateEventRequest {
|
|
876
|
+
/** Event to create. */
|
|
877
|
+
event: Event;
|
|
878
|
+
/**
|
|
879
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
880
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
881
|
+
* `America/New_York` or `UTC`.
|
|
882
|
+
*
|
|
883
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
884
|
+
*/
|
|
885
|
+
timeZone?: string | null;
|
|
886
|
+
/**
|
|
887
|
+
* Idempotency key guaranteeing that you don't create the same event more
|
|
888
|
+
* than once.
|
|
889
|
+
*/
|
|
890
|
+
idempotencyKey?: string | null;
|
|
891
|
+
}
|
|
892
|
+
export interface CreateEventResponse {
|
|
893
|
+
/** Created event. */
|
|
894
|
+
event?: Event;
|
|
895
|
+
}
|
|
896
|
+
export interface BulkCreateEventRequest {
|
|
897
|
+
/** Events to create. */
|
|
898
|
+
events: MaskedEvent[];
|
|
899
|
+
/**
|
|
900
|
+
* Whether to return created events.
|
|
901
|
+
*
|
|
902
|
+
* Default: `false`.
|
|
903
|
+
*/
|
|
904
|
+
returnEntity?: boolean | null;
|
|
905
|
+
/**
|
|
906
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
907
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
908
|
+
* `America/New_York` or `UTC`.
|
|
909
|
+
*
|
|
910
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
911
|
+
*/
|
|
912
|
+
timeZone?: string | null;
|
|
913
|
+
}
|
|
914
|
+
export interface MaskedEvent {
|
|
915
|
+
/** Event to create. */
|
|
916
|
+
event?: Event;
|
|
917
|
+
}
|
|
918
|
+
export interface BulkCreateEventResponse {
|
|
919
|
+
/** The result for each event, containing the event and whether the action was successful. */
|
|
920
|
+
results?: BulkEventResult[];
|
|
921
|
+
/** Total successes and failures. */
|
|
922
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
923
|
+
}
|
|
924
|
+
export interface BulkEventResult {
|
|
925
|
+
/** Whether the requested action was successful. */
|
|
926
|
+
itemMetadata?: ItemMetadata;
|
|
927
|
+
/** The event. */
|
|
928
|
+
item?: Event;
|
|
929
|
+
}
|
|
930
|
+
export interface ItemMetadata {
|
|
931
|
+
/**
|
|
932
|
+
* Event ID.
|
|
933
|
+
* Should always be available, unless it's impossible (for example, when failing to create an event).
|
|
934
|
+
*/
|
|
935
|
+
id?: string | null;
|
|
936
|
+
/** Index of the item within the request array, for correlation between request and response items. */
|
|
937
|
+
originalIndex?: number;
|
|
938
|
+
/**
|
|
939
|
+
* Whether the requested action was successful for this event.
|
|
940
|
+
* When `false`, the `error` field is populated.
|
|
941
|
+
*/
|
|
942
|
+
success?: boolean;
|
|
943
|
+
/** Details about the error in case of failure. */
|
|
944
|
+
error?: ApplicationError;
|
|
945
|
+
}
|
|
946
|
+
export interface ApplicationError {
|
|
947
|
+
/** Error code. */
|
|
948
|
+
code?: string;
|
|
949
|
+
/** Description of the error. */
|
|
950
|
+
description?: string;
|
|
951
|
+
/** Data related to the error. */
|
|
952
|
+
data?: Record<string, any> | null;
|
|
953
|
+
}
|
|
954
|
+
export interface BulkActionMetadata {
|
|
955
|
+
/** Number of events that were successfully processed. */
|
|
956
|
+
totalSuccesses?: number;
|
|
957
|
+
/** Number of events that couldn't be processed. */
|
|
958
|
+
totalFailures?: number;
|
|
959
|
+
}
|
|
960
|
+
export interface UpdateEventRequest {
|
|
961
|
+
/** Event to update. */
|
|
962
|
+
event: Event;
|
|
963
|
+
/**
|
|
964
|
+
* Information about whether participants of the updated event are notified and
|
|
965
|
+
* the message they receive.
|
|
966
|
+
*/
|
|
967
|
+
participantNotification?: ParticipantNotification;
|
|
968
|
+
/**
|
|
969
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
970
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
971
|
+
* `America/New_York` or `UTC`.
|
|
972
|
+
*
|
|
973
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
974
|
+
*/
|
|
975
|
+
timeZone?: string | null;
|
|
976
|
+
}
|
|
977
|
+
export interface UpdateEventResponse {
|
|
978
|
+
/** Updated event. */
|
|
979
|
+
event?: Event;
|
|
980
|
+
}
|
|
981
|
+
export interface BulkUpdateEventRequest {
|
|
982
|
+
/**
|
|
983
|
+
* Events to update.
|
|
984
|
+
*
|
|
985
|
+
* Min: 1 event
|
|
986
|
+
* Max: 50 events
|
|
987
|
+
*/
|
|
988
|
+
events: BulkUpdateEventRequestMaskedEvent[];
|
|
989
|
+
/**
|
|
990
|
+
* Whether to return the updated events.
|
|
991
|
+
*
|
|
992
|
+
* Default: `false`
|
|
993
|
+
*/
|
|
994
|
+
returnEntity?: boolean | null;
|
|
995
|
+
/**
|
|
996
|
+
* Information about whether participants of the updated event are notified and
|
|
997
|
+
* the message they receive.
|
|
998
|
+
*/
|
|
999
|
+
participantNotification?: ParticipantNotification;
|
|
1000
|
+
/**
|
|
1001
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1002
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
1003
|
+
* `America/New_York` or `UTC`.
|
|
1004
|
+
*
|
|
1005
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1006
|
+
*/
|
|
1007
|
+
timeZone?: string | null;
|
|
1008
|
+
}
|
|
1009
|
+
export interface BulkUpdateEventRequestMaskedEvent {
|
|
1010
|
+
/** Event to update. */
|
|
1011
|
+
event?: Event;
|
|
1012
|
+
}
|
|
1013
|
+
export interface BulkUpdateEventResponse {
|
|
1014
|
+
/** The result for each event, containing the event and whether the action was successful. */
|
|
1015
|
+
results?: BulkEventResult[];
|
|
1016
|
+
/** Total successes and failures. */
|
|
1017
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1018
|
+
}
|
|
1019
|
+
export interface UpdateEventParticipantsRequest {
|
|
1020
|
+
/**
|
|
1021
|
+
* ID of the event to update.
|
|
1022
|
+
*
|
|
1023
|
+
* Min: 36 characters
|
|
1024
|
+
* Max: 250 characters
|
|
1025
|
+
*/
|
|
1026
|
+
eventId?: string | null;
|
|
1027
|
+
/** The participants to update. */
|
|
1028
|
+
participants?: Participants;
|
|
1029
|
+
}
|
|
1030
|
+
export interface UpdateEventParticipantsResponse {
|
|
1031
|
+
/** Updated event. */
|
|
1032
|
+
event?: Event;
|
|
1033
|
+
}
|
|
1034
|
+
export interface RestoreEventDefaultsRequest {
|
|
1035
|
+
/** ID of the event for which to restore default values. */
|
|
1036
|
+
eventId: string | null;
|
|
1037
|
+
/**
|
|
1038
|
+
* Fields for which to restore default values.
|
|
1039
|
+
*
|
|
1040
|
+
* `TIME` restores default values for `start` and `end`.
|
|
1041
|
+
*
|
|
1042
|
+
* Min: 1 field
|
|
1043
|
+
*/
|
|
1044
|
+
fields: Field[];
|
|
1045
|
+
/**
|
|
1046
|
+
* Information about whether participants of the updated event are notified and
|
|
1047
|
+
* the message they receive.
|
|
1048
|
+
*/
|
|
1049
|
+
participantNotification?: ParticipantNotification;
|
|
1050
|
+
/**
|
|
1051
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1052
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
1053
|
+
* `America/New_York` or `UTC`.
|
|
1054
|
+
*
|
|
1055
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1056
|
+
*/
|
|
1057
|
+
timeZone?: string | null;
|
|
1058
|
+
}
|
|
1059
|
+
export interface RestoreEventDefaultsResponse {
|
|
1060
|
+
/** Updated event. */
|
|
1061
|
+
event?: Event;
|
|
1062
|
+
}
|
|
1063
|
+
export interface SplitRecurringEventRequest {
|
|
1064
|
+
/** ID of the `MASTER` event to split. */
|
|
1065
|
+
recurringEventId: string | null;
|
|
1066
|
+
/**
|
|
1067
|
+
* Local date and time at which the `MASTER` event is split in
|
|
1068
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
1069
|
+
* `2025-03-11T09:00:00`.
|
|
1070
|
+
* Must be a future date that's after the `start` date of the next `INSTANCE` or
|
|
1071
|
+
* `EXCEPTION` event in the series. Additionally, there must be another
|
|
1072
|
+
* `INSTANCE` or `EXCEPTION` event following this next event, as the changes
|
|
1073
|
+
* wouldn't affect any event without a subsequent occurrence.
|
|
1074
|
+
*/
|
|
1075
|
+
splitLocalDate: string | null;
|
|
1076
|
+
/**
|
|
1077
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1078
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
1079
|
+
* `America/New_York` or `UTC`.
|
|
1080
|
+
*
|
|
1081
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1082
|
+
*/
|
|
1083
|
+
timeZone?: string | null;
|
|
1084
|
+
}
|
|
1085
|
+
export interface SplitRecurringEventResponse {
|
|
1086
|
+
/** Original `MASTER` event that was shortened. */
|
|
1087
|
+
updatedRecurringEventEndingBeforeSplit?: Event;
|
|
1088
|
+
/** New `MASTER` event starting with the first event after the split date. */
|
|
1089
|
+
newRecurringEventStartingFromSplit?: Event;
|
|
1090
|
+
}
|
|
1091
|
+
export interface CancelEventRequest {
|
|
1092
|
+
/** ID of the event to cancel. */
|
|
1093
|
+
eventId: string | null;
|
|
1094
|
+
/**
|
|
1095
|
+
* Information about whether participants of the canceled event are notified and
|
|
1096
|
+
* the message they receive.
|
|
1097
|
+
*/
|
|
1098
|
+
participantNotification?: ParticipantNotification;
|
|
1099
|
+
/**
|
|
1100
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1101
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
1102
|
+
* `America/New_York` or `UTC`.
|
|
1103
|
+
*
|
|
1104
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1105
|
+
*/
|
|
1106
|
+
timeZone?: string | null;
|
|
1107
|
+
}
|
|
1108
|
+
export interface CancelEventResponse {
|
|
1109
|
+
/** Canceled event. */
|
|
1110
|
+
event?: Event;
|
|
1111
|
+
}
|
|
1112
|
+
export interface BulkCancelEventRequest {
|
|
1113
|
+
/** IDs of the events to cancel. */
|
|
1114
|
+
eventIds: string[];
|
|
1115
|
+
/**
|
|
1116
|
+
* Whether to return the canceled events.
|
|
1117
|
+
*
|
|
1118
|
+
* Default: `false`
|
|
1119
|
+
*/
|
|
1120
|
+
returnEntity?: boolean | null;
|
|
1121
|
+
/**
|
|
1122
|
+
* Information about whether participants of the canceled events are notified and
|
|
1123
|
+
* the message they receive.
|
|
1124
|
+
*/
|
|
1125
|
+
participantNotification?: ParticipantNotification;
|
|
1126
|
+
/**
|
|
1127
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1128
|
+
* for calculating `adjustedStart` and `adjustedEnd`. For example,
|
|
1129
|
+
* `America/New_York` or `UTC`.
|
|
1130
|
+
*
|
|
1131
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1132
|
+
*/
|
|
1133
|
+
timeZone?: string | null;
|
|
1134
|
+
}
|
|
1135
|
+
export interface BulkCancelEventResponse {
|
|
1136
|
+
/** The result for each event, containing the event and whether the action was successful. */
|
|
1137
|
+
results?: BulkEventResult[];
|
|
1138
|
+
/** Total successes and failures. */
|
|
1139
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1140
|
+
}
|
|
1141
|
+
export interface DomainEvent extends DomainEventBodyOneOf {
|
|
1142
|
+
createdEvent?: EntityCreatedEvent;
|
|
1143
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
1144
|
+
deletedEvent?: EntityDeletedEvent;
|
|
1145
|
+
actionEvent?: ActionEvent;
|
|
1146
|
+
/**
|
|
1147
|
+
* Unique event ID.
|
|
1148
|
+
* Allows clients to ignore duplicate webhooks.
|
|
1149
|
+
*/
|
|
1150
|
+
id?: string;
|
|
1151
|
+
/**
|
|
1152
|
+
* Assumes actions are also always typed to an entity_type
|
|
1153
|
+
* Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
|
|
1154
|
+
*/
|
|
1155
|
+
entityFqdn?: string;
|
|
1156
|
+
/**
|
|
1157
|
+
* This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
|
|
1158
|
+
* This is although the created/updated/deleted notion is duplication of the oneof types
|
|
1159
|
+
* Example: created/updated/deleted/started/completed/email_opened
|
|
1160
|
+
*/
|
|
1161
|
+
slug?: string;
|
|
1162
|
+
/** ID of the entity associated with the event. */
|
|
1163
|
+
entityId?: string;
|
|
1164
|
+
/** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
|
|
1165
|
+
eventTime?: Date | null;
|
|
1166
|
+
/**
|
|
1167
|
+
* Whether the event was triggered as a result of a privacy regulation application
|
|
1168
|
+
* (for example, GDPR).
|
|
1169
|
+
*/
|
|
1170
|
+
triggeredByAnonymizeRequest?: boolean | null;
|
|
1171
|
+
/** If present, indicates the action that triggered the event. */
|
|
1172
|
+
originatedFrom?: string | null;
|
|
1173
|
+
/**
|
|
1174
|
+
* A sequence number defining the order of updates to the underlying entity.
|
|
1175
|
+
* For example, given that some entity was updated at 16:00 and than again at 16:01,
|
|
1176
|
+
* it is guaranteed that the sequence number of the second update is strictly higher than the first.
|
|
1177
|
+
* As the consumer, you can use this value to ensure that you handle messages in the correct order.
|
|
1178
|
+
* To do so, you will need to persist this number on your end, and compare the sequence number from the
|
|
1179
|
+
* message against the one you have stored. Given that the stored number is higher, you should ignore the message.
|
|
1180
|
+
*/
|
|
1181
|
+
entityEventSequence?: string | null;
|
|
1182
|
+
}
|
|
1183
|
+
/** @oneof */
|
|
1184
|
+
export interface DomainEventBodyOneOf {
|
|
1185
|
+
createdEvent?: EntityCreatedEvent;
|
|
1186
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
1187
|
+
deletedEvent?: EntityDeletedEvent;
|
|
1188
|
+
actionEvent?: ActionEvent;
|
|
1189
|
+
}
|
|
1190
|
+
export interface EntityCreatedEvent {
|
|
1191
|
+
entityAsJson?: string;
|
|
1192
|
+
/** Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity */
|
|
1193
|
+
restoreInfo?: RestoreInfo;
|
|
1194
|
+
}
|
|
1195
|
+
export interface RestoreInfo {
|
|
1196
|
+
deletedDate?: Date | null;
|
|
1197
|
+
}
|
|
1198
|
+
export interface EntityUpdatedEvent {
|
|
1199
|
+
/**
|
|
1200
|
+
* Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
|
|
1201
|
+
* This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
|
|
1202
|
+
* We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
|
|
1203
|
+
*/
|
|
1204
|
+
currentEntityAsJson?: string;
|
|
1205
|
+
}
|
|
1206
|
+
export interface EntityDeletedEvent {
|
|
1207
|
+
/** Entity that was deleted */
|
|
1208
|
+
deletedEntityAsJson?: string | null;
|
|
1209
|
+
}
|
|
1210
|
+
export interface ActionEvent {
|
|
1211
|
+
bodyAsJson?: string;
|
|
1212
|
+
}
|
|
1213
|
+
export interface MessageEnvelope {
|
|
1214
|
+
/** App instance ID. */
|
|
1215
|
+
instanceId?: string | null;
|
|
1216
|
+
/** Event type. */
|
|
1217
|
+
eventType?: string;
|
|
1218
|
+
/** The identification type and identity data. */
|
|
1219
|
+
identity?: IdentificationData;
|
|
1220
|
+
/** Stringify payload. */
|
|
1221
|
+
data?: string;
|
|
1222
|
+
}
|
|
1223
|
+
export interface IdentificationData extends IdentificationDataIdOneOf {
|
|
1224
|
+
/** ID of a site visitor that has not logged in to the site. */
|
|
1225
|
+
anonymousVisitorId?: string;
|
|
1226
|
+
/** ID of a site visitor that has logged in to the site. */
|
|
1227
|
+
memberId?: string;
|
|
1228
|
+
/** ID of a Wix user (site owner, contributor, etc.). */
|
|
1229
|
+
wixUserId?: string;
|
|
1230
|
+
/** ID of an app. */
|
|
1231
|
+
appId?: string;
|
|
1232
|
+
/** @readonly */
|
|
1233
|
+
identityType?: WebhookIdentityType;
|
|
1234
|
+
}
|
|
1235
|
+
/** @oneof */
|
|
1236
|
+
export interface IdentificationDataIdOneOf {
|
|
1237
|
+
/** ID of a site visitor that has not logged in to the site. */
|
|
1238
|
+
anonymousVisitorId?: string;
|
|
1239
|
+
/** ID of a site visitor that has logged in to the site. */
|
|
1240
|
+
memberId?: string;
|
|
1241
|
+
/** ID of a Wix user (site owner, contributor, etc.). */
|
|
1242
|
+
wixUserId?: string;
|
|
1243
|
+
/** ID of an app. */
|
|
1244
|
+
appId?: string;
|
|
1245
|
+
}
|
|
1246
|
+
export declare enum WebhookIdentityType {
|
|
1247
|
+
UNKNOWN = "UNKNOWN",
|
|
1248
|
+
ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
|
|
1249
|
+
MEMBER = "MEMBER",
|
|
1250
|
+
WIX_USER = "WIX_USER",
|
|
1251
|
+
APP = "APP"
|
|
1252
|
+
}
|
|
1253
|
+
/** Encapsulates all details written to the Greyhound topic when a site's properties are updated. */
|
|
1254
|
+
export interface SitePropertiesNotification {
|
|
1255
|
+
/** The site ID for which this update notification applies. */
|
|
1256
|
+
metasiteId?: string;
|
|
1257
|
+
/** The actual update event. */
|
|
1258
|
+
event?: SitePropertiesEvent;
|
|
1259
|
+
/** A convenience set of mappings from the MetaSite ID to its constituent services. */
|
|
1260
|
+
translations?: Translation[];
|
|
1261
|
+
/** Context of the notification */
|
|
1262
|
+
changeContext?: ChangeContext;
|
|
1263
|
+
}
|
|
1264
|
+
/** The actual update event for a particular notification. */
|
|
1265
|
+
export interface SitePropertiesEvent {
|
|
1266
|
+
/** Version of the site's properties represented by this update. */
|
|
1267
|
+
version?: number;
|
|
1268
|
+
/** Set of properties that were updated - corresponds to the fields in "properties". */
|
|
1269
|
+
fields?: string[];
|
|
1270
|
+
/** Updated properties. */
|
|
1271
|
+
properties?: Properties;
|
|
1272
|
+
}
|
|
1273
|
+
export interface Properties {
|
|
1274
|
+
/** Site categories. */
|
|
1275
|
+
categories?: Categories;
|
|
1276
|
+
/** Site locale. */
|
|
1277
|
+
locale?: Locale;
|
|
1278
|
+
/**
|
|
1279
|
+
* Site language.
|
|
1280
|
+
*
|
|
1281
|
+
* Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
|
|
1282
|
+
*/
|
|
1283
|
+
language?: string | null;
|
|
1284
|
+
/**
|
|
1285
|
+
* Site currency format used to bill customers.
|
|
1286
|
+
*
|
|
1287
|
+
* Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
|
|
1288
|
+
*/
|
|
1289
|
+
paymentCurrency?: string | null;
|
|
1290
|
+
/** Timezone in `America/New_York` format. */
|
|
1291
|
+
timeZone?: string | null;
|
|
1292
|
+
/** Email address. */
|
|
1293
|
+
email?: string | null;
|
|
1294
|
+
/** Phone number. */
|
|
1295
|
+
phone?: string | null;
|
|
1296
|
+
/** Fax number. */
|
|
1297
|
+
fax?: string | null;
|
|
1298
|
+
/** Address. */
|
|
1299
|
+
address?: Address;
|
|
1300
|
+
/** Site display name. */
|
|
1301
|
+
siteDisplayName?: string | null;
|
|
1302
|
+
/** Business name. */
|
|
1303
|
+
businessName?: string | null;
|
|
1304
|
+
/** Path to the site's logo in Wix Media (without Wix Media base URL). */
|
|
1305
|
+
logo?: string | null;
|
|
1306
|
+
/** Site description. */
|
|
1307
|
+
description?: string | null;
|
|
1308
|
+
/**
|
|
1309
|
+
* Business schedule. Regular and exceptional time periods when the business is open or the service is available.
|
|
1310
|
+
*
|
|
1311
|
+
* __Note:__ Not supported by Wix Bookings.
|
|
1312
|
+
*/
|
|
1313
|
+
businessSchedule?: BusinessSchedule;
|
|
1314
|
+
/** Supported languages of a site and the primary language. */
|
|
1315
|
+
multilingual?: Multilingual;
|
|
1316
|
+
/** Cookie policy the Wix user defined for their site (before the site visitor interacts with/limits it). */
|
|
1317
|
+
consentPolicy?: ConsentPolicy;
|
|
1318
|
+
/**
|
|
1319
|
+
* Supported values: `FITNESS SERVICE`, `RESTAURANT`, `BLOG`, `STORE`, `EVENT`, `UNKNOWN`.
|
|
1320
|
+
*
|
|
1321
|
+
* Site business type.
|
|
1322
|
+
*/
|
|
1323
|
+
businessConfig?: string | null;
|
|
1324
|
+
/** External site URL that uses Wix as its headless business solution. */
|
|
1325
|
+
externalSiteUrl?: string | null;
|
|
1326
|
+
/** Track clicks analytics. */
|
|
1327
|
+
trackClicksAnalytics?: boolean;
|
|
1328
|
+
}
|
|
1329
|
+
export interface Categories {
|
|
1330
|
+
/** Primary site category. */
|
|
1331
|
+
primary?: string;
|
|
1332
|
+
/** Secondary site category. */
|
|
1333
|
+
secondary?: string[];
|
|
1334
|
+
/** Business Term Id */
|
|
1335
|
+
businessTermId?: string | null;
|
|
1336
|
+
}
|
|
1337
|
+
export interface Locale {
|
|
1338
|
+
/** Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. */
|
|
1339
|
+
languageCode?: string;
|
|
1340
|
+
/** Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. */
|
|
1341
|
+
country?: string;
|
|
1342
|
+
}
|
|
1343
|
+
export interface Address {
|
|
1344
|
+
/** Street name. */
|
|
1345
|
+
street?: string;
|
|
1346
|
+
/** City name. */
|
|
1347
|
+
city?: string;
|
|
1348
|
+
/** Two-letter country code in an [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. */
|
|
1349
|
+
country?: string;
|
|
1350
|
+
/** State. */
|
|
1351
|
+
state?: string;
|
|
1352
|
+
/** Zip or postal code. */
|
|
1353
|
+
zip?: string;
|
|
1354
|
+
/** Extra information to be displayed in the address. */
|
|
1355
|
+
hint?: AddressHint;
|
|
1356
|
+
/** Whether this address represents a physical location. */
|
|
1357
|
+
isPhysical?: boolean;
|
|
1358
|
+
/** Google-formatted version of this address. */
|
|
1359
|
+
googleFormattedAddress?: string;
|
|
1360
|
+
/** Street number. */
|
|
1361
|
+
streetNumber?: string;
|
|
1362
|
+
/** Apartment number. */
|
|
1363
|
+
apartmentNumber?: string;
|
|
1364
|
+
/** Geographic coordinates of location. */
|
|
1365
|
+
coordinates?: GeoCoordinates;
|
|
1366
|
+
}
|
|
1367
|
+
/**
|
|
1368
|
+
* Extra information on displayed addresses.
|
|
1369
|
+
* This is used for display purposes. Used to add additional data about the address, such as "In the passage".
|
|
1370
|
+
* Free text. In addition, the user can state where to display the additional description - before, after, or instead of the address string.
|
|
1371
|
+
*/
|
|
1372
|
+
export interface AddressHint {
|
|
1373
|
+
/** Extra text displayed next to, or instead of, the actual address. */
|
|
1374
|
+
text?: string;
|
|
1375
|
+
/** Where the extra text should be displayed. */
|
|
1376
|
+
placement?: PlacementType;
|
|
1377
|
+
}
|
|
1378
|
+
/** Where the extra text should be displayed: before, after or instead of the actual address. */
|
|
1379
|
+
export declare enum PlacementType {
|
|
1380
|
+
BEFORE = "BEFORE",
|
|
1381
|
+
AFTER = "AFTER",
|
|
1382
|
+
REPLACE = "REPLACE"
|
|
1383
|
+
}
|
|
1384
|
+
/** Geocoordinates for a particular address. */
|
|
1385
|
+
export interface GeoCoordinates {
|
|
1386
|
+
/** Latitude of the location. Must be between -90 and 90. */
|
|
1387
|
+
latitude?: number;
|
|
1388
|
+
/** Longitude of the location. Must be between -180 and 180. */
|
|
1389
|
+
longitude?: number;
|
|
1390
|
+
}
|
|
1391
|
+
/** Business schedule. Regular and exceptional time periods when the business is open or the service is available. */
|
|
1392
|
+
export interface BusinessSchedule {
|
|
1393
|
+
/** Weekly recurring time periods when the business is regularly open or the service is available. Limited to 100 time periods. */
|
|
1394
|
+
periods?: TimePeriod[];
|
|
1395
|
+
/** Exceptions to the business's regular hours. The business can be open or closed during the exception. */
|
|
1396
|
+
specialHourPeriod?: SpecialHourPeriod[];
|
|
1397
|
+
}
|
|
1398
|
+
/** Weekly recurring time periods when the business is regularly open or the service is available. */
|
|
1399
|
+
export interface TimePeriod {
|
|
1400
|
+
/** Day of the week the period starts on. */
|
|
1401
|
+
openDay?: DayOfWeek;
|
|
1402
|
+
/**
|
|
1403
|
+
* 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
|
|
1404
|
+
* midnight at the end of the specified day.
|
|
1405
|
+
*/
|
|
1406
|
+
openTime?: string;
|
|
1407
|
+
/** Day of the week the period ends on. */
|
|
1408
|
+
closeDay?: DayOfWeek;
|
|
1409
|
+
/**
|
|
1410
|
+
* 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
|
|
1411
|
+
* midnight at the end of the specified day.
|
|
1412
|
+
*
|
|
1413
|
+
* __Note:__ If `openDay` and `closeDay` specify the same day of the week `closeTime` must be later than `openTime`.
|
|
1414
|
+
*/
|
|
1415
|
+
closeTime?: string;
|
|
1416
|
+
}
|
|
1417
|
+
/** Enumerates the days of the week. */
|
|
1418
|
+
export declare enum DayOfWeek {
|
|
1419
|
+
MONDAY = "MONDAY",
|
|
1420
|
+
TUESDAY = "TUESDAY",
|
|
1421
|
+
WEDNESDAY = "WEDNESDAY",
|
|
1422
|
+
THURSDAY = "THURSDAY",
|
|
1423
|
+
FRIDAY = "FRIDAY",
|
|
1424
|
+
SATURDAY = "SATURDAY",
|
|
1425
|
+
SUNDAY = "SUNDAY"
|
|
1426
|
+
}
|
|
1427
|
+
/** Exception to the business's regular hours. The business can be open or closed during the exception. */
|
|
1428
|
+
export interface SpecialHourPeriod {
|
|
1429
|
+
/** 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). */
|
|
1430
|
+
startDate?: string;
|
|
1431
|
+
/** 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). */
|
|
1432
|
+
endDate?: string;
|
|
1433
|
+
/**
|
|
1434
|
+
* Whether the business is closed (or the service is not available) during the exception.
|
|
1435
|
+
*
|
|
1436
|
+
* Default: `true`.
|
|
1437
|
+
*/
|
|
1438
|
+
isClosed?: boolean;
|
|
1439
|
+
/** Additional info about the exception. For example, "We close earlier on New Year's Eve." */
|
|
1440
|
+
comment?: string;
|
|
1441
|
+
}
|
|
1442
|
+
export interface Multilingual {
|
|
1443
|
+
/** Supported languages list. */
|
|
1444
|
+
supportedLanguages?: SupportedLanguage[];
|
|
1445
|
+
/** Whether to redirect to user language. */
|
|
1446
|
+
autoRedirect?: boolean;
|
|
1447
|
+
}
|
|
1448
|
+
export interface SupportedLanguage {
|
|
1449
|
+
/** Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. */
|
|
1450
|
+
languageCode?: string;
|
|
1451
|
+
/** Locale. */
|
|
1452
|
+
locale?: Locale;
|
|
1453
|
+
/** Whether the supported language is the primary language for the site. */
|
|
1454
|
+
isPrimary?: boolean;
|
|
1455
|
+
/** Language icon. */
|
|
1456
|
+
countryCode?: string;
|
|
1457
|
+
/** How the language will be resolved. For internal use. */
|
|
1458
|
+
resolutionMethod?: ResolutionMethod;
|
|
1459
|
+
}
|
|
1460
|
+
export declare enum ResolutionMethod {
|
|
1461
|
+
QUERY_PARAM = "QUERY_PARAM",
|
|
1462
|
+
SUBDOMAIN = "SUBDOMAIN",
|
|
1463
|
+
SUBDIRECTORY = "SUBDIRECTORY"
|
|
1464
|
+
}
|
|
1465
|
+
export interface ConsentPolicy {
|
|
1466
|
+
/** Whether the site uses cookies that are essential to site operation. Always `true`. */
|
|
1467
|
+
essential?: boolean | null;
|
|
1468
|
+
/** Whether the site uses cookies that affect site performance and other functional measurements. */
|
|
1469
|
+
functional?: boolean | null;
|
|
1470
|
+
/** Whether the site uses cookies that collect analytics about how the site is used (in order to improve it). */
|
|
1471
|
+
analytics?: boolean | null;
|
|
1472
|
+
/** Whether the site uses cookies that collect information allowing better customization of the experience for a current visitor. */
|
|
1473
|
+
advertising?: boolean | null;
|
|
1474
|
+
/** CCPA compliance flag. */
|
|
1475
|
+
dataToThirdParty?: boolean | null;
|
|
1476
|
+
}
|
|
1477
|
+
/** A single mapping from the MetaSite ID to a particular service. */
|
|
1478
|
+
export interface Translation {
|
|
1479
|
+
/** The service type. */
|
|
1480
|
+
serviceType?: string;
|
|
1481
|
+
/** The application definition ID; this only applies to services of type ThirdPartyApps. */
|
|
1482
|
+
appDefId?: string;
|
|
1483
|
+
/** The instance ID of the service. */
|
|
1484
|
+
instanceId?: string;
|
|
1485
|
+
}
|
|
1486
|
+
export interface ChangeContext extends ChangeContextPayloadOneOf {
|
|
1487
|
+
/** Properties were updated. */
|
|
1488
|
+
propertiesChange?: PropertiesChange;
|
|
1489
|
+
/** Default properties were created on site creation. */
|
|
1490
|
+
siteCreated?: SiteCreated;
|
|
1491
|
+
/** Properties were cloned on site cloning. */
|
|
1492
|
+
siteCloned?: SiteCloned;
|
|
1493
|
+
}
|
|
1494
|
+
/** @oneof */
|
|
1495
|
+
export interface ChangeContextPayloadOneOf {
|
|
1496
|
+
/** Properties were updated. */
|
|
1497
|
+
propertiesChange?: PropertiesChange;
|
|
1498
|
+
/** Default properties were created on site creation. */
|
|
1499
|
+
siteCreated?: SiteCreated;
|
|
1500
|
+
/** Properties were cloned on site cloning. */
|
|
1501
|
+
siteCloned?: SiteCloned;
|
|
1502
|
+
}
|
|
1503
|
+
export interface PropertiesChange {
|
|
1504
|
+
}
|
|
1505
|
+
export interface SiteCreated {
|
|
1506
|
+
/** Origin template site id. */
|
|
1507
|
+
originTemplateId?: string | null;
|
|
1508
|
+
}
|
|
1509
|
+
export interface SiteCloned {
|
|
1510
|
+
/** Origin site id. */
|
|
1511
|
+
originMetaSiteId?: string;
|
|
1512
|
+
}
|
|
1513
|
+
export interface Empty {
|
|
1514
|
+
}
|
|
1515
|
+
export interface ListEventsByContactIdRequest {
|
|
1516
|
+
/**
|
|
1517
|
+
* ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
|
|
1518
|
+
* to retrieve events for. Required, unless you provide `cursorPaging`.
|
|
1519
|
+
*/
|
|
1520
|
+
contactId: string | null;
|
|
1521
|
+
/**
|
|
1522
|
+
* Local start date and time from which events are returned in
|
|
1523
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
1524
|
+
* `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
|
|
1525
|
+
*
|
|
1526
|
+
* Events that start before the `fromLocalDate` but end after it are included in
|
|
1527
|
+
* the results. Must be earlier than `toLocalDate`.
|
|
1528
|
+
*/
|
|
1529
|
+
fromLocalDate?: string | null;
|
|
1530
|
+
/**
|
|
1531
|
+
* Local end date and time up to which events are returned in
|
|
1532
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
1533
|
+
* `2024-01-30T13:30:00`. Can't be more than a full year after
|
|
1534
|
+
* `2024-01-30T13:30:00`. Required if `cursorPaging` isn't provided.
|
|
1535
|
+
*
|
|
1536
|
+
* Events that start before `toLocalDate` but end after it are included in the
|
|
1537
|
+
* results. Must be later than `fromLocalDate`.
|
|
1538
|
+
*/
|
|
1539
|
+
toLocalDate?: string | null;
|
|
1540
|
+
/**
|
|
1541
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1542
|
+
* for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
|
|
1543
|
+
* `adjustedEnd`. For example, `America/New_York` or `UTC`.
|
|
1544
|
+
*
|
|
1545
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1546
|
+
*/
|
|
1547
|
+
timeZone?: string | null;
|
|
1548
|
+
/**
|
|
1549
|
+
* [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
|
|
1550
|
+
* to filter events by.
|
|
1551
|
+
*/
|
|
1552
|
+
appId?: string | null;
|
|
1553
|
+
/** Cursor to retrieve the next page of the results. */
|
|
1554
|
+
cursorPaging?: CommonCursorPaging;
|
|
1555
|
+
}
|
|
1556
|
+
/** TODO Diverge */
|
|
1557
|
+
export interface CommonCursorPaging {
|
|
1558
|
+
/**
|
|
1559
|
+
* Number of events to return.
|
|
1560
|
+
* Defaults to `50`. Maximum `100`.
|
|
1561
|
+
*/
|
|
1562
|
+
limit?: number | null;
|
|
1563
|
+
/**
|
|
1564
|
+
* Pointer to the next or previous page in the list of results.
|
|
1565
|
+
*
|
|
1566
|
+
* You can get the relevant cursor token
|
|
1567
|
+
* from the `pagingMetadata` object in the previous call's response.
|
|
1568
|
+
* Not relevant for the first request.
|
|
1569
|
+
*/
|
|
1570
|
+
cursor?: string | null;
|
|
1571
|
+
}
|
|
1572
|
+
export interface ListEventsByContactIdResponse {
|
|
1573
|
+
/** Retrieved events. */
|
|
1574
|
+
events?: Event[];
|
|
1575
|
+
/** Paging metadata. */
|
|
1576
|
+
pagingMetadata?: CommonCursorPagingMetadata;
|
|
1577
|
+
}
|
|
1578
|
+
/** TODO Diverge */
|
|
1579
|
+
export interface CommonCursorPagingMetadata {
|
|
1580
|
+
/** Number of items returned in the response. */
|
|
1581
|
+
count?: number | null;
|
|
1582
|
+
/** 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). */
|
|
1583
|
+
cursors?: CommonCursors;
|
|
1584
|
+
/**
|
|
1585
|
+
* Indicates if there are more results after the current page.
|
|
1586
|
+
* If `true`, another page of results can be retrieved.
|
|
1587
|
+
* If `false`, this is the last page.
|
|
1588
|
+
*/
|
|
1589
|
+
hasNext?: boolean | null;
|
|
1590
|
+
}
|
|
1591
|
+
export interface CommonCursors {
|
|
1592
|
+
/** Cursor pointing to next page in the list of results. */
|
|
1593
|
+
next?: string | null;
|
|
1594
|
+
}
|
|
1595
|
+
export interface ListEventsByMemberIdRequest {
|
|
1596
|
+
/**
|
|
1597
|
+
* ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
|
|
1598
|
+
* to retrieve events for. Required, unless you provide `cursorPaging`.
|
|
1599
|
+
* Provide `me` to retrieve events for the currently logged-in member.
|
|
1600
|
+
* You must have the `Read Calendars - Including PI`
|
|
1601
|
+
* [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
|
|
1602
|
+
* to retrieve events for members who aren't the currently logged in member.
|
|
1603
|
+
*/
|
|
1604
|
+
memberId: string | null;
|
|
1605
|
+
/**
|
|
1606
|
+
* Local start date and time from which events are returned in
|
|
1607
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
1608
|
+
* `2024-01-30T13:30:00`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
|
|
1609
|
+
*
|
|
1610
|
+
* Events that start before the `fromLocalDate` but end after it are included in
|
|
1611
|
+
* the results. Must be earlier than `toLocalDate`.
|
|
1612
|
+
*/
|
|
1613
|
+
fromLocalDate?: string | null;
|
|
1614
|
+
/**
|
|
1615
|
+
* Local end date and time up to which events are returned in
|
|
1616
|
+
* [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
|
|
1617
|
+
* `2024-01-30T13:30:00`. Can't be more than a full year after
|
|
1618
|
+
* `fromLocalDate`. Required if neither `cursorPaging` is provided nor a non-empty `eventIds` array.
|
|
1619
|
+
*
|
|
1620
|
+
* Events that start before `toLocalDate` but end after it are included in the
|
|
1621
|
+
* results. Must be later than `fromLocalDate`.
|
|
1622
|
+
*/
|
|
1623
|
+
toLocalDate?: string | null;
|
|
1624
|
+
/**
|
|
1625
|
+
* Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
|
|
1626
|
+
* for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
|
|
1627
|
+
* `adjustedEnd`. For example, `America/New_York` or `UTC`.
|
|
1628
|
+
*
|
|
1629
|
+
* Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
|
|
1630
|
+
*/
|
|
1631
|
+
timeZone?: string | null;
|
|
1632
|
+
/**
|
|
1633
|
+
* [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
|
|
1634
|
+
* to filter events by.
|
|
1635
|
+
*/
|
|
1636
|
+
appId?: string | null;
|
|
1637
|
+
/** Cursor to retrieve the next page of the results. */
|
|
1638
|
+
cursorPaging?: CommonCursorPaging;
|
|
1639
|
+
/**
|
|
1640
|
+
* IDs of the events to retrieve.
|
|
1641
|
+
* If you provide a list of IDs, all other filters are ignored.
|
|
1642
|
+
*
|
|
1643
|
+
* Max: 100 `eventId`s
|
|
1644
|
+
*/
|
|
1645
|
+
eventIds?: string[];
|
|
1646
|
+
}
|
|
1647
|
+
export interface ListEventsByMemberIdResponse {
|
|
1648
|
+
/** Retrieved events. */
|
|
1649
|
+
events?: Event[];
|
|
1650
|
+
/** Paging metadata. */
|
|
1651
|
+
pagingMetadata?: CommonCursorPagingMetadata;
|
|
1652
|
+
}
|
|
1653
|
+
interface RecurrenceRuleNonNullableFields {
|
|
1654
|
+
frequency: Frequency;
|
|
1655
|
+
days: Day[];
|
|
1656
|
+
}
|
|
1657
|
+
interface LocationNonNullableFields {
|
|
1658
|
+
type: LocationType;
|
|
1659
|
+
}
|
|
1660
|
+
interface ResourceNonNullableFields {
|
|
1661
|
+
transparency: Transparency;
|
|
1662
|
+
permissionRole: Role;
|
|
1663
|
+
}
|
|
1664
|
+
interface ParticipantsNonNullableFields {
|
|
1665
|
+
status: ParticipantsStatus;
|
|
1666
|
+
}
|
|
1667
|
+
interface ConferencingDetailsNonNullableFields {
|
|
1668
|
+
type: Type;
|
|
1669
|
+
}
|
|
1670
|
+
interface CommonIdentificationDataNonNullableFields {
|
|
1671
|
+
wixUserId: string;
|
|
1672
|
+
identityType: IdentityType;
|
|
1673
|
+
}
|
|
1674
|
+
interface PermissionNonNullableFields {
|
|
1675
|
+
identity?: CommonIdentificationDataNonNullableFields;
|
|
1676
|
+
role: Role;
|
|
1677
|
+
}
|
|
1678
|
+
interface EventNonNullableFields {
|
|
1679
|
+
status: Status;
|
|
1680
|
+
recurrenceType: RecurrenceType;
|
|
1681
|
+
recurrenceRule?: RecurrenceRuleNonNullableFields;
|
|
1682
|
+
transparency: Transparency;
|
|
1683
|
+
location?: LocationNonNullableFields;
|
|
1684
|
+
resources: ResourceNonNullableFields[];
|
|
1685
|
+
participants?: ParticipantsNonNullableFields;
|
|
1686
|
+
conferencingDetails?: ConferencingDetailsNonNullableFields;
|
|
1687
|
+
inheritedFields: Field[];
|
|
1688
|
+
permissions: PermissionNonNullableFields[];
|
|
1689
|
+
}
|
|
1690
|
+
export interface GetEventResponseNonNullableFields {
|
|
1691
|
+
event?: EventNonNullableFields;
|
|
1692
|
+
}
|
|
1693
|
+
export interface ListEventsResponseNonNullableFields {
|
|
1694
|
+
events: EventNonNullableFields[];
|
|
1695
|
+
}
|
|
1696
|
+
export interface QueryEventsResponseNonNullableFields {
|
|
1697
|
+
events: EventNonNullableFields[];
|
|
1698
|
+
}
|
|
1699
|
+
export interface CreateEventResponseNonNullableFields {
|
|
1700
|
+
event?: EventNonNullableFields;
|
|
1701
|
+
}
|
|
1702
|
+
interface ApplicationErrorNonNullableFields {
|
|
1703
|
+
code: string;
|
|
1704
|
+
description: string;
|
|
1705
|
+
}
|
|
1706
|
+
interface ItemMetadataNonNullableFields {
|
|
1707
|
+
originalIndex: number;
|
|
1708
|
+
success: boolean;
|
|
1709
|
+
error?: ApplicationErrorNonNullableFields;
|
|
1710
|
+
}
|
|
1711
|
+
interface BulkEventResultNonNullableFields {
|
|
1712
|
+
itemMetadata?: ItemMetadataNonNullableFields;
|
|
1713
|
+
item?: EventNonNullableFields;
|
|
1714
|
+
}
|
|
1715
|
+
interface BulkActionMetadataNonNullableFields {
|
|
1716
|
+
totalSuccesses: number;
|
|
1717
|
+
totalFailures: number;
|
|
1718
|
+
}
|
|
1719
|
+
export interface BulkCreateEventResponseNonNullableFields {
|
|
1720
|
+
results: BulkEventResultNonNullableFields[];
|
|
1721
|
+
bulkActionMetadata?: BulkActionMetadataNonNullableFields;
|
|
1722
|
+
}
|
|
1723
|
+
export interface UpdateEventResponseNonNullableFields {
|
|
1724
|
+
event?: EventNonNullableFields;
|
|
1725
|
+
}
|
|
1726
|
+
export interface BulkUpdateEventResponseNonNullableFields {
|
|
1727
|
+
results: BulkEventResultNonNullableFields[];
|
|
1728
|
+
bulkActionMetadata?: BulkActionMetadataNonNullableFields;
|
|
1729
|
+
}
|
|
1730
|
+
export interface RestoreEventDefaultsResponseNonNullableFields {
|
|
1731
|
+
event?: EventNonNullableFields;
|
|
1732
|
+
}
|
|
1733
|
+
export interface SplitRecurringEventResponseNonNullableFields {
|
|
1734
|
+
updatedRecurringEventEndingBeforeSplit?: EventNonNullableFields;
|
|
1735
|
+
newRecurringEventStartingFromSplit?: EventNonNullableFields;
|
|
1736
|
+
}
|
|
1737
|
+
export interface CancelEventResponseNonNullableFields {
|
|
1738
|
+
event?: EventNonNullableFields;
|
|
1739
|
+
}
|
|
1740
|
+
export interface BulkCancelEventResponseNonNullableFields {
|
|
1741
|
+
results: BulkEventResultNonNullableFields[];
|
|
1742
|
+
bulkActionMetadata?: BulkActionMetadataNonNullableFields;
|
|
1743
|
+
}
|
|
1744
|
+
export interface ListEventsByContactIdResponseNonNullableFields {
|
|
1745
|
+
events: EventNonNullableFields[];
|
|
1746
|
+
}
|
|
1747
|
+
export interface ListEventsByMemberIdResponseNonNullableFields {
|
|
1748
|
+
events: EventNonNullableFields[];
|
|
1749
|
+
}
|
|
1750
|
+
export {};
|