@wix/calendar 1.0.27 → 1.0.28

package/type-bundles/context.bundle.d.ts

@@ -476,198 +476,229 @@ type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
 } ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
+/**
+ * An event is a scheduled entry on a calendar that includes details like timing,
+ * location, and participants. Each event is associated with
+ * a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
+ * from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
+ * Events can either be standalone, part of a recurring series, or define a
+ * recurrence pattern. You can also specify whether events block time on the
+ * schedule or allow other events to be scheduled concurrently.
+ */
 interface Event$1 {
     /**
-     * The event ID.
+     * Event ID.
      * @readonly
      */
     _id?: string | null;
     /**
-     * The ID of the schedule that the event belongs to.
-     * Cannot change.
+     * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * the event belongs to.
+     * After creating an event, you can't assign it to a different schedule.
      */
     scheduleId?: string | null;
     /**
-     * The external schedule ID.
+     * ID of the external schedule the event belongs to.
      * @readonly
      */
     externalScheduleId?: string | null;
     /**
-     * The schedule name.
+     * Schedule name.
      * @readonly
      */
     scheduleName?: string | null;
     /**
-     * The event type.
-     * Cannot change.
+     * Event type. You can't update the event type.
      *
-     * The possible values are:
-     * - `"DEFAULT"` Default event.
-     * - `"WORKING_HOURS"` The event represents a resource working hours. Working hours events are hidden by default from queries.
-     *
-     * The Wix Bookings App, once installed, also provides the following:
-     * - `"APPOINTMENT"` Bookings Appointment event.
-     * - `"CLASS"` Bookings Class event.
-     * - `"COURSE"` Bookings Course event.
+     * Supported values:
+     * + `DEFAULT`: A standard event that's not further specified.
+     * + `WORKING_HOURS`: Working hours event. By default not returned in [Query Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/query-events).
      *
-     * See the [Event Type Provider](https://dev.wix.com/docs/rest/internal-only/calendar/event-type-provider-v3/introduction) for more details.
+     * Additional supported values, if Wix Bookings is installed:
+     * + `APPOINTMENT`: Bookings appointment event.
+     * + `CLASS`: Bookings class event.
+     * + `COURSE`: Bookings course event.
      */
     type?: string | null;
     /**
-     * The event status. Read only.
+     * Event status.
      *
-     * The possible values are:
-     * - `"CONFIRMED"` Event is confirmed. Default value.
-     * - `"CANCELLED"` Event has been cancelled.
+     * Supported values:
+     * + `CONFIRMED`: Event is scheduled to happen or has happened.
+     * + `CANCELLED`: Event has been canceled.
+     *
+     * Default: `CONFIRMED`
      * @readonly
      */
     status?: Status$4;
     /**
-     * The event title.
+     * Event title.
      *
-     * The title is inherited from the schedule and can be overridden.
+     * Min: 1 character
+     * Max: 200 characters
      */
     title?: string | null;
-    /**
-     * The event start date.
-     *
-     * Recurring events must start from at least today.
-     */
+    /** Information about when the event starts. */
     start?: ZonedDate$2;
-    /** The event end date. */
+    /** Information about when the event ends. */
     end?: ZonedDate$2;
     /**
-     * Read-only start date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event starts adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedStart?: ZonedDate$2;
     /**
-     * Read-only end date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event ends adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedEnd?: ZonedDate$2;
     /**
-     * The event time zone, formatted according to the IANA time zone format.
-     * Must be a regional time zone (Area/Location) or UTC.
+     * Time zone the event is associated with in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * Only regional time zones and UTC are supported.
+     * For example, `America/New_York` or `UTC`.
      *
-     * The time zone is inherited from the schedule and can be overridden.
+     * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
      */
     timeZone?: string | null;
     /**
-     * Whether this event is a recurring event or an instance of recurring event.
+     * Information about whether the event is a single occurrence or part of a
+     * recurring series.
      *
-     * The possible values are:
-     * - `"NONE"` No recurrence, i.e the event is a single event instance. Default.
-     * - `"MASTER"` The event is the recurrence master defining the recurrence rule, which is the repeat pattern for the events.
-     * - `"INSTANCE"` The event is an instance of a recurring event. Read only.
-     * - `"EXCEPTION"` The event is an exceptional instance of a recurring event. Read only.
+     * Supported values:
+     * + `NONE`: The event occurs only once and doesn't repeat.
+     * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
+     * + `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`.
+     * + `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.
+     *
+     * Default: `NONE`
      * @readonly
      */
     recurrenceType?: RecurrenceType$1;
     /**
-     * The recurrence rule defining a repeating pattern for the event.
-     * Required for `MASTER` recurrence, read only otherwise.
-     *
-     * For example, a event that repeats every second week on a Monday until January 7, 2024 at 8 AM, will have the following recurrence:
+     * Recurrence pattern for a series of events. This field is required when
+     * creating a `MASTER` event and isn't available for non-recurring events.
+     * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
+     * For example, an event that repeats every second Monday until January 7, 2026,
+     * at 8:00 AM has the following `recurrenceRule`:
      * - `frequency = WEEKLY`
      * - `interval = 2`
      * - `days = [MONDAY]`
-     * - `until = 20240107T08:00:00Z`
+     * - `until = 20260107T08:00:00Z`
      */
     recurrenceRule?: RecurrenceRule$1;
     /**
-     * The ID of the recurring event that this event belongs to, if this event is an instance of recurring event.
+     * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
+     * and `EXCEPTION` events.
      * @readonly
      */
     recurringEventId?: string | null;
     /**
-     * Specifies whether the event blocks the schedule time.
-     * Default is true.
+     * Specifies whether the event blocks time in the schedule it belongs to.
+     *
+     * Supported values:
+     * + `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.
+     * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
+     *
+     * Default: `TRANSPARENT`
      */
     transparency?: Transparency$1;
     /**
-     * The event location.
+     * Event location.
      *
-     * The location is inherited from the schedule and can be overridden.
+     * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     location?: Location$2;
     /**
-     * List of resources affected by the event.
+     * List of [Wix Bookings resources](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object)
+     * affected by the event. This could include ,for example, the
+     * [Wix Bookings staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/staff-member-object)
+     * providing the service or the room where the appointment takes place.
      *
-     * For example:
-     * - Event occupying a resource time, such as a room, equipment or person.
-     * - The Bookings App Staff is affected by the Booking Class Sessions it provides.
+     * Max: 100 resources
      */
     resources?: Resource$1[];
     /**
-     * The event capacity, which is the max number of participants that can participate in the event.
+     * Maximum number of participants who can participate in the event.
      *
-     * The total capacity is inherited from the schedule and can be overridden.
+     * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     totalCapacity?: number | null;
     /**
-     * The remaining number of participants that can be added to the event.
+     * Number of participants who can still be added to the event.
      * @readonly
      */
     remainingCapacity?: number | null;
     /**
-     * The event participants.
+     * Information about the event's participants.
      * @readonly
      */
     participants?: Participants$1;
     /**
-     * Online conferencing details.
+     * Information about the event's online conferencing
      *
-     * The conferencing details are inherited from the schedule and can be overridden.
+     * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     conferencingDetails?: ConferencingDetails$2;
-    /** Additional notes and information about the event. */
+    /**
+     * Additional notes about the event.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     notes?: string | null;
     /**
-     * A list of fields for which values were inherited from the schedule or the recurring event,
-     * if this event is an instance of recurring event.
+     * List of fields whose values are inherited.
+     * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
+     * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related the `MASTER` event.
      * @readonly
      */
     inheritedFields?: Field$1[];
     /**
-     * ID of the Wix app owning the event, as derived from the schedule.
+     * ID of the app that owns the event. Identical to `appId` of the
+     * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * to which the event belongs.
      * @readonly
      */
     appId?: string | null;
     /**
-     * List of granted permissions for this event.
-     *
-     * Derived from the schedule and the resources of the the event.
+     * List of permissions associated with the event. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
      * @readonly
      */
     permissions?: Permission$2[];
     /** Extensions enabling applications or users to save custom data related to the event. */
     extendedFields?: ExtendedFields$3;
     /**
-     * The event revision number, which incremented on updates.
-     *
-     * The current revision should be provided on updates to prevent conflicting changes.
+     * Revision number, which increments each time the event is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the event.
+     * Ignored when creating an event.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date the event was created.
+     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the event was last updated.
+     * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
 }
 declare enum Status$4 {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
-    /** Event is confirmed. Default value. */
+    /** Event is scheduled to happen or has happened. */
     CONFIRMED = "CONFIRMED",
     /** DEPRECATED! AND WILL BE REMOVED SOON */
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION",
-    /** Event has been cancelled. */
+    /** Event has been canceled. */
     CANCELLED = "CANCELLED"
 }
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
@@ -742,9 +773,9 @@ declare enum Day$1 {
 }
 declare enum Transparency$1 {
     UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
-    /** The event block time. Default. */
+    /** 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. */
     OPAQUE = "OPAQUE",
-    /** The event does not block the time. */
+    /** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
     TRANSPARENT = "TRANSPARENT"
 }
 interface Location$2 {
@@ -861,21 +892,21 @@ declare enum Type$2 {
 }
 declare enum Field$1 {
     UNKNOWN_FIELD = "UNKNOWN_FIELD",
-    /** The title is inherited from the schedule or the recurring event. */
+    /** `title` is inherited from the schedule or `MASTER` event. */
     TITLE = "TITLE",
-    /** The time zone is inherited from the schedule or the recurring event. */
+    /** `timeZone` is inherited from the schedule or `MASTER` event. */
     TIME_ZONE = "TIME_ZONE",
-    /** The time is inherited from the recurring event. */
+    /** `start` and `end` are inherited from the `MASTER` event. */
     TIME = "TIME",
-    /** The location is inherited from the schedule or the recurring event. */
+    /** `location` is inherited from the schedule or `MASTER` event. */
     LOCATION = "LOCATION",
-    /** The resources are inherited from the recurring event. */
+    /** `resources` is inherited from the `MASTER` event. */
     RESOURCES = "RESOURCES",
-    /** The capacity is inherited from the schedule or the recurring event. */
+    /** `capacity` is inherited from the schedule or `MASTER` event. */
     CAPACITY = "CAPACITY",
-    /** The participants are inherited from the recurring event. */
+    /** `participants` is inherited from the `MASTER` event. */
     PARTICIPANTS = "PARTICIPANTS",
-    /** The conferencing details are inherited from the schedule or the recurring event. */
+    /** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
     CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
 }
 interface Permission$2 {
@@ -891,12 +922,18 @@ interface Permission$2 {
     role?: Role$2;
 }
 interface CommonIdentificationData$2 extends CommonIdentificationDataIdOneOf$2 {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 /** @oneof */
 interface CommonIdentificationDataIdOneOf$2 {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 declare enum IdentityType$2 {
@@ -926,79 +963,123 @@ interface DeleteTargetsRequest {
 interface DeleteTargetsResponse {
 }
 interface GetEventRequest {
-    /** The ID of the event to retrieve. Required. */
+    /**
+     * ID of the event to retrieve.
+     *
+     * Min: 36 characters
+     * Max: 250 characters
+     */
     eventId: string | null;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields$1[];
 }
 declare enum RequestedFields$1 {
     UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
-    /**
-     * Include fields containing personal information.
-     * Requires the `CALENDAR.EVENT_READ_PI` additional permission.
-     */
+    /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
     PI_FIELDS = "PI_FIELDS",
-    /**
-     * Include fields containing personal information for events the current caller has access to.
-     * See `event.permissions` for more details.
-     */
+    /** Returns only fields containing your own personal data. */
     OWN_PI_FIELDS = "OWN_PI_FIELDS"
 }
 interface GetEventResponse {
-    /** The event. */
+    /** Retrieved event. */
     event?: Event$1;
 }
 interface ListEventsRequest {
-    /** The IDs of the events to retrieve. */
-    eventIds: string[];
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * IDs of the events to retrieve.
+     *
+     * Min: 1 event ID
+     * Min: 100 event IDs
      */
+    eventIds: string[];
     timeZone?: string | null;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields$1[];
 }
 interface ListEventsResponse {
-    /** The events matching the provided IDs. */
+    /** Retrieved events matching the provided IDs. */
     events?: Event$1[];
 }
 interface QueryEventsRequest {
     /**
-     * Local start date for which events are returned, in ISO-8601 format. Optional.
-     * E.g, "2024-01-30T13:30:00".
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Events that begin before the `fromLocalDate` but end after it are included in the results.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate` unless the sort order is
+     * descending.
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which events are returned, in ISO-8601 format. Optional.
-     * E.g, "2024-01-30T14:30:00".
-     *
-     * Events that begin before the `toLocalDate` but end after it are included in the results.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * `toLocalDate` must be after `fromLocalDate` unless the sort order is `DESCENDING`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate` unless the sort order is
+     * descending.
      */
     toLocalDate?: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
     /** Query containing filters and paging. */
     query?: CursorQuery$2;
     /**
-     * Optional recurrence filter.
+     * Filters events based on their `recurrenceType`.
      *
-     * By default only single event instances and instances of recurring events are returned.
+     * Max: 5 recurrence types can be specified.
+     * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
      */
     recurrenceType?: RecurrenceType$1[];
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields$1[];
 }
 /** TODO Diverge */
@@ -1058,7 +1139,7 @@ interface CursorPaging$2 {
     cursor?: string | null;
 }
 interface QueryEventsResponse {
-    /** The events matching the provided query. */
+    /** Retrieved events matching the provided query. */
     events?: Event$1[];
     /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata$2;
@@ -1113,36 +1194,46 @@ interface ListRecurringEventInstancesHistoryResponse {
     pagingMetadata?: CursorPagingMetadata$2;
 }
 interface CreateEventRequest {
-    /** The event to create. */
+    /** Event to create. */
     event: Event$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional idempotency key to guarantee that the event is created at most once if the same request is issued multiple times. */
+    /**
+     * Idempotency key guaranteeing that you don't create the same event more
+     * than once.
+     */
     idempotencyKey?: string | null;
 }
 interface CreateEventResponse {
-    /** The created event. */
+    /** Created event. */
     event?: Event$1;
 }
 interface BulkCreateEventRequest {
-    /** The events to create. */
+    /** Events to create. */
     events: MaskedEvent[];
     /**
-     * Whether to return the created events.
-     * Default is false.
+     * Whether to return created events.
+     *
+     * Default: `false`.
      */
     returnEntity?: boolean | null;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface MaskedEvent {
-    /** The event to create. */
+    /** Event to create. */
     event?: Event$1;
 }
 interface BulkCreateEventResponse {
@@ -1188,13 +1279,19 @@ interface BulkActionMetadata {
     totalFailures?: number;
 }
 interface UpdateEventRequest {
-    /** The event to update. */
+    /** Event to update. */
     event: Event$1;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
@@ -1208,34 +1305,49 @@ interface ParticipantNotification$1 {
     message?: string | null;
 }
 interface UpdateEventResponse {
-    /** The updated event. */
+    /** Updated event. */
     event?: Event$1;
 }
 /** `PRIVATE` until we'll have standard events metadata from Infra. */
 interface EventUpdatedWithMetadata {
     /** The updated event. */
     event?: Event$1;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
 }
 interface BulkUpdateEventRequest {
-    /** The events to update. */
+    /**
+     * Events to update.
+     *
+     * Min: 1 event
+     * Max: 50 events
+     */
     events: BulkUpdateEventRequestMaskedEvent[];
     /**
-     * Whether to return the created events.
-     * Default is false.
+     * Whether to return the updated events.
+     *
+     * Default: `false`
      */
     returnEntity?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface BulkUpdateEventRequestMaskedEvent {
-    /** The event to update. */
+    /** Event to update. */
     event?: Event$1;
 }
 interface BulkUpdateEventResponse {
@@ -1245,51 +1357,75 @@ interface BulkUpdateEventResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface UpdateEventParticipantsRequest {
-    /** The ID of the event. */
+    /**
+     * ID of the event to update.
+     *
+     * Min: 36 characters
+     * Max: 250 characters
+     */
     eventId?: string | null;
     /** The participants to update. */
     participants?: Participants$1;
 }
 interface UpdateEventParticipantsResponse {
-    /** The updated event. */
+    /** Updated event. */
     event?: Event$1;
 }
 interface RestoreEventDefaultsRequest {
-    /** The ID of the event. */
+    /** ID of the event for which to restore default values. */
     eventId: string | null;
-    /** The fields for which to restore default values. */
+    /**
+     * Fields for which to restore default values.
+     *
+     * `TIME` restores default values for `start` and `end`.
+     *
+     * Min: 1 field
+     */
     fields: Field$1[];
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface RestoreEventDefaultsResponse {
-    /** The updated event. */
+    /** Updated event. */
     event?: Event$1;
 }
 interface SplitRecurringEventRequest {
-    /** The ID of the recurring event to split. */
+    /** ID of the `MASTER` event to split. */
     recurringEventId: string | null;
     /**
-     * The ISO-8601 local date where the recurring event is to be split.
-     * Must be a future date.
-     * Must be between two instances of the recurring event.
+     * Local date and time at which the `MASTER` event is split in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2025-03-11T09:00:00`.
+     * Must be a future date that's after the `start` date of the next `INSTANCE` or
+     * `EXCEPTION` event in the series. Additionally, there must be another
+     * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
+     * wouldn't affect any event without a subsequent occurrence.
      */
     splitLocalDate: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface SplitRecurringEventResponse {
-    /** The updated recurring event which set to end in the last instance before the split date. */
+    /** Original `MASTER` event that was shortened. */
     updatedRecurringEventEndingBeforeSplit?: Event$1;
-    /** The new recurring event which set to start from the next instance at or after the split date. */
+    /** New `MASTER` event starting with the first event after the split date. */
     newRecurringEventStartingFromSplit?: Event$1;
 }
 interface RecurringEventSplit {
@@ -1299,18 +1435,24 @@ interface RecurringEventSplit {
     newRecurringEventStartingFromSplit?: Event$1;
 }
 interface CancelEventRequest {
-    /** The ID of the event to cancel. */
+    /** ID of the event to cancel. */
     eventId: string | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the canceled event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface CancelEventResponse {
-    /** The cancelled event. */
+    /** Canceled event. */
     event?: Event$1;
 }
 interface EventCancelled {
@@ -1318,18 +1460,25 @@ interface EventCancelled {
     event?: Event$1;
 }
 interface BulkCancelEventRequest {
-    /** The IDs of the events to cancel. */
+    /** IDs of the events to cancel. */
     eventIds: string[];
     /**
-     * Whether to return the cancelled events.
-     * Default is false.
+     * Whether to return the canceled events.
+     *
+     * Default: `false`
      */
     returnEntity?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the canceled events are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
@@ -1987,51 +2136,91 @@ interface EventCancelledEnvelope {
 }
 interface GetEventOptions {
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields$1[];
 }
 interface ListEventsOptions {
+    timeZone?: string | null;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
      */
-    timeZone?: string | null;
-    /** List of additional fields to be included in the response. */
     fields?: RequestedFields$1[];
 }
 interface QueryEventsOptions {
     /**
-     * Local start date for which events are returned, in ISO-8601 format. Optional.
-     * E.g, "2024-01-30T13:30:00".
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Events that begin before the `fromLocalDate` but end after it are included in the results.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate` unless the sort order is
+     * descending.
      */
     fromLocalDate?: string | null | undefined;
     /**
-     * Local end date for which events are returned, in ISO-8601 format. Optional.
-     * E.g, "2024-01-30T14:30:00".
-     *
-     * Events that begin before the `toLocalDate` but end after it are included in the results.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * `toLocalDate` must be after `fromLocalDate` unless the sort order is `DESCENDING`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate` unless the sort order is
+     * descending.
      */
     toLocalDate?: string | null | undefined;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null | undefined;
     /**
-     * Optional recurrence filter.
+     * Filters events based on their `recurrenceType`.
      *
-     * By default only single event instances and instances of recurring events are returned.
+     * Max: 5 recurrence types can be specified.
+     * Default: Events with `recurrenceType` of `NONE`, `INSTANCE`, and `EXCEPTION` are returned.
      */
     recurrenceType?: RecurrenceType$1[] | undefined;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields$1[] | undefined;
 }
 interface QueryCursorResult$2 {
@@ -2095,269 +2284,336 @@ interface EventsQueryBuilder {
 }
 interface CreateEventOptions {
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional idempotency key to guarantee that the event is created at most once if the same request is issued multiple times. */
+    /**
+     * Idempotency key guaranteeing that you don't create the same event more
+     * than once.
+     */
     idempotencyKey?: string | null;
 }
 interface BulkCreateEventOptions {
     /**
-     * Whether to return the created events.
-     * Default is false.
+     * Whether to return created events.
+     *
+     * Default: `false`.
      */
     returnEntity?: boolean | null;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface UpdateEvent {
     /**
-     * The event ID.
+     * Event ID.
      * @readonly
      */
     _id?: string | null;
     /**
-     * The ID of the schedule that the event belongs to.
-     * Cannot change.
+     * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * the event belongs to.
+     * After creating an event, you can't assign it to a different schedule.
      */
     scheduleId?: string | null;
     /**
-     * The external schedule ID.
+     * ID of the external schedule the event belongs to.
      * @readonly
      */
     externalScheduleId?: string | null;
     /**
-     * The schedule name.
+     * Schedule name.
      * @readonly
      */
     scheduleName?: string | null;
     /**
-     * The event type.
-     * Cannot change.
-     *
-     * The possible values are:
-     * - `"DEFAULT"` Default event.
-     * - `"WORKING_HOURS"` The event represents a resource working hours. Working hours events are hidden by default from queries.
+     * Event type. You can't update the event type.
      *
-     * The Wix Bookings App, once installed, also provides the following:
-     * - `"APPOINTMENT"` Bookings Appointment event.
-     * - `"CLASS"` Bookings Class event.
-     * - `"COURSE"` Bookings Course event.
+     * Supported values:
+     * + `DEFAULT`: A standard event that's not further specified.
+     * + `WORKING_HOURS`: Working hours event. By default not returned in [Query Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/query-events).
      *
-     * See the [Event Type Provider](https://dev.wix.com/docs/rest/internal-only/calendar/event-type-provider-v3/introduction) for more details.
+     * Additional supported values, if Wix Bookings is installed:
+     * + `APPOINTMENT`: Bookings appointment event.
+     * + `CLASS`: Bookings class event.
+     * + `COURSE`: Bookings course event.
      */
     type?: string | null;
     /**
-     * The event status. Read only.
+     * Event status.
      *
-     * The possible values are:
-     * - `"CONFIRMED"` Event is confirmed. Default value.
-     * - `"CANCELLED"` Event has been cancelled.
+     * Supported values:
+     * + `CONFIRMED`: Event is scheduled to happen or has happened.
+     * + `CANCELLED`: Event has been canceled.
+     *
+     * Default: `CONFIRMED`
      * @readonly
      */
     status?: Status$4;
     /**
-     * The event title.
+     * Event title.
      *
-     * The title is inherited from the schedule and can be overridden.
+     * Min: 1 character
+     * Max: 200 characters
      */
     title?: string | null;
-    /**
-     * The event start date.
-     *
-     * Recurring events must start from at least today.
-     */
+    /** Information about when the event starts. */
     start?: ZonedDate$2;
-    /** The event end date. */
+    /** Information about when the event ends. */
     end?: ZonedDate$2;
     /**
-     * Read-only start date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event starts adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedStart?: ZonedDate$2;
     /**
-     * Read-only end date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event ends adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedEnd?: ZonedDate$2;
     /**
-     * The event time zone, formatted according to the IANA time zone format.
-     * Must be a regional time zone (Area/Location) or UTC.
+     * Time zone the event is associated with in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * Only regional time zones and UTC are supported.
+     * For example, `America/New_York` or `UTC`.
      *
-     * The time zone is inherited from the schedule and can be overridden.
+     * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
      */
     timeZone?: string | null;
     /**
-     * Whether this event is a recurring event or an instance of recurring event.
+     * Information about whether the event is a single occurrence or part of a
+     * recurring series.
      *
-     * The possible values are:
-     * - `"NONE"` No recurrence, i.e the event is a single event instance. Default.
-     * - `"MASTER"` The event is the recurrence master defining the recurrence rule, which is the repeat pattern for the events.
-     * - `"INSTANCE"` The event is an instance of a recurring event. Read only.
-     * - `"EXCEPTION"` The event is an exceptional instance of a recurring event. Read only.
+     * Supported values:
+     * + `NONE`: The event occurs only once and doesn't repeat.
+     * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
+     * + `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`.
+     * + `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.
+     *
+     * Default: `NONE`
      * @readonly
      */
     recurrenceType?: RecurrenceType$1;
     /**
-     * The recurrence rule defining a repeating pattern for the event.
-     * Required for `MASTER` recurrence, read only otherwise.
-     *
-     * For example, a event that repeats every second week on a Monday until January 7, 2024 at 8 AM, will have the following recurrence:
+     * Recurrence pattern for a series of events. This field is required when
+     * creating a `MASTER` event and isn't available for non-recurring events.
+     * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
+     * For example, an event that repeats every second Monday until January 7, 2026,
+     * at 8:00 AM has the following `recurrenceRule`:
      * - `frequency = WEEKLY`
      * - `interval = 2`
      * - `days = [MONDAY]`
-     * - `until = 20240107T08:00:00Z`
+     * - `until = 20260107T08:00:00Z`
      */
     recurrenceRule?: RecurrenceRule$1;
     /**
-     * The ID of the recurring event that this event belongs to, if this event is an instance of recurring event.
+     * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
+     * and `EXCEPTION` events.
      * @readonly
      */
     recurringEventId?: string | null;
     /**
-     * Specifies whether the event blocks the schedule time.
-     * Default is true.
+     * Specifies whether the event blocks time in the schedule it belongs to.
+     *
+     * Supported values:
+     * + `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.
+     * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
+     *
+     * Default: `TRANSPARENT`
      */
     transparency?: Transparency$1;
     /**
-     * The event location.
+     * Event location.
      *
-     * The location is inherited from the schedule and can be overridden.
+     * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     location?: Location$2;
     /**
-     * List of resources affected by the event.
+     * List of [Wix Bookings resources](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object)
+     * affected by the event. This could include ,for example, the
+     * [Wix Bookings staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/staff-member-object)
+     * providing the service or the room where the appointment takes place.
      *
-     * For example:
-     * - Event occupying a resource time, such as a room, equipment or person.
-     * - The Bookings App Staff is affected by the Booking Class Sessions it provides.
+     * Max: 100 resources
      */
     resources?: Resource$1[];
     /**
-     * The event capacity, which is the max number of participants that can participate in the event.
+     * Maximum number of participants who can participate in the event.
      *
-     * The total capacity is inherited from the schedule and can be overridden.
+     * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     totalCapacity?: number | null;
     /**
-     * The remaining number of participants that can be added to the event.
+     * Number of participants who can still be added to the event.
      * @readonly
      */
     remainingCapacity?: number | null;
     /**
-     * The event participants.
+     * Information about the event's participants.
      * @readonly
      */
     participants?: Participants$1;
     /**
-     * Online conferencing details.
+     * Information about the event's online conferencing
      *
-     * The conferencing details are inherited from the schedule and can be overridden.
+     * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     conferencingDetails?: ConferencingDetails$2;
-    /** Additional notes and information about the event. */
+    /**
+     * Additional notes about the event.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     notes?: string | null;
     /**
-     * A list of fields for which values were inherited from the schedule or the recurring event,
-     * if this event is an instance of recurring event.
+     * List of fields whose values are inherited.
+     * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
+     * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related the `MASTER` event.
      * @readonly
      */
     inheritedFields?: Field$1[];
     /**
-     * ID of the Wix app owning the event, as derived from the schedule.
+     * ID of the app that owns the event. Identical to `appId` of the
+     * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * to which the event belongs.
      * @readonly
      */
     appId?: string | null;
     /**
-     * List of granted permissions for this event.
-     *
-     * Derived from the schedule and the resources of the the event.
+     * List of permissions associated with the event. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
      * @readonly
      */
     permissions?: Permission$2[];
     /** Extensions enabling applications or users to save custom data related to the event. */
     extendedFields?: ExtendedFields$3;
     /**
-     * The event revision number, which incremented on updates.
-     *
-     * The current revision should be provided on updates to prevent conflicting changes.
+     * Revision number, which increments each time the event is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the event.
+     * Ignored when creating an event.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date the event was created.
+     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the event was last updated.
+     * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
 }
 interface UpdateEventOptions {
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface BulkUpdateEventOptions {
     /**
-     * Whether to return the created events.
-     * Default is false.
+     * Whether to return the updated events.
+     *
+     * Default: `false`
      */
     returnEntity?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface RestoreEventDefaultsOptions {
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the updated event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface SplitRecurringEventOptions {
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface CancelEventOptions {
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the canceled event are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned event time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
 interface BulkCancelEventOptions {
     /**
-     * Whether to return the cancelled events.
-     * Default is false.
+     * Whether to return the canceled events.
+     *
+     * Default: `false`
      */
     returnEntity?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the canceled events are notified and
+     * the message they receive.
+     */
     participantNotification?: ParticipantNotification$1;
     /**
-     * Optional time zone used to adjust the returned events time.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
 }
@@ -2422,9 +2678,12 @@ interface ListEventsByMemberIdOptions {
 declare function getEvent$1(httpClient: HttpClient): GetEventSignature;
 interface GetEventSignature {
     /**
-     * Retrieves an event by ID.
-     * @param - The ID of the event to retrieve. Required.
-     * @returns The event.
+     * Retrieves an event.
+     * @param - ID of the event to retrieve.
+     *
+     * Min: 36 characters
+     * Max: 250 characters
+     * @returns Retrieved event.
      */
     (eventId: string | null, options?: GetEventOptions | undefined): Promise<Event$1 & EventNonNullableFields>;
 }
@@ -2432,17 +2691,35 @@ declare function listEvents$1(httpClient: HttpClient): ListEventsSignature;
 interface ListEventsSignature {
     /**
      * Retrieves a list of events by their IDs.
-     * @param - The IDs of the events to retrieve.
+     * @param - IDs of the events to retrieve.
+     *
+     * Min: 1 event ID
+     * Min: 100 event IDs
      */
     (eventIds: string[], options?: ListEventsOptions | undefined): Promise<ListEventsResponse & ListEventsResponseNonNullableFields>;
 }
 declare function queryEvents$1(httpClient: HttpClient): QueryEventsSignature;
 interface QueryEventsSignature {
     /**
-     * Query events given the provided time range, filters and paging.
+     * Retrieves a list of events, given the provided paging, filtering, and sorting.
+     *
+     *
+     * You can't query by ID, to do so use
+     * [Get Event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/list-events)
+     * or [List Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/list-events)
+     * instead.
+     *
+     * Query Events runs with these defaults, which you can override:
+     * - sorted by `start` in `ASC` order
+     * - `cursorPaging.limit` is `50`
+     *
+     * For field support for filters and sorting,
+     * see [Calendar Events V3: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/supported-filters-and-sorting).
      *
-     * Sort: by default events are sorted by their start date in ascending order. Events can also be sorted by their end date in descending order.
-     * > __Note__ Querying by IDs is not supported, please use the GetEvent or ListEvents APIs instead.
+     * To learn about working with _Query_ endpoints, see
+     * [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language),
+     * [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging),
+     * and [Field Projection](https://dev.wix.com/docs/rest/articles/getting-started/field-projection).
      */
     (options?: QueryEventsOptions | undefined): EventsQueryBuilder;
 }
@@ -2450,8 +2727,20 @@ declare function createEvent$1(httpClient: HttpClient): CreateEventSignature;
 interface CreateEventSignature {
     /**
      * Creates an event.
-     * @param - The event to create.
-     * @returns The created event.
+     *
+     *
+     * 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.
+     *
+     * 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/rest/business-management/calendar/events-v3/update-event)
+     * an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
+     * @param - Event to create.
+     * @returns Created event.
      */
     (event: Event$1, options?: CreateEventOptions | undefined): Promise<Event$1 & EventNonNullableFields>;
 }
@@ -2459,7 +2748,19 @@ declare function bulkCreateEvent$1(httpClient: HttpClient): BulkCreateEventSigna
 interface BulkCreateEventSignature {
     /**
      * Creates multiple events in bulk.
-     * @param - The events to create.
+     *
+     *
+     * 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.
+     *
+     * 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/rest/business-management/calendar/events-v3/update-event)
+     * an `INSTANCE` event, which changes its `recurrenceType` to `EXCEPTION`.
+     * @param - Events to create.
      */
     (events: MaskedEvent[], options?: BulkCreateEventOptions | undefined): Promise<BulkCreateEventResponse & BulkCreateEventResponseNonNullableFields>;
 }
@@ -2467,8 +2768,18 @@ declare function updateEvent$1(httpClient: HttpClient): UpdateEventSignature;
 interface UpdateEventSignature {
     /**
      * Updates an event.
-     * @param - The event ID.
-     * @returns The updated event.
+     *
+     *
+     * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
+     * `recurrenceType` automatically changes to `EXCEPTION`.
+     *
+     * When updating an event with `{"recurrenceType": "MASTER"}`:
+     * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
+     * + For future `INSTANCE` events, all relevant fields are updated.
+     * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
+     * applied, while other fields remain unchanged.
+     * @param - Event ID.
+     * @returns Updated event.
      */
     (_id: string | null, event: UpdateEvent, options?: UpdateEventOptions | undefined): Promise<Event$1 & EventNonNullableFields>;
 }
@@ -2476,36 +2787,82 @@ declare function bulkUpdateEvent$1(httpClient: HttpClient): BulkUpdateEventSigna
 interface BulkUpdateEventSignature {
     /**
      * Updates multiple events in bulk.
-     * @param - The events to update.
+     *
+     *
+     * When updating an event with `{"recurrenceType": "INSTANCE"}`, the
+     * `recurrenceType` automatically changes to `EXCEPTION`.
+     *
+     * When updating an event with `{"recurrenceType": "MASTER"}`:
+     * + Past `INSTANCE` and `EXCEPTION` events remain unchanged.
+     * + For future `INSTANCE` events, all relevant fields are updated.
+     * + For future `EXCEPTION` events, only changes to the `inheritedFields` are
+     * applied, while other fields remain unchanged.
+     * @param - Events to update.
+     *
+     * Min: 1 event
+     * Max: 50 events
      */
     (events: BulkUpdateEventRequestMaskedEvent[], options?: BulkUpdateEventOptions | undefined): Promise<BulkUpdateEventResponse & BulkUpdateEventResponseNonNullableFields>;
 }
 declare function restoreEventDefaults$1(httpClient: HttpClient): RestoreEventDefaultsSignature;
 interface RestoreEventDefaultsSignature {
     /**
-     * Restore default event values from the schedule or the recurring event.
-     * @param - The ID of the event.
-     * @param - The fields for which to restore default values.
+     * Restores the event's default values from the relevant schedule or `MASTER`
+     * event.
+     *
+     *
+     * You must provide `fields` to specify which `inheritedFields` are restored.
+     *
+     * For example, if you've created an event that takes place in a non-default
+     * location with a custom title and capacity, but you want to reset only title
+     * and capacity to default values without affecting the location, provide the
+     * event ID and set `fields` to `["TITLE", "CAPACITY"]`.
+     *
+     * Refer to the [default values article](https://dev.wix.com/docs/rest/business-management/calendar/default-values)
+     * form more information.
+     * @param - ID of the event for which to restore default values.
+     * @param - Fields for which to restore default values.
+     *
+     * `TIME` restores default values for `start` and `end`.
+     *
+     * Min: 1 field
      */
     (eventId: string | null, fields: Field$1[], options?: RestoreEventDefaultsOptions | undefined): Promise<RestoreEventDefaultsResponse & RestoreEventDefaultsResponseNonNullableFields>;
 }
 declare function splitRecurringEvent$1(httpClient: HttpClient): SplitRecurringEventSignature;
 interface SplitRecurringEventSignature {
     /**
-     * Splits a recurring event at a provided future date into two recurring events.
-     *
-     * Recurring event instances starting at or after the split date will belong to the new recurring event.
-     *
-     * Upon split, the following happens:
-     * - The recurring event is set to end in the last instance before the split date.
-     * - A new recurring event is created which set to start from the next instance starting at/after the split date.
-     * - Recurring event exceptions which start at/after the split date are updated with the new recurring event ID.
-     *
-     * The split date must be a future date between two instances of the recurring event.
-     * @param - The ID of the recurring event to split.
-     * @param - The ISO-8601 local date where the recurring event is to be split.
-     * Must be a future date.
-     * Must be between two instances of the recurring event.
+     * Splits a recurring `MASTER` event into 2 separate `MASTER` events.
+     *
+     *
+     * You must provide a `splitLocalDate` that's in the future and after the `start`
+     * date of the next `INSTANCE` or `EXCEPTION` event in the series. Additionally,
+     * there must be another `INSTANCE` or `EXCEPTION` event following this next event,
+     * as the changes wouldn't affect any event without a subsequent occurrence.
+     *
+     * If you want to modify a `MASTER` event with the changes already applying to
+     * the very next event, use
+     * [Update Event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/update-event)
+     * instead, as this preserves past events and only modifies future events.
+     *
+     * The main consequences are:
+     * - **The original `MASTER` event is shortened**. Its `recurrenceRule.until.localDate`
+     * is updated to `end.localDate` of the latest `INSTANCE` or `EXCEPTION`
+     * event starting before `splitLocalDate`. If an `INSTANCE` or `EXCEPTION` event
+     * starts before but ends after `splitLocalDate`, `until.localDate` is set
+     * to value that's later than `splitLocalDate`.
+     * - **A new `MASTER` event is created**, starting from the first event that
+     * begins after `splitLocalDate`.
+     * - **Existing `INSTANCE` and `EXCEPTION` events that occur after the split are updated**.
+     * Their `recurringEventId` is set to the ID of the newly created `MASTER` event.
+     * @param - ID of the `MASTER` event to split.
+     * @param - Local date and time at which the `MASTER` event is split in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2025-03-11T09:00:00`.
+     * Must be a future date that's after the `start` date of the next `INSTANCE` or
+     * `EXCEPTION` event in the series. Additionally, there must be another
+     * `INSTANCE` or `EXCEPTION` event following this next event, as the changes
+     * wouldn't affect any event without a subsequent occurrence.
      */
     (recurringEventId: string | null, splitLocalDate: string | null, options?: SplitRecurringEventOptions | undefined): Promise<SplitRecurringEventResponse & SplitRecurringEventResponseNonNullableFields>;
 }
@@ -2513,7 +2870,7 @@ declare function cancelEvent$1(httpClient: HttpClient): CancelEventSignature;
 interface CancelEventSignature {
     /**
      * Cancels an event.
-     * @param - The ID of the event to cancel.
+     * @param - ID of the event to cancel.
      */
     (eventId: string | null, options?: CancelEventOptions | undefined): Promise<CancelEventResponse & CancelEventResponseNonNullableFields>;
 }
@@ -2521,7 +2878,7 @@ declare function bulkCancelEvent$1(httpClient: HttpClient): BulkCancelEventSigna
 interface BulkCancelEventSignature {
     /**
      * Cancels multiple events in bulk.
-     * @param - The IDs of the events to cancel.
+     * @param - IDs of the events to cancel.
      */
     (eventIds: string[], options?: BulkCancelEventOptions | undefined): Promise<BulkCancelEventResponse & BulkCancelEventResponseNonNullableFields>;
 }
@@ -2575,19 +2932,27 @@ declare const listEventsByContactId: MaybeContext<BuildRESTFunction<typeof listE
 declare const listEventsByMemberId: MaybeContext<BuildRESTFunction<typeof listEventsByMemberId$1> & typeof listEventsByMemberId$1>;
 
 type _publicOnEventCreatedType = typeof onEventCreated$1;
-/** */
+/**
+ * Triggered when an event is created, including when an existing `MASTER` event is split.
+ */
 declare const onEventCreated: ReturnType<typeof createEventModule$4<_publicOnEventCreatedType>>;
 
 type _publicOnEventUpdatedType = typeof onEventUpdated$1;
-/** */
+/**
+ * Triggered when an event is updated, including when it's canceled.
+ */
 declare const onEventUpdated: ReturnType<typeof createEventModule$4<_publicOnEventUpdatedType>>;
 
 type _publicOnEventRecurringSplitType = typeof onEventRecurringSplit$1;
-/** */
+/**
+ * Triggered when a `MASTER` event is split.
+ */
 declare const onEventRecurringSplit: ReturnType<typeof createEventModule$4<_publicOnEventRecurringSplitType>>;
 
 type _publicOnEventCancelledType = typeof onEventCancelled$1;
-/** */
+/**
+ * Triggered when an event is canceled.
+ */
 declare const onEventCancelled: ReturnType<typeof createEventModule$4<_publicOnEventCancelledType>>;
 
 type context$4_ApplicationError = ApplicationError;
@@ -2696,14 +3061,15 @@ declare namespace context$4 {
   export { type ActionEvent$4 as ActionEvent, type Address$2 as Address, type AddressHint$2 as AddressHint, type context$4_ApplicationError as ApplicationError, type BaseEventMetadata$4 as BaseEventMetadata, type context$4_BulkActionMetadata as BulkActionMetadata, type context$4_BulkCancelEventOptions as BulkCancelEventOptions, type context$4_BulkCancelEventRequest as BulkCancelEventRequest, type context$4_BulkCancelEventResponse as BulkCancelEventResponse, type context$4_BulkCancelEventResponseNonNullableFields as BulkCancelEventResponseNonNullableFields, type context$4_BulkCreateEventOptions as BulkCreateEventOptions, type context$4_BulkCreateEventRequest as BulkCreateEventRequest, type context$4_BulkCreateEventResponse as BulkCreateEventResponse, type context$4_BulkCreateEventResponseNonNullableFields as BulkCreateEventResponseNonNullableFields, type context$4_BulkEventResult as BulkEventResult, type context$4_BulkUpdateEventOptions as BulkUpdateEventOptions, type context$4_BulkUpdateEventRequest as BulkUpdateEventRequest, type context$4_BulkUpdateEventRequestMaskedEvent as BulkUpdateEventRequestMaskedEvent, type context$4_BulkUpdateEventResponse as BulkUpdateEventResponse, type context$4_BulkUpdateEventResponseNonNullableFields as BulkUpdateEventResponseNonNullableFields, type BusinessSchedule$2 as BusinessSchedule, type context$4_CancelEventOptions as CancelEventOptions, type context$4_CancelEventRequest as CancelEventRequest, type context$4_CancelEventResponse as CancelEventResponse, type context$4_CancelEventResponseNonNullableFields as CancelEventResponseNonNullableFields, type Categories$2 as Categories, type ChangeContext$2 as ChangeContext, type ChangeContextPayloadOneOf$2 as ChangeContextPayloadOneOf, type context$4_CommonCursorPaging as CommonCursorPaging, type context$4_CommonCursorPagingMetadata as CommonCursorPagingMetadata, type context$4_CommonCursors as CommonCursors, type CommonIdentificationData$2 as CommonIdentificationData, type CommonIdentificationDataIdOneOf$2 as CommonIdentificationDataIdOneOf, type ConferencingDetails$2 as ConferencingDetails, type ConsentPolicy$2 as ConsentPolicy, type context$4_CreateEventOptions as CreateEventOptions, type context$4_CreateEventRequest as CreateEventRequest, type context$4_CreateEventResponse as CreateEventResponse, type context$4_CreateEventResponseNonNullableFields as CreateEventResponseNonNullableFields, type CursorPaging$2 as CursorPaging, type CursorPagingMetadata$2 as CursorPagingMetadata, type CursorQuery$2 as CursorQuery, type CursorQueryPagingMethodOneOf$2 as CursorQueryPagingMethodOneOf, type Cursors$2 as Cursors, Day$1 as Day, DayOfWeek$2 as DayOfWeek, type context$4_DeleteTargetsRequest as DeleteTargetsRequest, type context$4_DeleteTargetsResponse as DeleteTargetsResponse, type DomainEvent$4 as DomainEvent, type DomainEventBodyOneOf$4 as DomainEventBodyOneOf, type Empty$4 as Empty, type EntityCreatedEvent$4 as EntityCreatedEvent, type EntityDeletedEvent$4 as EntityDeletedEvent, type EntityUpdatedEvent$4 as EntityUpdatedEvent, type Event$1 as Event, type context$4_EventCancelled as EventCancelled, type context$4_EventCancelledEnvelope as EventCancelledEnvelope, type context$4_EventCreatedEnvelope as EventCreatedEnvelope, type EventMetadata$4 as EventMetadata, type context$4_EventNonNullableFields as EventNonNullableFields, type context$4_EventRecurringSplitEnvelope as EventRecurringSplitEnvelope, type context$4_EventUpdatedEnvelope as EventUpdatedEnvelope, type context$4_EventUpdatedWithMetadata as EventUpdatedWithMetadata, type context$4_EventsQueryBuilder as EventsQueryBuilder, type context$4_EventsQueryResult as EventsQueryResult, type ExtendedFields$3 as ExtendedFields, Field$1 as Field, Frequency$1 as Frequency, type GeoCoordinates$2 as GeoCoordinates, type context$4_GetEventOptions as GetEventOptions, type context$4_GetEventRequest as GetEventRequest, type context$4_GetEventResponse as GetEventResponse, type context$4_GetEventResponseNonNullableFields as GetEventResponseNonNullableFields, type IdentificationData$4 as IdentificationData, type IdentificationDataIdOneOf$4 as IdentificationDataIdOneOf, IdentityType$2 as IdentityType, type context$4_ItemMetadata as ItemMetadata, type context$4_ListEventsByContactIdOptions as ListEventsByContactIdOptions, type context$4_ListEventsByContactIdRequest as ListEventsByContactIdRequest, type context$4_ListEventsByContactIdResponse as ListEventsByContactIdResponse, type context$4_ListEventsByContactIdResponseNonNullableFields as ListEventsByContactIdResponseNonNullableFields, type context$4_ListEventsByMemberIdOptions as ListEventsByMemberIdOptions, type context$4_ListEventsByMemberIdRequest as ListEventsByMemberIdRequest, type context$4_ListEventsByMemberIdResponse as ListEventsByMemberIdResponse, type context$4_ListEventsByMemberIdResponseNonNullableFields as ListEventsByMemberIdResponseNonNullableFields, type context$4_ListEventsOptions as ListEventsOptions, type context$4_ListEventsRequest as ListEventsRequest, type context$4_ListEventsResponse as ListEventsResponse, type context$4_ListEventsResponseNonNullableFields as ListEventsResponseNonNullableFields, type context$4_ListRecurringEventInstancesHistoryRequest as ListRecurringEventInstancesHistoryRequest, type context$4_ListRecurringEventInstancesHistoryResponse as ListRecurringEventInstancesHistoryResponse, type Locale$2 as Locale, type Location$2 as Location, LocationType$2 as LocationType, type context$4_MaskedEvent as MaskedEvent, type MessageEnvelope$4 as MessageEnvelope, type Multilingual$2 as Multilingual, type Participant$2 as Participant, type ParticipantNotification$1 as ParticipantNotification, type Participants$1 as Participants, ParticipantsStatus$1 as ParticipantsStatus, type Permission$2 as Permission, PlacementType$2 as PlacementType, type Properties$2 as Properties, type PropertiesChange$2 as PropertiesChange, type context$4_QueryEventsOptions as QueryEventsOptions, type context$4_QueryEventsRequest as QueryEventsRequest, type context$4_QueryEventsResponse as QueryEventsResponse, type context$4_QueryEventsResponseNonNullableFields as QueryEventsResponseNonNullableFields, type RecurrenceRule$1 as RecurrenceRule, RecurrenceType$1 as RecurrenceType, type context$4_RecurringEventSplit as RecurringEventSplit, RequestedFields$1 as RequestedFields, ResolutionMethod$2 as ResolutionMethod, type Resource$1 as Resource, type context$4_RestoreEventDefaultsOptions as RestoreEventDefaultsOptions, type context$4_RestoreEventDefaultsRequest as RestoreEventDefaultsRequest, type context$4_RestoreEventDefaultsResponse as RestoreEventDefaultsResponse, type context$4_RestoreEventDefaultsResponseNonNullableFields as RestoreEventDefaultsResponseNonNullableFields, type RestoreInfo$4 as RestoreInfo, Role$2 as Role, type SiteCloned$2 as SiteCloned, type SiteCreated$2 as SiteCreated, type SitePropertiesEvent$2 as SitePropertiesEvent, type SitePropertiesNotification$2 as SitePropertiesNotification, context$4_SortOrder as SortOrder, type context$4_Sorting as Sorting, type SpecialHourPeriod$2 as SpecialHourPeriod, type context$4_SplitRecurringEventOptions as SplitRecurringEventOptions, type context$4_SplitRecurringEventRequest as SplitRecurringEventRequest, type context$4_SplitRecurringEventResponse as SplitRecurringEventResponse, type context$4_SplitRecurringEventResponseNonNullableFields as SplitRecurringEventResponseNonNullableFields, Status$4 as Status, type SupportedLanguage$2 as SupportedLanguage, type TimePeriod$2 as TimePeriod, type Translation$2 as Translation, Transparency$1 as Transparency, Type$2 as Type, type context$4_UpdateEvent as UpdateEvent, type context$4_UpdateEventOptions as UpdateEventOptions, type context$4_UpdateEventParticipantsRequest as UpdateEventParticipantsRequest, type context$4_UpdateEventParticipantsResponse as UpdateEventParticipantsResponse, type context$4_UpdateEventRequest as UpdateEventRequest, type context$4_UpdateEventResponse as UpdateEventResponse, type context$4_UpdateEventResponseNonNullableFields as UpdateEventResponseNonNullableFields, WebhookIdentityType$4 as WebhookIdentityType, type ZonedDate$2 as ZonedDate, type context$4__publicOnEventCancelledType as _publicOnEventCancelledType, type context$4__publicOnEventCreatedType as _publicOnEventCreatedType, type context$4__publicOnEventRecurringSplitType as _publicOnEventRecurringSplitType, type context$4__publicOnEventUpdatedType as _publicOnEventUpdatedType, context$4_bulkCancelEvent as bulkCancelEvent, context$4_bulkCreateEvent as bulkCreateEvent, context$4_bulkUpdateEvent as bulkUpdateEvent, context$4_cancelEvent as cancelEvent, context$4_createEvent as createEvent, context$4_getEvent as getEvent, context$4_listEvents as listEvents, context$4_listEventsByContactId as listEventsByContactId, context$4_listEventsByMemberId as listEventsByMemberId, context$4_onEventCancelled as onEventCancelled, context$4_onEventCreated as onEventCreated, context$4_onEventRecurringSplit as onEventRecurringSplit, context$4_onEventUpdated as onEventUpdated, onEventCancelled$1 as publicOnEventCancelled, onEventCreated$1 as publicOnEventCreated, onEventRecurringSplit$1 as publicOnEventRecurringSplit, onEventUpdated$1 as publicOnEventUpdated, context$4_queryEvents as queryEvents, context$4_restoreEventDefaults as restoreEventDefaults, context$4_splitRecurringEvent as splitRecurringEvent, context$4_updateEvent as updateEvent };
 }
 
+/** {{TBD}} */
 interface EventsView {
     /**
-     * The view end date.
+     * End date of the event view in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     endDate?: Date | null;
     /**
-     * The number of days the view lasts into the future.
+     * Number of days from now until the event view ends.
      * @readonly
      */
     futureDurationInDays?: number | null;
@@ -2729,198 +3095,229 @@ interface EventAddedOrUpdated {
     /** Optionally, the previous event. */
     previousEvent?: Event;
 }
+/**
+ * An event is a scheduled entry on a calendar that includes details like timing,
+ * location, and participants. Each event is associated with
+ * a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction),
+ * from which it may [inherit default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values).
+ * Events can either be standalone, part of a recurring series, or define a
+ * recurrence pattern. You can also specify whether events block time on the
+ * schedule or allow other events to be scheduled concurrently.
+ */
 interface Event {
     /**
-     * The event ID.
+     * Event ID.
      * @readonly
      */
     _id?: string | null;
     /**
-     * The ID of the schedule that the event belongs to.
-     * Cannot change.
+     * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * the event belongs to.
+     * After creating an event, you can't assign it to a different schedule.
      */
     scheduleId?: string | null;
     /**
-     * The external schedule ID.
+     * ID of the external schedule the event belongs to.
      * @readonly
      */
     externalScheduleId?: string | null;
     /**
-     * The schedule name.
+     * Schedule name.
      * @readonly
      */
     scheduleName?: string | null;
     /**
-     * The event type.
-     * Cannot change.
-     *
-     * The possible values are:
-     * - `"DEFAULT"` Default event.
-     * - `"WORKING_HOURS"` The event represents a resource working hours. Working hours events are hidden by default from queries.
+     * Event type. You can't update the event type.
      *
-     * The Wix Bookings App, once installed, also provides the following:
-     * - `"APPOINTMENT"` Bookings Appointment event.
-     * - `"CLASS"` Bookings Class event.
-     * - `"COURSE"` Bookings Course event.
+     * Supported values:
+     * + `DEFAULT`: A standard event that's not further specified.
+     * + `WORKING_HOURS`: Working hours event. By default not returned in [Query Events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/query-events).
      *
-     * See the [Event Type Provider](https://dev.wix.com/docs/rest/internal-only/calendar/event-type-provider-v3/introduction) for more details.
+     * Additional supported values, if Wix Bookings is installed:
+     * + `APPOINTMENT`: Bookings appointment event.
+     * + `CLASS`: Bookings class event.
+     * + `COURSE`: Bookings course event.
      */
     type?: string | null;
     /**
-     * The event status. Read only.
+     * Event status.
      *
-     * The possible values are:
-     * - `"CONFIRMED"` Event is confirmed. Default value.
-     * - `"CANCELLED"` Event has been cancelled.
+     * Supported values:
+     * + `CONFIRMED`: Event is scheduled to happen or has happened.
+     * + `CANCELLED`: Event has been canceled.
+     *
+     * Default: `CONFIRMED`
      * @readonly
      */
     status?: Status$3;
     /**
-     * The event title.
+     * Event title.
      *
-     * The title is inherited from the schedule and can be overridden.
+     * Min: 1 character
+     * Max: 200 characters
      */
     title?: string | null;
-    /**
-     * The event start date.
-     *
-     * Recurring events must start from at least today.
-     */
+    /** Information about when the event starts. */
     start?: ZonedDate$1;
-    /** The event end date. */
+    /** Information about when the event ends. */
     end?: ZonedDate$1;
     /**
-     * Read-only start date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event starts adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedStart?: ZonedDate$1;
     /**
-     * Read-only end date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Information about when the event ends adjusted to the `timeZone` of the
+     * business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or a different `timeZone` you provide in the call's request.
      * @readonly
      */
     adjustedEnd?: ZonedDate$1;
     /**
-     * The event time zone, formatted according to the IANA time zone format.
-     * Must be a regional time zone (Area/Location) or UTC.
+     * Time zone the event is associated with in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * Only regional time zones and UTC are supported.
+     * For example, `America/New_York` or `UTC`.
      *
-     * The time zone is inherited from the schedule and can be overridden.
+     * Default: `timeZone` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
      */
     timeZone?: string | null;
     /**
-     * Whether this event is a recurring event or an instance of recurring event.
+     * Information about whether the event is a single occurrence or part of a
+     * recurring series.
      *
-     * The possible values are:
-     * - `"NONE"` No recurrence, i.e the event is a single event instance. Default.
-     * - `"MASTER"` The event is the recurrence master defining the recurrence rule, which is the repeat pattern for the events.
-     * - `"INSTANCE"` The event is an instance of a recurring event. Read only.
-     * - `"EXCEPTION"` The event is an exceptional instance of a recurring event. Read only.
+     * Supported values:
+     * + `NONE`: The event occurs only once and doesn't repeat.
+     * + `MASTER`: Defines the recurrence pattern for a series of recurring events.
+     * + `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`.
+     * + `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.
+     *
+     * Default: `NONE`
      * @readonly
      */
     recurrenceType?: RecurrenceType;
     /**
-     * The recurrence rule defining a repeating pattern for the event.
-     * Required for `MASTER` recurrence, read only otherwise.
-     *
-     * For example, a event that repeats every second week on a Monday until January 7, 2024 at 8 AM, will have the following recurrence:
+     * Recurrence pattern for a series of events. This field is required when
+     * creating a `MASTER` event and isn't available for non-recurring events.
+     * You can't update the recurrence rule for `INSTANCE` or `EXCEPTION` events.
+     * For example, an event that repeats every second Monday until January 7, 2026,
+     * at 8:00 AM has the following `recurrenceRule`:
      * - `frequency = WEEKLY`
      * - `interval = 2`
      * - `days = [MONDAY]`
-     * - `until = 20240107T08:00:00Z`
+     * - `until = 20260107T08:00:00Z`
      */
     recurrenceRule?: RecurrenceRule;
     /**
-     * The ID of the recurring event that this event belongs to, if this event is an instance of recurring event.
+     * ID of the `MASTER` event the event belongs to. Available only for `INSTANCE`
+     * and `EXCEPTION` events.
      * @readonly
      */
     recurringEventId?: string | null;
     /**
-     * Specifies whether the event blocks the schedule time.
-     * Default is true.
+     * Specifies whether the event blocks time in the schedule it belongs to.
+     *
+     * Supported values:
+     * + `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.
+     * + `TRANSPARENT`: The schedule remains open during the event, allowing other events to be scheduled concurrently.
+     *
+     * Default: `TRANSPARENT`
      */
     transparency?: Transparency;
     /**
-     * The event location.
+     * Event location.
      *
-     * The location is inherited from the schedule and can be overridden.
+     * Default: `defaultLocation` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     location?: Location$1;
     /**
-     * List of resources affected by the event.
+     * List of [Wix Bookings resources](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object)
+     * affected by the event. This could include ,for example, the
+     * [Wix Bookings staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/staff-member-object)
+     * providing the service or the room where the appointment takes place.
      *
-     * For example:
-     * - Event occupying a resource time, such as a room, equipment or person.
-     * - The Bookings App Staff is affected by the Booking Class Sessions it provides.
+     * Max: 100 resources
      */
     resources?: Resource[];
     /**
-     * The event capacity, which is the max number of participants that can participate in the event.
+     * Maximum number of participants who can participate in the event.
      *
-     * The total capacity is inherited from the schedule and can be overridden.
+     * Default: `defaultCapacity` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     totalCapacity?: number | null;
     /**
-     * The remaining number of participants that can be added to the event.
+     * Number of participants who can still be added to the event.
      * @readonly
      */
     remainingCapacity?: number | null;
     /**
-     * The event participants.
+     * Information about the event's participants.
      * @readonly
      */
     participants?: Participants;
     /**
-     * Online conferencing details.
+     * Information about the event's online conferencing
      *
-     * The conferencing details are inherited from the schedule and can be overridden.
+     * Default: `defaultConferencingDetails` of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object) the event belongs to
      */
     conferencingDetails?: ConferencingDetails$1;
-    /** Additional notes and information about the event. */
+    /**
+     * Additional notes about the event.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     notes?: string | null;
     /**
-     * A list of fields for which values were inherited from the schedule or the recurring event,
-     * if this event is an instance of recurring event.
+     * List of fields whose values are inherited.
+     * + For single-occurrence events, values are inherited from the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object).
+     * + For `INSTANCE` and `EXCEPTION` events, values are inherited from the related the `MASTER` event.
      * @readonly
      */
     inheritedFields?: Field[];
     /**
-     * ID of the Wix app owning the event, as derived from the schedule.
+     * ID of the app that owns the event. Identical to `appId` of the
+     * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * to which the event belongs.
      * @readonly
      */
     appId?: string | null;
     /**
-     * List of granted permissions for this event.
-     *
-     * Derived from the schedule and the resources of the the event.
+     * List of permissions associated with the event. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
      * @readonly
      */
     permissions?: Permission$1[];
     /** Extensions enabling applications or users to save custom data related to the event. */
     extendedFields?: ExtendedFields$2;
     /**
-     * The event revision number, which incremented on updates.
-     *
-     * The current revision should be provided on updates to prevent conflicting changes.
+     * Revision number, which increments each time the event is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the event.
+     * Ignored when creating an event.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date the event was created.
+     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the event was last updated.
+     * Date the event was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
 }
 declare enum Status$3 {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
-    /** Event is confirmed. Default value. */
+    /** Event is scheduled to happen or has happened. */
     CONFIRMED = "CONFIRMED",
     /** DEPRECATED! AND WILL BE REMOVED SOON */
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION",
-    /** Event has been cancelled. */
+    /** Event has been canceled. */
     CANCELLED = "CANCELLED"
 }
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
@@ -2995,9 +3392,9 @@ declare enum Day {
 }
 declare enum Transparency {
     UNKNOWN_TRANSPARENCY = "UNKNOWN_TRANSPARENCY",
-    /** The event block time. Default. */
+    /** 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. */
     OPAQUE = "OPAQUE",
-    /** The event does not block the time. */
+    /** The schedule remains open during the event, allowing other events to be scheduled concurrently. */
     TRANSPARENT = "TRANSPARENT"
 }
 interface Location$1 {
@@ -3114,21 +3511,21 @@ declare enum Type$1 {
 }
 declare enum Field {
     UNKNOWN_FIELD = "UNKNOWN_FIELD",
-    /** The title is inherited from the schedule or the recurring event. */
+    /** `title` is inherited from the schedule or `MASTER` event. */
     TITLE = "TITLE",
-    /** The time zone is inherited from the schedule or the recurring event. */
+    /** `timeZone` is inherited from the schedule or `MASTER` event. */
     TIME_ZONE = "TIME_ZONE",
-    /** The time is inherited from the recurring event. */
+    /** `start` and `end` are inherited from the `MASTER` event. */
     TIME = "TIME",
-    /** The location is inherited from the schedule or the recurring event. */
+    /** `location` is inherited from the schedule or `MASTER` event. */
     LOCATION = "LOCATION",
-    /** The resources are inherited from the recurring event. */
+    /** `resources` is inherited from the `MASTER` event. */
     RESOURCES = "RESOURCES",
-    /** The capacity is inherited from the schedule or the recurring event. */
+    /** `capacity` is inherited from the schedule or `MASTER` event. */
     CAPACITY = "CAPACITY",
-    /** The participants are inherited from the recurring event. */
+    /** `participants` is inherited from the `MASTER` event. */
     PARTICIPANTS = "PARTICIPANTS",
-    /** The conferencing details are inherited from the schedule or the recurring event. */
+    /** `conferencingDetails` is inherited from the schedule or `MASTER` event. */
     CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
 }
 interface Permission$1 {
@@ -3144,12 +3541,18 @@ interface Permission$1 {
     role?: Role$1;
 }
 interface CommonIdentificationData$1 extends CommonIdentificationDataIdOneOf$1 {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 /** @oneof */
 interface CommonIdentificationDataIdOneOf$1 {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 declare enum IdentityType$1 {
@@ -4067,95 +4470,131 @@ declare namespace context$2 {
   export { type ActionEvent$2 as ActionEvent, type BaseEventMetadata$2 as BaseEventMetadata, type context$2_CreateParticipationOptions as CreateParticipationOptions, type context$2_CreateParticipationRequest as CreateParticipationRequest, type context$2_CreateParticipationResponse as CreateParticipationResponse, type context$2_CreateParticipationResponseNonNullableFields as CreateParticipationResponseNonNullableFields, type CursorPaging$1 as CursorPaging, type CursorPagingMetadata$1 as CursorPagingMetadata, type CursorQuery$1 as CursorQuery, type CursorQueryPagingMethodOneOf$1 as CursorQueryPagingMethodOneOf, type Cursors$1 as Cursors, type context$2_DeleteParticipationRequest as DeleteParticipationRequest, type context$2_DeleteParticipationResponse as DeleteParticipationResponse, type DomainEvent$2 as DomainEvent, type DomainEventBodyOneOf$2 as DomainEventBodyOneOf, type Empty$2 as Empty, type EntityCreatedEvent$2 as EntityCreatedEvent, type EntityDeletedEvent$2 as EntityDeletedEvent, type EntityUpdatedEvent$2 as EntityUpdatedEvent, type EventMetadata$2 as EventMetadata, type ExtendedFields$1 as ExtendedFields, type context$2_GetParticipationRequest as GetParticipationRequest, type context$2_GetParticipationResponse as GetParticipationResponse, type context$2_GetParticipationResponseNonNullableFields as GetParticipationResponseNonNullableFields, type IdentificationData$2 as IdentificationData, type IdentificationDataIdOneOf$2 as IdentificationDataIdOneOf, type MessageEnvelope$2 as MessageEnvelope, type context$2_Participant as Participant, type context$2_Participation as Participation, type context$2_ParticipationCreatedEnvelope as ParticipationCreatedEnvelope, type context$2_ParticipationDeletedEnvelope as ParticipationDeletedEnvelope, type context$2_ParticipationNonNullableFields as ParticipationNonNullableFields, type context$2_ParticipationParticipatedItemOneOf as ParticipationParticipatedItemOneOf, type context$2_ParticipationUpdatedEnvelope as ParticipationUpdatedEnvelope, type context$2_ParticipationUpdatedWithMetadata as ParticipationUpdatedWithMetadata, type context$2_ParticipationsQueryBuilder as ParticipationsQueryBuilder, type context$2_ParticipationsQueryResult as ParticipationsQueryResult, type context$2_PartySizeSumByScheduleId as PartySizeSumByScheduleId, type context$2_QueryParticipationsRequest as QueryParticipationsRequest, type context$2_QueryParticipationsResponse as QueryParticipationsResponse, type context$2_QueryParticipationsResponseNonNullableFields as QueryParticipationsResponseNonNullableFields, type RestoreInfo$2 as RestoreInfo, Status$2 as Status, type context$2_SumParticipationsPartySizeByScheduleIdRequest as SumParticipationsPartySizeByScheduleIdRequest, type context$2_SumParticipationsPartySizeByScheduleIdResponse as SumParticipationsPartySizeByScheduleIdResponse, type context$2_UpdateParticipation as UpdateParticipation, type context$2_UpdateParticipationRequest as UpdateParticipationRequest, type context$2_UpdateParticipationResponse as UpdateParticipationResponse, type context$2_UpdateParticipationResponseNonNullableFields as UpdateParticipationResponseNonNullableFields, WebhookIdentityType$2 as WebhookIdentityType, type context$2__publicOnParticipationCreatedType as _publicOnParticipationCreatedType, type context$2__publicOnParticipationDeletedType as _publicOnParticipationDeletedType, type context$2__publicOnParticipationUpdatedType as _publicOnParticipationUpdatedType, context$2_createParticipation as createParticipation, context$2_deleteParticipation as deleteParticipation, context$2_getParticipation as getParticipation, context$2_onParticipationCreated as onParticipationCreated, context$2_onParticipationDeleted as onParticipationDeleted, context$2_onParticipationUpdated as onParticipationUpdated, onParticipationCreated$1 as publicOnParticipationCreated, onParticipationDeleted$1 as publicOnParticipationDeleted, onParticipationUpdated$1 as publicOnParticipationUpdated, context$2_queryParticipations as queryParticipations, context$2_updateParticipation as updateParticipation };
 }
 
+/**
+ * A collection of [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+ * associated with a specific entity, such as a
+ * [Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object),
+ * or [Bookings resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
+ * Schedules can also serve as templates for the events they manage, setting
+ * default values like a default location.
+ */
 interface Schedule {
     /**
-     * The schedule ID.
+     * Schedule ID.
      * @readonly
      */
     _id?: string | null;
     /**
-     * Optional external ID. Cannot change.
+     * External ID. You can't update the external ID.
      *
-     * For instance, might be the ID of the Bookings Resource or Service.
+     * If the schedule belongs to a Bookings staff member, identical to the ID of
+     * the [resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
+     * If the schedule belongs to a Bookings service, identical to the ID of
+     * the [service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object).
      */
     externalId?: string | null;
     /**
-     * The name of the schedule.
+     * Schedule name.
      *
-     * For instance, might be the name of the Bookings Resource or Service.
+     * Min: 1 character
+     * Max: 200 characters
      */
     name?: string | null;
     /**
-     * The schedule status.
+     * Schedule status.
      *
-     * The possible values are:
-     * - `"ACTIVE"` Schedule is active. Default value.
-     * - `"CANCELLED"` Schedule has been cancelled.
+     * Supported values:
+     * - `ACTIVE`: You can add events to the schedule or update its fields.
+     * - `CANCELLED` You can't add events to the schedule or update its fields.
+     *
+     * Default: `ACTIVE`
      * @readonly
      */
     status?: Status$1;
     /**
-     * The schedule time zone, formatted according to the IANA time zone format.
-     * Must be a regional time zone (Area/Location) or UTC.
+     * Time zone the schedule is associated with in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * For example, `America/New_York`.
+     *
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      *
-     * By default the time zone is derived from the Wix Business, and can be overridden by setting `businessTimeZoneEnabled` to false.
+     * Min: 1 character
+     * Max: 150 characters
      */
     timeZone?: string | null;
     /**
-     * Whether to use the time zone of the Wix Business.
-     * Default is true.
+     * Whether the schedule's `timeZone` is automatically synced from
+     * `timeZone` of the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     *
+     * Default: `true`
      */
     businessTimeZoneEnabled?: boolean | null;
-    /** Default title for the schedule's events. */
+    /**
+     * Default `title` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     defaultTitle?: string | null;
-    /** Default location for the schedule's events. */
+    /**
+     * Default `location` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     */
     defaultLocation?: Location;
     /**
-     * Default capacity for the schedule's events.
+     * Default `totalCapacity` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
      *
-     * The capacity of an event is the max number of participants that can participate in an event.
+     * Min: `0`
      */
     defaultCapacity?: number | null;
-    /** Default conferencing details for the schedule's events. */
+    /**
+     * Default `conferencingDetails` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     */
     defaultConferencingDetails?: ConferencingDetails;
     /**
-     * Optional ID of the Wix app owning the schedule.
-     * Cannot change once set.
-     *
-     * For example, to create a schedule in the Wix Bookings App Calendar, provide `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
+     * ID of the app that's associated with the schedule. You can't update `appId`.
+     * If you want to create a schedule and ensure its associated events appear
+     * in the [Bookings calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar),
+     * you must provide the [Wix Bookings app ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
      */
     appId?: string | null;
     /**
-     * List of granted permissions for this schedule.
+     * List of permissions associated with the schedule. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
      *
-     * E.g, a Bookings Staff Member has full write access to its schedule and limited access to events it provides.
+     * Max: 1 permission
      */
     permissions?: Permission[];
     /** Extensions enabling applications or users to save custom data related to the schedule. */
     extendedFields?: ExtendedFields;
     /**
-     * The schedule revision number, which incremented on updates.
-     *
-     * The current revision should be provided on updates to prevent conflicting changes.
+     * Revision number, which increments by 1 each time the schedule is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the schedule.
+     * Ignored when creating a schedule.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date the schedule was created.
+     * Date the schedule was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the schedule was last updated.
+     * Date the schedule was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
 }
 declare enum Status$1 {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
-    /** Schedule is active. Default value. */
+    /** You can add events to the schedule or update its fields. */
     ACTIVE = "ACTIVE",
-    /** Schedule has been cancelled. */
+    /** You can't add events to the schedule or update its fields. */
     CANCELLED = "CANCELLED"
 }
 interface Location {
@@ -4222,12 +4661,18 @@ interface Permission {
     role?: Role;
 }
 interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 /** @oneof */
 interface CommonIdentificationDataIdOneOf {
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user. For example, the site owner or a
+     * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
+     */
     wixUserId?: string;
 }
 declare enum IdentityType {
@@ -4253,32 +4698,48 @@ interface ExtendedFields {
     namespaces?: Record<string, Record<string, any>>;
 }
 interface GetScheduleRequest {
-    /** The ID of the schedule to retrieve. */
+    /** ID of the schedule to retrieve. */
     scheduleId: string | null;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields[];
 }
 declare enum RequestedFields {
     UNKNOWN_REQUESTED_FIELDS = "UNKNOWN_REQUESTED_FIELDS",
-    /**
-     * Include fields containing personal information.
-     * Requires the `CALENDAR.SCHEDULE_READ_PI` additional permission.
-     */
+    /** Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope. */
     PI_FIELDS = "PI_FIELDS",
-    /**
-     * Include fields containing personal information for schedules the current caller has access to.
-     * See `schedule.permissions` for more details.
-     */
+    /** Returns only fields containing your own personal data. */
     OWN_PI_FIELDS = "OWN_PI_FIELDS"
 }
 interface GetScheduleResponse {
-    /** The schedule. */
+    /** Retrieved schedule. */
     schedule?: Schedule;
 }
 interface QuerySchedulesRequest {
     /** Query containing filters and paging. */
     query?: CursorQuery;
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields[];
 }
 /** TODO Diverge */
@@ -4287,7 +4748,7 @@ interface CursorQuery extends CursorQueryPagingMethodOneOf {
     cursorPaging?: CursorPaging;
     /**
      * Filter object.
-     * See [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
+     * See [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language)
      * for more information.
      *
      * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`.
@@ -4304,8 +4765,11 @@ interface CursorQueryPagingMethodOneOf {
 /** TODO Diverge */
 interface CursorPaging {
     /**
-     * Number of events to return.
-     * Defaults to `50`. Maximum `1000`.
+     * Number of schedules to return.
+     *
+     * Min: `1`
+     * Max: `100`
+     * Default: `50`
      */
     limit?: number | null;
     /**
@@ -4318,14 +4782,14 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QuerySchedulesResponse {
-    /** The schedules matching the provided query. */
+    /** Retrieved schedules matching the provided query. */
     schedules?: Schedule[];
     /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
 /** TODO Diverge */
 interface CursorPagingMetadata {
-    /** Number of items returned in the response. */
+    /** Number of schedules returned in the current page of the response. */
     count?: number | null;
     /** 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). */
     cursors?: Cursors;
@@ -4343,19 +4807,25 @@ interface Cursors {
     prev?: string | null;
 }
 interface CreateScheduleRequest {
-    /** The schedule to create. */
+    /** Schedule to create. */
     schedule: Schedule;
-    /** Optional Idempotency key. */
+    /**
+     * Idempotency key guaranteeing that you don't create the same schedule more
+     * than once.
+     */
     idempotencyKey?: string | null;
 }
 interface CreateScheduleResponse {
-    /** The created schedule. */
+    /** Created schedule. */
     schedule?: Schedule;
 }
 interface UpdateScheduleRequest {
-    /** The schedule to update. */
+    /** Schedule to update. */
     schedule: Schedule;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the schedule's updated events are
+     * notified and the message they receive.
+     */
     participantNotification?: ParticipantNotification;
 }
 interface ParticipantNotification {
@@ -4368,7 +4838,7 @@ interface ParticipantNotification {
     message?: string | null;
 }
 interface UpdateScheduleResponse {
-    /** The updated schedule. */
+    /** Updated schedule. */
     schedule?: Schedule;
 }
 /** `PRIVATE` until we'll have standard events metadata from Infra. */
@@ -4379,13 +4849,13 @@ interface ScheduleUpdatedWithMetadata {
     participantNotification?: ParticipantNotification;
 }
 interface CloneScheduleRequest {
-    /** The ID of the schedule to clone. */
+    /** ID of the schedule to clone. */
     scheduleId?: string | null;
-    /** Optional values to override. */
+    /** Fields to override in the cloned schedule. */
     schedule?: Schedule;
 }
 interface CloneScheduleResponse {
-    /** The new cloned schedule. */
+    /** Cloned schedule. */
     schedule?: Schedule;
 }
 interface ScheduleCloned {
@@ -4412,18 +4882,21 @@ declare enum Trigger {
     OTHER = "OTHER"
 }
 interface CancelScheduleRequest {
-    /** The ID of the schedule to cancel. */
+    /** ID of the schedule to cancel. */
     scheduleId: string | null;
     /**
      * Whether to preserve future events with participants.
-     * Default is false.
+     * Default: `false`.
      */
     preserveFutureEventsWithParticipants?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the schedule's updated events are
+     * notified and the message they receive.
+     */
     participantNotification?: ParticipantNotification;
 }
 interface CancelScheduleResponse {
-    /** The cancelled schedule. */
+    /** Canceled schedule. */
     schedule?: Schedule;
 }
 interface ScheduleCancelled {
@@ -4469,7 +4942,10 @@ interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {
     version?: string;
     /** A timestamp of the event. */
     timestamp?: string;
-    /** A list of "assets" (applications). The same as MetaSiteContext. */
+    /**
+     * TODO(meta-site): Change validation once validations are disabled for consumers
+     * More context: https://wix.slack.com/archives/C0UHEBPFT/p1720957844413149 and https://wix.slack.com/archives/CFWKX325T/p1728892152855659
+     */
     assets?: Asset[];
 }
 /** @oneof */
@@ -5181,11 +5657,33 @@ interface ScheduleCancelledEnvelope {
     metadata: EventMetadata$1;
 }
 interface GetScheduleOptions {
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields[];
 }
 interface QuerySchedulesOptions {
-    /** List of additional fields to be included in the response. */
+    /**
+     * Information about which fields containing personal data to return. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions)
+     * for more information.
+     *
+     * Supported values:
+     * + `PI_FIELDS`: Returns all fields with personal data. Your app must have `Read Calendars - Including PI` or `Manage Calendars` permission scope.
+     * + `OWN_PI_FIELDS`: Returns only fields containing your own personal data.
+     *
+     * Max: 1 field
+     * Default: No personal data is returned.
+     */
     fields?: RequestedFields[] | undefined;
 }
 interface QueryCursorResult {
@@ -5221,122 +5719,174 @@ interface SchedulesQueryBuilder {
     find: () => Promise<SchedulesQueryResult>;
 }
 interface CreateScheduleOptions {
-    /** Optional Idempotency key. */
+    /**
+     * Idempotency key guaranteeing that you don't create the same schedule more
+     * than once.
+     */
     idempotencyKey?: string | null;
 }
 interface UpdateSchedule {
     /**
-     * The schedule ID.
+     * Schedule ID.
      * @readonly
      */
     _id?: string | null;
     /**
-     * Optional external ID. Cannot change.
+     * External ID. You can't update the external ID.
      *
-     * For instance, might be the ID of the Bookings Resource or Service.
+     * If the schedule belongs to a Bookings staff member, identical to the ID of
+     * the [resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object).
+     * If the schedule belongs to a Bookings service, identical to the ID of
+     * the [service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object).
      */
     externalId?: string | null;
     /**
-     * The name of the schedule.
+     * Schedule name.
      *
-     * For instance, might be the name of the Bookings Resource or Service.
+     * Min: 1 character
+     * Max: 200 characters
      */
     name?: string | null;
     /**
-     * The schedule status.
+     * Schedule status.
      *
-     * The possible values are:
-     * - `"ACTIVE"` Schedule is active. Default value.
-     * - `"CANCELLED"` Schedule has been cancelled.
+     * Supported values:
+     * - `ACTIVE`: You can add events to the schedule or update its fields.
+     * - `CANCELLED` You can't add events to the schedule or update its fields.
+     *
+     * Default: `ACTIVE`
      * @readonly
      */
     status?: Status$1;
     /**
-     * The schedule time zone, formatted according to the IANA time zone format.
-     * Must be a regional time zone (Area/Location) or UTC.
+     * Time zone the schedule is associated with in
+     * [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
+     * For example, `America/New_York`.
      *
-     * By default the time zone is derived from the Wix Business, and can be overridden by setting `businessTimeZoneEnabled` to false.
+     * Default: `timeZone` specified in the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     *
+     * Min: 1 character
+     * Max: 150 characters
      */
     timeZone?: string | null;
     /**
-     * Whether to use the time zone of the Wix Business.
-     * Default is true.
+     * Whether the schedule's `timeZone` is automatically synced from
+     * `timeZone` of the business [site properties(https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     *
+     * Default: `true`
      */
     businessTimeZoneEnabled?: boolean | null;
-    /** Default title for the schedule's events. */
+    /**
+     * Default `title` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     defaultTitle?: string | null;
-    /** Default location for the schedule's events. */
+    /**
+     * Default `location` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     */
     defaultLocation?: Location;
     /**
-     * Default capacity for the schedule's events.
+     * Default `totalCapacity` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
      *
-     * The capacity of an event is the max number of participants that can participate in an event.
+     * Min: `0`
      */
     defaultCapacity?: number | null;
-    /** Default conferencing details for the schedule's events. */
+    /**
+     * Default `conferencingDetails` for [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * that are added to the schedule.
+     */
     defaultConferencingDetails?: ConferencingDetails;
     /**
-     * Optional ID of the Wix app owning the schedule.
-     * Cannot change once set.
-     *
-     * For example, to create a schedule in the Wix Bookings App Calendar, provide `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
+     * ID of the app that's associated with the schedule. You can't update `appId`.
+     * If you want to create a schedule and ensure its associated events appear
+     * in the [Bookings calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar),
+     * you must provide the [Wix Bookings app ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * `13d21c63-b5ec-5912-8397-c3a5ddb27a97`.
      */
     appId?: string | null;
     /**
-     * List of granted permissions for this schedule.
+     * List of permissions associated with the schedule. Refer to the
+     * [permissions article](https://dev.wix.com/docs/rest/business-management/calendar/permissions#roles)
+     * for more information.
      *
-     * E.g, a Bookings Staff Member has full write access to its schedule and limited access to events it provides.
+     * Max: 1 permission
      */
     permissions?: Permission[];
     /** Extensions enabling applications or users to save custom data related to the schedule. */
     extendedFields?: ExtendedFields;
     /**
-     * The schedule revision number, which incremented on updates.
-     *
-     * The current revision should be provided on updates to prevent conflicting changes.
+     * Revision number, which increments by 1 each time the schedule is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the schedule.
+     * Ignored when creating a schedule.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date the schedule was created.
+     * Date the schedule was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the schedule was last updated.
+     * Date the schedule was last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
 }
 interface UpdateScheduleOptions {
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the schedule's updated events are
+     * notified and the message they receive.
+     */
     participantNotification?: ParticipantNotification;
 }
 interface CancelScheduleOptions {
     /**
      * Whether to preserve future events with participants.
-     * Default is false.
+     * Default: `false`.
      */
     preserveFutureEventsWithParticipants?: boolean | null;
-    /** Whether to notify participants regarding the changes. */
+    /**
+     * Information about whether participants of the schedule's updated events are
+     * notified and the message they receive.
+     */
     participantNotification?: ParticipantNotification;
 }
 
 declare function getSchedule$1(httpClient: HttpClient): GetScheduleSignature;
 interface GetScheduleSignature {
     /**
-     * Retrieves a schedule by ID.
-     * @param - The ID of the schedule to retrieve.
-     * @returns The schedule.
+     * Retrieves a schedule.
+     * @param - ID of the schedule to retrieve.
+     * @returns Retrieved schedule.
      */
     (scheduleId: string | null, options?: GetScheduleOptions | undefined): Promise<Schedule & ScheduleNonNullableFields>;
 }
 declare function querySchedules$1(httpClient: HttpClient): QuerySchedulesSignature;
 interface QuerySchedulesSignature {
     /**
-     * Query for schedules given the provided filters and paging.
+     * Retrieves a list of schedules, given the provided paging and filtering.
+     *
+     *
+     *
+     * By default only `ACTIVE` schedules are returned, unless you provide a different
+     * `status` filter.
+     *
+     * Currently, you can't sort the response.
+     *
+     * Query schedules runs with these defaults, which you can override:
+     * - `cursorPaging.limit` is `50`
+     *
+     * For field support for filters, see
+     * [Schedules V3: Supported Filters](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/supported-filters).
      *
-     * By default only active schedules are returned, unless a `status` filter is provided.
+     * To learn about working with _Query_ endpoints, see
+     * [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language)
+     * and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
      */
     (options?: QuerySchedulesOptions | undefined): SchedulesQueryBuilder;
 }
@@ -5344,8 +5894,14 @@ declare function createSchedule$1(httpClient: HttpClient): CreateScheduleSignatu
 interface CreateScheduleSignature {
     /**
      * Creates a schedule.
-     * @param - The schedule to create.
-     * @returns The created schedule.
+     *
+     *
+     * If you want the schedule's events to appear in the
+     * [Bookings calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar),
+     * you must set `appId` to the ID of the Wix Bookings app by providing
+     * `{"appId": "13d21c63-b5ec-5912-8397-c3a5ddb27a97"}`.
+     * @param - Schedule to create.
+     * @returns Created schedule.
      */
     (schedule: Schedule, options?: CreateScheduleOptions | undefined): Promise<Schedule & ScheduleNonNullableFields>;
 }
@@ -5353,16 +5909,29 @@ declare function updateSchedule$1(httpClient: HttpClient): UpdateScheduleSignatu
 interface UpdateScheduleSignature {
     /**
      * Updates a schedule.
-     * @param - The schedule ID.
-     * @returns The updated schedule.
+     *
+     *
+     * Each time the schedule is updated,
+     * `revision` increments by 1.
+     * The current `revision` must be passed when updating the schedule.
+     * This ensures you're working with the latest schedule
+     * and prevents unintended overwrites.
+     * @param - Schedule ID.
+     * @returns Updated schedule.
      */
     (_id: string | null, schedule: UpdateSchedule, options?: UpdateScheduleOptions | undefined): Promise<Schedule & ScheduleNonNullableFields>;
 }
 declare function cancelSchedule$1(httpClient: HttpClient): CancelScheduleSignature;
 interface CancelScheduleSignature {
     /**
-     * Cancels a schedule.
-     * @param - The ID of the schedule to cancel.
+     * Sets a schedule's `status` to `CANCELLED`.
+     *
+     *
+     * Cancels also future events belonging to the schedule.
+     *
+     * Once a schedule is marked as `CANCELLED`, you can't reactivate it, update it,
+     * or assign new events.
+     * @param - ID of the schedule to cancel.
      */
     (scheduleId: string | null, options?: CancelScheduleOptions | undefined): Promise<CancelScheduleResponse & CancelScheduleResponseNonNullableFields>;
 }
@@ -5389,7 +5958,9 @@ type _publicOnScheduleCreatedType = typeof onScheduleCreated$1;
 declare const onScheduleCreated: ReturnType<typeof createEventModule$1<_publicOnScheduleCreatedType>>;
 
 type _publicOnScheduleUpdatedType = typeof onScheduleUpdated$1;
-/** */
+/**
+ * Triggered when a schedule is updated.
+ */
 declare const onScheduleUpdated: ReturnType<typeof createEventModule$1<_publicOnScheduleUpdatedType>>;
 
 type _publicOnScheduleClonedType = typeof onScheduleCloned$1;
@@ -5397,7 +5968,9 @@ type _publicOnScheduleClonedType = typeof onScheduleCloned$1;
 declare const onScheduleCloned: ReturnType<typeof createEventModule$1<_publicOnScheduleClonedType>>;
 
 type _publicOnScheduleCancelledType = typeof onScheduleCancelled$1;
-/** */
+/**
+ * Triggered when a schedule is canceled.
+ */
 declare const onScheduleCancelled: ReturnType<typeof createEventModule$1<_publicOnScheduleCancelledType>>;
 
 type context$1_Asset = Asset;
@@ -5502,55 +6075,74 @@ declare namespace context$1 {
   export { type ActionEvent$1 as ActionEvent, type Address$1 as Address, type AddressHint$1 as AddressHint, type context$1_Asset as Asset, type BaseEventMetadata$1 as BaseEventMetadata, type BusinessSchedule$1 as BusinessSchedule, type context$1_CancelScheduleOptions as CancelScheduleOptions, type context$1_CancelScheduleRequest as CancelScheduleRequest, type context$1_CancelScheduleResponse as CancelScheduleResponse, type context$1_CancelScheduleResponseNonNullableFields as CancelScheduleResponseNonNullableFields, type Categories$1 as Categories, type ChangeContext$1 as ChangeContext, type ChangeContextPayloadOneOf$1 as ChangeContextPayloadOneOf, type context$1_CloneScheduleRequest as CloneScheduleRequest, type context$1_CloneScheduleResponse as CloneScheduleResponse, type context$1_CommonIdentificationData as CommonIdentificationData, type context$1_CommonIdentificationDataIdOneOf as CommonIdentificationDataIdOneOf, type context$1_ConferencingDetails as ConferencingDetails, type ConsentPolicy$1 as ConsentPolicy, type context$1_CreateScheduleOptions as CreateScheduleOptions, type context$1_CreateScheduleRequest as CreateScheduleRequest, type context$1_CreateScheduleResponse as CreateScheduleResponse, type context$1_CreateScheduleResponseNonNullableFields as CreateScheduleResponseNonNullableFields, type context$1_CursorPaging as CursorPaging, type context$1_CursorPagingMetadata as CursorPagingMetadata, type context$1_CursorQuery as CursorQuery, type context$1_CursorQueryPagingMethodOneOf as CursorQueryPagingMethodOneOf, type context$1_Cursors as Cursors, DayOfWeek$1 as DayOfWeek, type context$1_DeleteContext as DeleteContext, context$1_DeleteStatus as DeleteStatus, type DomainEvent$1 as DomainEvent, type DomainEventBodyOneOf$1 as DomainEventBodyOneOf, type Empty$1 as Empty, type EntityCreatedEvent$1 as EntityCreatedEvent, type EntityDeletedEvent$1 as EntityDeletedEvent, type EntityUpdatedEvent$1 as EntityUpdatedEvent, type EventMetadata$1 as EventMetadata, type context$1_ExtendedFields as ExtendedFields, type GeoCoordinates$1 as GeoCoordinates, type context$1_GetScheduleOptions as GetScheduleOptions, type context$1_GetScheduleRequest as GetScheduleRequest, type context$1_GetScheduleResponse as GetScheduleResponse, type context$1_GetScheduleResponseNonNullableFields as GetScheduleResponseNonNullableFields, type IdentificationData$1 as IdentificationData, type IdentificationDataIdOneOf$1 as IdentificationDataIdOneOf, context$1_IdentityType as IdentityType, type Locale$1 as Locale, type context$1_Location as Location, context$1_LocationType as LocationType, type MessageEnvelope$1 as MessageEnvelope, type context$1_MetaSiteSpecialEvent as MetaSiteSpecialEvent, type context$1_MetaSiteSpecialEventPayloadOneOf as MetaSiteSpecialEventPayloadOneOf, type Multilingual$1 as Multilingual, context$1_Namespace as Namespace, type context$1_NamespaceChanged as NamespaceChanged, type context$1_ParticipantNotification as ParticipantNotification, type context$1_Permission as Permission, PlacementType$1 as PlacementType, type Properties$1 as Properties, type PropertiesChange$1 as PropertiesChange, type context$1_QuerySchedulesOptions as QuerySchedulesOptions, type context$1_QuerySchedulesRequest as QuerySchedulesRequest, type context$1_QuerySchedulesResponse as QuerySchedulesResponse, type context$1_QuerySchedulesResponseNonNullableFields as QuerySchedulesResponseNonNullableFields, context$1_RequestedFields as RequestedFields, ResolutionMethod$1 as ResolutionMethod, type RestoreInfo$1 as RestoreInfo, context$1_Role as Role, type context$1_Schedule as Schedule, type context$1_ScheduleCancelled as ScheduleCancelled, type context$1_ScheduleCancelledEnvelope as ScheduleCancelledEnvelope, type context$1_ScheduleCloned as ScheduleCloned, type context$1_ScheduleClonedEnvelope as ScheduleClonedEnvelope, type context$1_ScheduleCreatedEnvelope as ScheduleCreatedEnvelope, type context$1_ScheduleNonNullableFields as ScheduleNonNullableFields, type context$1_ScheduleUpdatedEnvelope as ScheduleUpdatedEnvelope, type context$1_ScheduleUpdatedWithMetadata as ScheduleUpdatedWithMetadata, type context$1_SchedulesQueryBuilder as SchedulesQueryBuilder, type context$1_SchedulesQueryResult as SchedulesQueryResult, type context$1_ServiceProvisioned as ServiceProvisioned, type context$1_ServiceRemoved as ServiceRemoved, type SiteCloned$1 as SiteCloned, type SiteCreated$1 as SiteCreated, context$1_SiteCreatedContext as SiteCreatedContext, type context$1_SiteDeleted as SiteDeleted, type context$1_SiteHardDeleted as SiteHardDeleted, type context$1_SiteMarkedAsTemplate as SiteMarkedAsTemplate, type context$1_SiteMarkedAsWixSite as SiteMarkedAsWixSite, type SitePropertiesEvent$1 as SitePropertiesEvent, type SitePropertiesNotification$1 as SitePropertiesNotification, type context$1_SitePublished as SitePublished, type context$1_SiteRenamed as SiteRenamed, type context$1_SiteTransferred as SiteTransferred, type context$1_SiteUndeleted as SiteUndeleted, type context$1_SiteUnpublished as SiteUnpublished, type SpecialHourPeriod$1 as SpecialHourPeriod, context$1_State as State, Status$1 as Status, type context$1_StudioAssigned as StudioAssigned, type context$1_StudioUnassigned as StudioUnassigned, type SupportedLanguage$1 as SupportedLanguage, type TimePeriod$1 as TimePeriod, type Translation$1 as Translation, context$1_Trigger as Trigger, context$1_Type as Type, type context$1_UpdateSchedule as UpdateSchedule, type context$1_UpdateScheduleOptions as UpdateScheduleOptions, type context$1_UpdateScheduleRequest as UpdateScheduleRequest, type context$1_UpdateScheduleResponse as UpdateScheduleResponse, type context$1_UpdateScheduleResponseNonNullableFields as UpdateScheduleResponseNonNullableFields, type context$1_V4SiteCreated as V4SiteCreated, WebhookIdentityType$1 as WebhookIdentityType, type context$1__publicOnScheduleCancelledType as _publicOnScheduleCancelledType, type context$1__publicOnScheduleClonedType as _publicOnScheduleClonedType, type context$1__publicOnScheduleCreatedType as _publicOnScheduleCreatedType, type context$1__publicOnScheduleUpdatedType as _publicOnScheduleUpdatedType, context$1_cancelSchedule as cancelSchedule, context$1_createSchedule as createSchedule, context$1_getSchedule as getSchedule, context$1_onScheduleCancelled as onScheduleCancelled, context$1_onScheduleCloned as onScheduleCloned, context$1_onScheduleCreated as onScheduleCreated, context$1_onScheduleUpdated as onScheduleUpdated, onScheduleCancelled$1 as publicOnScheduleCancelled, onScheduleCloned$1 as publicOnScheduleCloned, onScheduleCreated$1 as publicOnScheduleCreated, onScheduleUpdated$1 as publicOnScheduleUpdated, context$1_querySchedules as querySchedules, context$1_updateSchedule as updateSchedule };
 }
 
+/**
+ * Information about the start and end dates of the first and last
+ * [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)
+ * that belong to a [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)
+ * and whether any events follow an unlimited repetition pattern.
+ */
 interface ScheduleTimeFrame {
     /**
-     * The schedule ID.
+     * ID of the [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * to which the time frame belongs.
      * @readonly
      */
     _id?: string | null;
     /**
-     * The schedule time frame status.
+     * Information about the presence of recurring events within the schedule.
      *
-     * The possible values are:
-     * - `"NONE"` Time frame is not defined since there are no schedule events.
-     * - `"FINITE"` Time frame is finite. I.e, with defined start and end dates.
-     * - `"INFINITE"` Time frame is infinite, since there is at least one recurring event which repeats forever.
+     * Supported values:
+     * + `NONE`: No [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object) are scheduled within the schedule.
+     * + `FINITE`: All recurring events within the schedule have a defined end date, or there are no recurring events.
+     * + `INFINITE`: At least one recurring event within the schedule has no end date, meaning it follows an unlimited repetition pattern.
      * @readonly
      */
     status?: Status;
     /**
-     * The schedule's first event start date.
+     * Start date of the first [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * within the schedule. Identical to `event.start.localDate`. Available only if
+     * `status` is set to `FINITE` or `INFINITE`.
      * @readonly
      */
     firstEventStartDate?: ZonedDate;
     /**
-     * The schedule's last event end date.
+     * End date of the last [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * belonging to the schedule. Identical to `event.end.localDate`. Available only if
+     * `status` is set to `FINITE` or `INFINITE`.
      * @readonly
      */
     lastEventEndDate?: ZonedDate;
     /**
-     * First event start date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * Start date of the first [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * belonging to the schedule, adjusted to `timeZone` of the
+     * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or the `timeZone` specified in the request.
+     * Identical to `event.adjustedStart.localDate`.
      * @readonly
      */
     adjustedFirstEventStartDate?: ZonedDate;
     /**
-     * Last event end date adjusted to the Wix Business time zone, or `request.timeZone` if provided.
+     * End date of the last [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
+     * belonging to the schedule, adjusted to `timeZone` of the
+     * [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
+     * or the `timeZone` specified in the request.
+     * Identical to `event.adjustedEnd.localDate`.
      * @readonly
      */
     adjustedLastEventEndDate?: ZonedDate;
     /**
-     * The revision number, which incremented on updates.
+     * Revision number, which increments by 1 each time the schedule time frame is updated.
      * @readonly
      */
     revision?: string | null;
 }
 declare enum Status {
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
-    /** Time frame is not defined since there are no schedule events. */
+    /** No [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object) that belong to the schedule. */
     NONE = "NONE",
-    /** Time frame is finite. I.e, with defined start and end dates. */
+    /** There are no recurring events or all recurring events belonging to the schedule have a defined end date. */
     FINITE = "FINITE",
-    /** Time frame is infinite, since there is at least one recurring event which repeats forever. */
+    /** At least one recurring event belonging to the schedule has an unlimited repetition pattern (no end date). */
     INFINITE = "INFINITE"
 }
 /** A date time with a time zone, having the UTC offset and date determined by the server. */
@@ -5575,33 +6167,43 @@ interface ZonedDate {
     utcDate?: Date | null;
 }
 interface ScheduleTimeFrameUpdatedWithMetadata {
-    /** The updated schedule timeframe. */
+    /** Updated schedule time frame. */
     scheduleTimeFrame?: ScheduleTimeFrame;
 }
 interface GetScheduleTimeFrameRequest {
-    /** The schedule ID. */
+    /**
+     * [Schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * ID for which to retrieve the schedule time frame.
+     */
     _id: string | null;
     /**
-     * Optional time zone used to adjust the returned time.
-     * Default is the Wix Business time zone.
+     * Time zone for adjusting the times of the returned schedule time frame.
+     *
+     * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
      */
     timeZone?: string | null;
 }
 interface GetScheduleTimeFrameResponse {
-    /** The schedule time frame. */
+    /** Retrieved schedule time frame. */
     scheduleTimeFrame?: ScheduleTimeFrame;
 }
 interface ListScheduleTimeFramesRequest {
-    /** The schedule IDs. */
+    /**
+     * IDs of the schedules for which to retrieve schedule time frames.
+     *
+     * Min: 1 schedule ID
+     * Max: 100 schdule IDs
+     */
     ids: string[];
     /**
-     * Optional time zone used to adjust the returned time.
-     * Default is the Wix Business time zone.
+     * Time zone for adjusting the times of the returned schedule time frames.
+     *
+     * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
      */
     timeZone?: string | null;
 }
 interface ListScheduleTimeFramesResponse {
-    /** The schedules time frames. */
+    /** Retrieved schedule time frames. */
     scheduleTimeFrames?: ScheduleTimeFrame[];
 }
 /** Encapsulates all details written to the Greyhound topic when a site's properties are updated. */
@@ -6036,15 +6638,17 @@ interface ScheduleTimeFrameUpdatedEnvelope {
 }
 interface GetScheduleTimeFrameOptions {
     /**
-     * Optional time zone used to adjust the returned time.
-     * Default is the Wix Business time zone.
+     * Time zone for adjusting the times of the returned schedule time frame.
+     *
+     * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
      */
     timeZone?: string | null;
 }
 interface ListScheduleTimeFramesOptions {
     /**
-     * Optional time zone used to adjust the returned time.
-     * Default is the Wix Business time zone.
+     * Time zone for adjusting the times of the returned schedule time frames.
+     *
+     * Default: `timeZone` of the [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/properties-object)
      */
     timeZone?: string | null;
 }
@@ -6052,17 +6656,24 @@ interface ListScheduleTimeFramesOptions {
 declare function getScheduleTimeFrame$1(httpClient: HttpClient): GetScheduleTimeFrameSignature;
 interface GetScheduleTimeFrameSignature {
     /**
-     * Retrieves the schedule time frame by schedule ID.
-     * @param - The schedule ID.
-     * @returns The schedule time frame.
+     * Retrieves a schedule time frame by schedule ID.
+     * @param - [Schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
+     * ID for which to retrieve the schedule time frame.
+     * @returns Retrieved schedule time frame.
      */
     (_id: string | null, options?: GetScheduleTimeFrameOptions | undefined): Promise<ScheduleTimeFrame & ScheduleTimeFrameNonNullableFields>;
 }
 declare function listScheduleTimeFrames$1(httpClient: HttpClient): ListScheduleTimeFramesSignature;
 interface ListScheduleTimeFramesSignature {
     /**
-     * Retrieves a list of schedule time frame by schedules ID.
-     * @param - The schedule IDs.
+     * Retrieves a list of schedule time frames by schedules ID.
+     *
+     *
+     * Sorted by schedule ID in ascending order.
+     * @param - IDs of the schedules for which to retrieve schedule time frames.
+     *
+     * Min: 1 schedule ID
+     * Max: 100 schdule IDs
      */
     (ids: string[], options?: ListScheduleTimeFramesOptions | undefined): Promise<ListScheduleTimeFramesResponse & ListScheduleTimeFramesResponseNonNullableFields>;
 }
@@ -6074,7 +6685,9 @@ declare const getScheduleTimeFrame: MaybeContext<BuildRESTFunction<typeof getSch
 declare const listScheduleTimeFrames: MaybeContext<BuildRESTFunction<typeof listScheduleTimeFrames$1> & typeof listScheduleTimeFrames$1>;
 
 type _publicOnScheduleTimeFrameUpdatedType = typeof onScheduleTimeFrameUpdated$1;
-/** */
+/**
+ * Triggered when a schedule time frame is updated.
+ */
 declare const onScheduleTimeFrameUpdated: ReturnType<typeof createEventModule<_publicOnScheduleTimeFrameUpdatedType>>;
 
 type context_ActionEvent = ActionEvent;