@wix/auto_sdk_bookings_multi-service-availability-time-slots 1.0.156 → 1.0.158

package/build/es/meta.d.mts

@@ -2,193 +2,185 @@ import { ListMultiServiceAvailabilityTimeSlotsRequest as ListMultiServiceAvailab
 import '@wix/sdk-types';
 
 /**
- * The `TimeSlot` object represents the availability information
- * for an `Appointment` service's specific slot, including:
+ * A time slot represents a specific time period when a service is available for booking.
+ * It provides all the information needed to display availability to customers, including whether customers can actually book it, the remaining capacity, and which staff members or resources are available.
+ * Available time slots may not always be bookable due to service booking policies - when this occurs, the time slot includes information about the specific booking restrictions.
  *
- * 1. Whether the slot is bookable for the given service?
- *
- * 2. In what location the service is available for this slot?
- *
- * 3. Which available resources can provide the service for this slot?
- *
- * 4. Does booking the slot for the service violates any of the service booking policies?
- *
- * 5. What is the total capacity and remaining capacity of the service at the time of the calculation of the `TimeSlot`?
- *
- * > __Note:__
- * > When the `TimeSlot` has a non empty `NestedTimeSlots`, it represents the availability information
- * > for a given list of `Appointment` services within a specific time slot.
+ * For multi-service bookings, the top-level time slot acts as a container spanning the entire service sequence (from the start of the first service to the end of the last service). Individual service details are provided in nested time slots.
  */
 interface TimeSlot {
     /**
-     * Service ID.
+     * Service ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)).
      *
-     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
-     * > Instead, each nested time slot has its own serviceId.
+     * Available only for single-service bookings. For multi-service bookings, this field is empty and individual service IDs are provided in `nestedTimeSlots`.
      * @format GUID
      */
     serviceId?: string | null;
     /**
-     * Local start date of the time slot in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     *
+     * For multi-service bookings, this represents the start time of the first service in the sequence.
      * @format LOCAL_DATE_TIME
      */
     localStartDate?: string | null;
     /**
-     * Local end date of the time slot in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T14:00:00`.
+     *
+     * For multi-service bookings, this represents the end time of the last service in the sequence.
      * @format LOCAL_DATE_TIME
      */
     localEndDate?: string | null;
     /**
-     * Whether the slot is bookable according to the service's booking policies.
+     * Whether customers can book the slot according to the service's booking policies ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policies/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction)).
      *
-     * If booking this time slot does not violates any of the service's booking policies,
-     * the returned value is `true`. Otherwise, returns `false`.
+     * For multi-service bookings, this is `true` only when all services in the sequence comply with their respective booking policies.
      */
     bookable?: boolean | null;
-    /** The geographic location of the slot. */
+    /** Information about where the business provides the service to the customer. */
     location?: Location;
-    /** The event information if the time slot is an event based slot. */
+    /**
+     * Information about the event ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)) related to the slot.
+     * Available only for classes. Not available for appointment-based services and courses.
+     */
     eventInfo?: EventInfo;
     /**
      * Total number of spots for the slot.
+     *
+     * For multi-service bookings, this is always `1` because customers book the entire service sequence as a single unit.
      * @min 1
      * @max 1000
      */
     totalCapacity?: number | null;
     /**
      * Remaining number of spots for the slot.
-     * For example, for an appointment service with total capacity of 1 spot and one booked spot, the remaining capacity will be 0.
+     * This is calculated as total capacity minus booked spots, but doesn't account for waitlist reservations.
+     *
+     * If the service has a waitlist enabled, use `bookableCapacity` instead to get the accurate number of spots customers can actually book.
+     *
+     * For single-service bookings: An appointment service with total capacity of 3 spots and 1 booked spot results in a remaining capacity of `2`.
+     * For multi-service bookings: This is either `1` (sequence available) or `0` (sequence unavailable).
      * @max 1000
      */
     remainingCapacity?: number | null;
     /**
-     * Number of spots in the slot that are available for booking.
-     * This is calculated as the remaining capacity minus the spots reserved for the waiting list.
+     * Number of spots that customers can book for the slot.
+     * Calculated as the remaining capacity minus the spots reserved for the waitlist.
+     * If the service has no waitlist, identical to `remainingCapacity`.
+     *
+     * For multi-service bookings, this is either `1` (sequence can be booked) or `0` (sequence cannot be booked).
      */
     bookableCapacity?: number | null;
     /**
-     * Indicators for booking policy violations for the slot.
+     * Information about booking policy violations for the slot.
      *
-     * Each nested field is checked on its own. i.e. if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we will return also slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * For multi-service bookings, this aggregates violations from all services in the sequence.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * List of `AvailableResources` for the time slot.
-     * Each `AvailableResources` contains information about available resources of the same type.
+     * List of resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) available during the time slot.
      *
-     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
-     * > Instead, each nested time slot has its own available resources.
+     * Available only for single-service bookings. For multi-service bookings, resource information is provided in `nestedTimeSlots`.
      */
     availableResources?: AvailableResources[];
     /**
-     * > Nested time slots.
-     * > Returned only from `MultiServiceAvailabilityTimeSlots` API calls.
+     * Nested time slots for multi-service bookings.
+     * Each nested slot represents 1 service in the sequence, ordered according to the service sequence specified in the request.
+     *
+     * Available only for multi-service bookings. Empty for single-service bookings.
      * @maxSize 8
      */
     nestedTimeSlots?: NestedTimeSlot[];
-    /** Reasons why the time slot is not available for booking. */
+    /** Information about why customers can't book the time slot. */
     nonBookableReasons?: NonBookableReasons;
     /**
-     * The schedule ID associated with this time slot.
-     * Same as the service’s schedule ID.
+     * Schedule ID associated with this time slot.
+     * Same as the service's schedule ID.
      * @format GUID
      */
     scheduleId?: string | null;
 }
 interface Location {
     /**
-     * Business Location ID. Present only if the location is a business location.
+     * Location ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/introduction)).
+     * Available only for business locations.
      * @format GUID
      */
     id?: string | null;
-    /** The location name. */
+    /** Location name. */
     name?: string | null;
-    /** A string representation for the full address of the location. */
+    /** Formatted location address. */
     formattedAddress?: string | null;
-    /**
-     * The type of location:
-     * - `CUSTOM`: The location is specific to this service, and is not derived from the business location.
-     * - `BUSINESS`: A business location, either the default business address, or locations defined for the business by the Business Info.
-     * - `CUSTOMER`: The location is determined by the customer and is not set up beforehand.
-     */
+    /** Location type. */
     locationType?: LocationTypeWithLiterals;
 }
 declare enum LocationType {
     UNKNOWN_LOCATION_TYPE = "UNKNOWN_LOCATION_TYPE",
     /** A business location, either the default business address, or locations defined for the business by the Business Info. */
     BUSINESS = "BUSINESS",
-    /** The location is unique to this service and isn't defined as one of the business locations. */
+    /** The location is unique to this service and isn't defined as 1 of the business locations. */
     CUSTOM = "CUSTOM",
-    /** The location can be determined by the customer and is not set up beforehand. */
+    /** The location can be determined by the customer and isn't set up beforehand. */
     CUSTOMER = "CUSTOMER"
 }
 /** @enumType */
 type LocationTypeWithLiterals = LocationType | 'UNKNOWN_LOCATION_TYPE' | 'BUSINESS' | 'CUSTOM' | 'CUSTOMER';
-/** relevant for event based slots, and not for availability based slots */
+/** Available for event based slots, and not for availability based slots */
 interface EventInfo {
     /**
-     * The event ID.
+     * Event ID.
      * @minLength 36
      * @maxLength 250
      */
     eventId?: string | null;
-    /** Waiting list details for the event, if enabled in the service's booking policy. */
+    /** Information about the event's waitlist. Available only if the service has a waitlist. */
     waitingList?: WaitingList;
 }
 interface WaitingList {
     /**
-     * Total number of spots in the waiting list.
+     * Total number of spots in the waitlist.
      * @min 1
      */
     totalCapacity?: number | null;
     /**
-     * Number of remaining spots in the waiting list.
-     * For example, a yoga event with a capacity of `10` and `3` registrants will have a `remainingCapacity` of `7`.
+     * Number of remaining spots in the waitlist.
+     * For example, an event with a waitlist for 10 people and 3 registrants, results in a remaining capacity of `7`.
      */
     remainingCapacity?: number | null;
 }
 interface BookingPolicyViolations {
-    /** Bookings policy violation. Too early to book this slot. */
+    /** Whether it's too early for customers to book the slot. */
     tooEarlyToBook?: boolean | null;
-    /** The earliest time at which booking for this slot is allowed, in UTC format (`YYYY-MM-DDThh:mm:ss.sssZ`). */
+    /** Earliest time for booking the slot in `YYYY-MM-DDThh:mm:ss.sssZ` format. */
     earliestBookingDate?: Date | null;
-    /** Bookings policy violation. Too late to book this slot. */
+    /** Whether it's too late for customers to book the slot. */
     tooLateToBook?: boolean | null;
-    /** Bookings policy violation. Online booking is disabled for the `TimeSlot` service. */
+    /** Whether customers can book the service online. */
     bookOnlineDisabled?: boolean | null;
 }
 interface AvailableResources {
     /**
-     * Resource type ID.
+     * Resource type ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)).
      * @format GUID
      */
     resourceTypeId?: string | null;
     /**
-     * Available resources for the time slot.
+     * Details about resources available during the time slot.
      *
-     * + When returned from `ListAvailabilityTimeSlots`, empty by default.
-     * + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * contains __up__ to 10 available resources out of those provided.
+     * Behavior varies by method:
      *
-     * + When returned from `GetAvailabilityTimeSlots`, contains all available resources by default.
-     * + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * contains all of the available resources out of those provided.
+     * List methods (List Availability Time Slots and List Multi Service Availability Time Slots):
+     * - Empty by default.
+     * - Up to 10 resources when specifying `includeResourceTypeIds` or `resourceIds` in the request.
      *
-     *
-     * > + When returned from `ListMultiServiceAvailabilityTimeSlots`, empty by default.
-     * > + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * > contains __up__ to 10 available resources out of those provided.
-     *
-     * > + When returned from `GetMultiServiceAvailabilityTimeSlots`, contains all available resources by default.
-     * > + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * > contains all of the available resources out of those provided.
+     * Get methods (Get Availability Time Slots and Get Multi Service Availability Time Slots):
+     * - All resources by default.
+     * - Filtered resources when specifying `includeResourceTypeIds` or `resourceIds` in the request.
      */
     resources?: Resource[];
     /**
-     * Whether there are more available resources for the slot that are not listed in `resources` due to size limitations.
+     * Whether there are more available resources for the slot than those listed in `resources`.
      * @readonly
      */
     hasMoreAvailableResources?: boolean | null;
@@ -212,20 +204,19 @@ interface NestedTimeSlot {
      */
     serviceId?: string;
     /**
-     * Local start date of the nested time slot in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the nested time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localStartDate?: string;
     /**
-     * Local end date of the nested time slot in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the nested time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localEndDate?: string;
     /**
-     * List of `AvailableResources` for the nested time slot.
-     * Each `AvailableResources` contains information about available resources of the same type.
+     * List of resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) available during the nested time slot.
      * @maxSize 10
      */
     availableResources?: AvailableResources[];
@@ -237,129 +228,76 @@ interface NestedTimeSlot {
     scheduleId?: string | null;
 }
 interface NonBookableReasons {
-    /** The slot is fully booked with no remaining capacity. */
+    /** Whether the slot is fully booked with no remaining capacity. */
     noRemainingCapacity?: boolean | null;
-    /** Booking this slot would violate the service's booking policy. */
+    /** Whether booking the slot violates any of the service's booking policies. */
     violatesBookingPolicy?: boolean | null;
-    /** The slot is reserved for the waiting list and not available for direct booking. */
+    /** Whether the slot is reserved for the waitlist. A new customer can't book the reserved slot. */
     reservedForWaitingList?: boolean | null;
 }
 interface ListMultiServiceAvailabilityTimeSlotsRequest {
     /**
-     * Services for which the multiService time slots are being returned for.
-     * Each service contains its own resources filters within.
-     *
-     * MinSize: `2`.
-     * MaxSize: `8`.
+     * Services for which the multi-service time slots are returned.
+     * Each service can include its own resource filters.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @maxSize 8
      */
     services?: Service[];
     /**
-     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Lower boundary for `localStartDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localStartDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     fromLocalDate?: string | null;
     /**
-     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
-     *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Upper boundary for `localToDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localEndDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     toLocalDate?: string | null;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values. For example, `America/New_York` or `UTC`.
+     *
+     * Required unless you specify `cursorPaging.cursor`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * Location for which the multiService TimeSlots are being returned for.
+     * Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
      *
-     * You can specify location or location type for which the TimeSlots will be returned for.
-     * If locationType is `BUSINESS`, you __must__ provide a locationId.
-     *
-     * <blockquote class="warning">
-     * <p><strong>warning:</strong><br/>
-     * Supports filtering by location type, or by location ID. </br>
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      */
     location?: Location;
     /**
-     * Whether the `TimeSlot` is bookable according to all of the services booking policies.
-     *
-     * If booking any of the `TimeSlot`.`NestedTimeSlot`s violates any of its services bookings policies,
-     * returns as `false`. Otherwise, returns as `true`.
-     *
-     * > __Note:__
-     * > A `TimeSlot` with a `NestedTimeSlot` that doesn't meet its service's bookings policies will be returned with `bookable` = false,
-     * > while a `TimeSlot` with no available resources will not be returned at all.
+     * Whether the time slot is bookable according to all services' booking policies.
+     * If not specified, returns both bookable and non-bookable time slots.
      */
     bookable?: boolean | null;
     /**
-     * Indicators for service's booking policy violations for booking the `TimeSlot`.
-     *
-     * A bookable time slot must not violate any policy,
-     * therefor, this filter is only relevant when `bookable` filter is false.
-     *
-     * Each nested field is checked on all `NestedTimeSlot`s. For example, if only one of the `NestedTimeSlot`'s
-     * has a service with `tooEarlyToBook` same as in the request, we return the `TimeSlot` regardless of whether
-     * the other `NestedTimeSlots` has the same `tooEarlyToBook` as in request.
-     *
-     * Each nested field is checked on its own. For example, if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we return slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * Indicators for service's booking policy violations.
+     * Only relevant when `bookable` filter is false.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * Maximum number of slots to load for each day. For example, if `timeSlotsPerDay` is set to `3`,
-     * we return at most 3 available TimeSlots for each day within the date range specified in request.
-     *
-     * By default,
-     * if `bookable` filter was not specified,
-     * and a day has both `bookable` and `un-bookable` slots, `bookable` slots are returned first.
-     *
-     * If the number of `bookable` slots is less than the requested `timeSlotsPerDay`,
-     * `un-bookable` slots will be returned according to the specified filters.
+     * Maximum number of slots to return for each day in the specified time range.
+     * If `bookable` filter isn't specified, bookable slots are returned first.
      */
     timeSlotsPerDay?: number | null;
     /**
-     * CursorPaging.
-     *
-     * Enables you to fetch TimeSlots in smaller, more manageable chunks
-     * by setting a limit on the number of results returned in response.
-     * This is useful in order to enhance efficiency of data retrieval and reduce load on both the client and server.
-     *
-     * If there are more results than the specified limit, the response will contain a `cursorPagingMetaData`
-     * with a cursor pointing to next page of results. In order to fetch the next page of results, you should pass the
-     * returned cursor to the next call as `cursorPaging`.`cursor`.
-     *
-     * For the first call, you should only specify the `limit` for the results page.
-     * For each following call, you should only pass the previous returned cursor as `cursorPaging`.`cursor`
-     * the `cursorPaging`.`limit`. You may pass a different `limit`.
-     * No need to specify any additional parameters.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * If you only provide a <code class="grey-background">cursorPaging</code>. <code class="grey-background">cursor</code>,
-     * the response will contain the default size of results which is `1000`.
-     * </p>
-     * </blockquote>
+     * Cursor-based paging configuration.
+     * Enables fetching results in smaller chunks by setting a limit on the number of results.
+     * For consistent pagination behavior, use the same `limit` value throughout a pagination sequence.
+     * When specifying a new `limit` in follow-up requests, the API respects the new value.
      */
     cursorPaging?: CursorPaging;
 }
@@ -370,18 +308,18 @@ interface Service {
      */
     serviceId?: string;
     /**
-     * Resources to include in response.
+     * ID of the resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) to include in response.
      * @format GUID
      * @maxSize 135
      */
     resourceIds?: string[];
     /**
-     * The resource type ID's to include in returned time slots.
+     * Resource type IDs ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)) to include in returned time slots.
      * This is in addition to the specifically requested resources.
      *
-     * <blockquote class="important">
+     * <blockquote>
      * Currently supported only for Staff Member resource type.
-     * Staff Member type ID: 1cd44cf8-756f-41c3-bd90-3e2ffcaf1155
+     * Staff members belong to resource type ID `cd44cf8-756f-41c3-bd90-3e2ffcaf1155`.
      * </blockquote>
      * @format GUID
      * @maxSize 100
@@ -389,9 +327,9 @@ interface Service {
     includeResourceTypeIds?: string[];
     /**
      * Selected customer choices.
-     * If specified, the selected choices will be used to calculate service configuration.
-     * If not specified, the service default configuration will be used.
-     * Enforcing this field is the responsibility of the SPI implementer, and not by the Availability API.
+     * If specified, the selected choices are used to calculate service configuration.
+     * If not specified, the service default configuration is used.
+     * Enforcing this field is the responsibility of the service plugin implementer, and not the Time Slots V2 API.
      */
     customerChoices?: V2CustomerChoices;
 }
@@ -401,22 +339,24 @@ interface Service {
  */
 interface V2CustomerChoices {
     /**
-     * The selected customer duration in minutes.
-     * Min: `1 minute`
-     * Max: `44639 minutes` (30 days, 23 hours, and 59 minutes)
+     * Selected customer duration in minutes.
+     * Min: `1` minute
+     * Max: `44639` minutes (30 days, 23 hours, and 59 minutes)
+     * Default: `15` minutes
      * @min 1
      * @max 44639
      */
     durationInMinutes?: number | null;
     /**
-     * The selected add-ons IDs.
-     * Max: Derived from max amount of Add-On groups * max amount of Add-Ons per group.
+     * Selected add-on IDs.
+     *
+     * Max: Calculated as the product of the maximum number of add-on groups multiplied by the maximum number of add-ons per group. Currently 21 (3 groups × 7 add-ons per group), but may change in the future.
      * @format GUID
      * @maxSize 21
      */
     addOnIds?: string[] | null;
     /**
-     * The selected duration choice ID.
+     * Selected duration choice ID.
      * @format GUID
      */
     durationChoiceId?: string | null;
@@ -441,29 +381,22 @@ interface CursorPaging {
 }
 interface ListMultiServiceAvailabilityTimeSlotsResponse {
     /**
-     * Time slots.
+     * Retrieved time slots.
+     * Sorted by `localStartDate` in ascending order. When multiple slots have the same start time, no specific secondary sorting is guaranteed.
      * @maxSize 1000
      */
     timeSlots?: TimeSlot[];
     /**
-     * Time zone, in IANA time zone format.
-     * Shared for all TimeSlots in response.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * CursorPagingMetaData.
-     * Contains information about the next page of results.
-     *
-     * By default,
-     * if there are more than 1000 results,
-     * the response will contain a `cursorPagingMetaData` with a cursor to the next page of results.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * <code class="grey-background">count</code> is not supported.</p>
-     * </blockquote>
+     * Paging metadata for the next page of results.
+     * Contains a cursor if there are more than 1000 results.
      */
     cursorPagingMetadata?: CursorPagingMetadata;
 }
@@ -485,51 +418,47 @@ interface Cursors {
 }
 interface GetMultiServiceAvailabilityTimeSlotRequest {
     /**
-     * Services for which the multiService TimeSlots are being returned for.
-     * Each service contains its own resources filters within.
-     *
-     * MinSize: 2.
-     * MaxSize: 8.
+     * Services for which the multi-service time slots are returned.
+     * You can specify resource filters for each service.
      * @minSize 2
      * @maxSize 8
      */
     services: Service[];
     /**
-     * Local start date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localStartDate: string;
     /**
-     * Local end date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localEndDate: string;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone: string | null;
     /**
-     * The location of the time slot.
+     * Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
      *
-     * You must provide a specific `locationType`.
-     * If locationType is `BUSINESS`, you __must__ also provide a `locationId`.
-     *
-     * <blockquote class="warning">
-     * <p>Supports filtering by location type, or by location ID.
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
+     * Required unless you specify `cursorPaging.cursor`.
      */
     location: Location;
 }
 interface GetMultiServiceAvailabilityTimeSlotResponse {
-    /** Time slot. */
+    /** Retrieved time slot. */
     timeSlot?: TimeSlot;
     /**
-     * The time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */