@wix/auto_sdk_bookings_bookings 1.0.40 → 1.0.42

package/build/cjs/meta.d.ts

@@ -4,16 +4,19 @@ import '@wix/sdk-types';
 /** An entity representing a scheduled appointment, class session, or course. */
 interface Booking extends BookingParticipantsInfoOneOf {
     /**
-     * Total number of participants. Available only when the relevant service
-     * doesn't have _variants and options_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
+     * Total number of participants.
+     * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer variants and options ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * @min 1
      */
     totalParticipants?: number;
     /**
-     * Information about the booked service choices and participants.
-     * Available only when the booking includes multiple _service variants_
+     * Information about the booked service choices and participant count for each choice.
+     * When creating a booking, use this field only if the booking includes multiple service variants
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
+     *
+     * For example, use this for a spa package booking that includes different service levels:
+     * - 2 participants chose "Standard Package".
+     * - 1 participant chose "VIP Package".
      */
     participantsChoices?: ParticipantChoices;
     /**
@@ -23,15 +26,24 @@ interface Booking extends BookingParticipantsInfoOneOf {
      */
     id?: string | null;
     /**
-     * An object describing the *slot*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability-calendar/query-availability) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability))
-     * or *schedule*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction))
-     * that was booked.
+     * An object describing the bookable entity - either a specific time slot or a recurring schedule.
+     *
+     * The structure depends on the type of service being booked:
+     *
+     * *For appointment services:** Use `slot` to book a specific time slot with a
+     * service provider. Appointments are typically one-time sessions at a specific date and time.
+     *
+     * *For class services:** Use `slot` to book a specific class session. Classes
+     * are individual sessions that can have multiple participants.
+     *
+     * *For course services:** Use `schedule` to book an entire course consisting of
+     * multiple sessions over time. Courses are recurring, multi-session offerings.
+     *
+     * Choose the appropriate field based on your service type and booking requirements.
      */
     bookedEntity?: BookedEntity;
     /**
-     * Contact details of the site visitor or *member*
+     * Contact details of the site visitor or member
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/members/members/introduction) | [REST](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/introduction))
      * making the booking.
      */
@@ -46,20 +58,27 @@ interface Booking extends BookingParticipantsInfoOneOf {
      */
     status?: BookingStatusWithLiterals;
     /**
-     * The payment status of the booking corresponds to the `paymentStatus` of the
-     * related *eCommerce order*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/setup)| [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction)),
-     * if one exists. All payment statuses are supported for every booking `status`.
+     * The payment status of the booking. This field automatically syncs with the
+     * `paymentStatus` of the corresponding eCommerce order
+     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/setup)| [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction))
+     * when customers use Wix eCommerce checkout.
+     *
+     * ## Integration patterns
+     *
+     * *When using Wix eCommerce checkout:** Wix Bookings automatically syncs the payment status based on the eCommerce order's payment status.
+     * Do not manually update this field.
+     *
+     * *When using custom payment flows:** You can manually update the payment status with Confirm Booking or Decline Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/confirm-or-decline-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking)) to reflect the customer's payment state.
+     *
+     * *For membership/pricing plan payments:** Wix Bookings automatically manages the payment status when customers pay with an active pricing plan ([SDK](https://dev.wix.com/docs/sdk/backend-modules/pricing-plans/plans/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/pricing-plans/pricing-plans/introduction)) subscription.
+     *
+     * All payment statuses are supported for every booking `status`.
      */
     paymentStatus?: PaymentStatusWithLiterals;
     /**
-     * Payment option selected by the customer. If the customer hasn't completed their
-     * checkout, they may still change the payment method. Must be one of the payment
-     * options offered by the service ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)),
-     * unless `skipSelectedPaymentOptionValidation` is `true`.
-     * When undefined during an *eCommerce checkout*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)),
-     * Wix Bookings uses the service's default payment option
+     * Payment option selected by the customer. If the customer hasn't completed their checkout, they may still change the payment method. Must be one of the payment options offered by the service ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)), unless `skipSelectedPaymentOptionValidation` is `true`.
+     *
+     * When undefined during an eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)), Wix Bookings uses the service's default payment option
      */
     selectedPaymentOption?: SelectedPaymentOptionWithLiterals;
     /**
@@ -70,10 +89,8 @@ interface Booking extends BookingParticipantsInfoOneOf {
     /** External user ID that you can provide. */
     externalUserId?: string | null;
     /**
-     * Revision number to be used when updating, rescheduling, or cancelling the
-     * booking. Increments by 1 each time the booking is updated, rescheduled, or
-     * canceled. To prevent conflicting changes, the current revision must be
-     * specified when updating the booking.
+     * Revision number to be used when updating, rescheduling, or cancelling the booking.
+     * Increments by 1 each time the booking is updated, rescheduled, or canceled. To prevent conflicting changes, the current revision must be specified when updating the booking.
      */
     revision?: string | null;
     /**
@@ -114,50 +131,64 @@ interface Booking extends BookingParticipantsInfoOneOf {
 /** @oneof */
 interface BookingParticipantsInfoOneOf {
     /**
-     * Total number of participants. Available only when the relevant service
-     * doesn't have _variants and options_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
+     * Total number of participants.
+     * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer variants and options ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * @min 1
      */
     totalParticipants?: number;
     /**
-     * Information about the booked service choices and participants.
-     * Available only when the booking includes multiple _service variants_
+     * Information about the booked service choices and participant count for each choice.
+     * When creating a booking, use this field only if the booking includes multiple service variants
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
+     *
+     * For example, use this for a spa package booking that includes different service levels:
+     * - 2 participants chose "Standard Package".
+     * - 1 participant chose "VIP Package".
      */
     participantsChoices?: ParticipantChoices;
 }
 /**
- * A multi-service booking is considered available if all individual bookings are available as returned from List Multi Service Availability Time Slots.
+ * A multi-service booking is considered available if all single-service bookings are available as returned from List Multi Service Availability Time Slots.
  * Currently, `SEPARATE_BOOKINGS` and `PARALLEL_BOOKINGS` are not supported.
  * Multi-service booking is available if each of its bookings is available separately.
  * For `SEQUENTIAL_BOOKINGS`, see `List Multi Service Availability Time Slots` documentation.
  */
 declare enum MultiServiceBookingType {
+    /** You must schedule single-service bookings back-to-back with each booking starting when the previous booking ends */
     SEQUENTIAL_BOOKINGS = "SEQUENTIAL_BOOKINGS",
+    /** Not currently supported. */
     SEPARATE_BOOKINGS = "SEPARATE_BOOKINGS",
+    /** Not currently supported. */
     PARALLEL_BOOKINGS = "PARALLEL_BOOKINGS"
 }
 /** @enumType */
 type MultiServiceBookingTypeWithLiterals = MultiServiceBookingType | 'SEQUENTIAL_BOOKINGS' | 'SEPARATE_BOOKINGS' | 'PARALLEL_BOOKINGS';
 interface BookedEntity extends BookedEntityItemOneOf {
     /**
-     * Booked *slot*
+     * Booked slot
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability-calendar/query-availability) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability)).
-     * Available only for appointment-based services and classes.
-     * For appointment-based services, a new session is created, while for classes,
-     * the booking is automatically linked to the existing session.
+     *
+     * Specify `slot` when creating bookings for:
+     * - **Appointment-based services:** Individual sessions with service providers (consultations, treatments).
+     * Wix Bookings creates a new session when the booking is confirmed.
+     * - **Class services:** Group sessions at specific times (fitness classes, workshops).
+     * Wix Bookings links the booking to an existing scheduled session.
+     *
+     * For course services, specify `schedule` instead of `slot`.
      */
     slot?: BookedSlot;
     /**
-     * Booked *schedule*
+     * Booked schedule
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)).
-     * Available only for course bookings.
+     *
+     * Specify `schedule` when creating bookings for:
+     * - **Course services:** Multi-session offerings spanning weeks or months (educational courses, training programs).
+     * Wix Bookings enrolls participants in all sessions defined by the course schedule.
      */
     schedule?: BookedSchedule;
     /**
      * Session title at the time of booking. If there is no pre-existing session,
-     * for example for appointment-based services, `title` is set to the service name.
+     * for example for appointment-based services, Wix Bookings sets `title` to the service name.
      * @readonly
      * @maxLength 6000
      */
@@ -174,17 +205,25 @@ interface BookedEntity extends BookedEntityItemOneOf {
 /** @oneof */
 interface BookedEntityItemOneOf {
     /**
-     * Booked *slot*
+     * Booked slot
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability-calendar/query-availability) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability)).
-     * Available only for appointment-based services and classes.
-     * For appointment-based services, a new session is created, while for classes,
-     * the booking is automatically linked to the existing session.
+     *
+     * Specify `slot` when creating bookings for:
+     * - **Appointment-based services:** Individual sessions with service providers (consultations, treatments).
+     * Wix Bookings creates a new session when the booking is confirmed.
+     * - **Class services:** Group sessions at specific times (fitness classes, workshops).
+     * Wix Bookings links the booking to an existing scheduled session.
+     *
+     * For course services, specify `schedule` instead of `slot`.
      */
     slot?: BookedSlot;
     /**
-     * Booked *schedule*
+     * Booked schedule
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)).
-     * Available only for course bookings.
+     *
+     * Specify `schedule` when creating bookings for:
+     * - **Course services:** Multi-session offerings spanning weeks or months (educational courses, training programs).
+     * Wix Bookings enrolls participants in all sessions defined by the course schedule.
      */
     schedule?: BookedSchedule;
 }
@@ -196,35 +235,25 @@ interface BookedSlot {
     /** Schedule ID. */
     scheduleId?: string;
     /**
-     * ID of the corresponding *event*
+     * ID of the corresponding 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)).
      * Available for both appointment and class bookings, not available for course bookings.
-     * For appointment-based services, Wix Bookings automatically populates `eventId`
-     * when the booking `status` changes to `CONFIRMED`. For class bookings, it's
-     * automatically populated upon booking creation.
+     * For appointment-based services, Wix Bookings automatically populates `eventId` when the booking `status` changes to `CONFIRMED`.
+     * For class bookings, Wix Bookings automatically populates `eventId` upon booking creation.
      * @minLength 36
      * @maxLength 250
      */
     eventId?: string | null;
-    /**
-     * The start time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
-     * format.
-     */
+    /** The start time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format. */
     startDate?: string | null;
-    /**
-     * The end time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
-     * format.
-     */
+    /** The end time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format. */
     endDate?: string | null;
-    /** The timezone according to which the slot was shown to the user when booking, and should be shown in the future. */
+    /** The time zone according to which the slot was shown to the user when booking, and should be shown in the future. */
     timezone?: string | null;
     /**
-     * Primary *resource*
-     * ([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))
-     * for the booking. For example, the *staff member*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction))
-     * providing the
-     * service.
+     * Primary resource
+     * ([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)) for the booking.
+     * For example, the staff member ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction)) providing the service.
      */
     resource?: BookedResource;
     /** Location where the session takes place. */
@@ -286,10 +315,7 @@ declare enum LocationType {
 /** @enumType */
 type LocationTypeWithLiterals = LocationType | 'UNDEFINED' | 'OWNER_BUSINESS' | 'OWNER_CUSTOM' | 'CUSTOM';
 interface BookedSchedule {
-    /**
-     * _Schedule ID_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)).
-     */
+    /** Schedule ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)). */
     scheduleId?: string;
     /**
      * Booked service ID.
@@ -297,26 +323,22 @@ interface BookedSchedule {
      */
     serviceId?: string | null;
     /**
-     * _Location_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/introduction))
-     * where the schedule's sessions take place.
+     * Location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/introduction)) where the schedule's sessions take place.
      * @readonly
      */
     location?: Location;
     /**
-     * Timezone in which the slot or session was shown to the customer when they booked.
+     * Time zone in which the slot or session was shown to the customer when they booked.
      * Also used whenever the customer reviews the booking's timing in the future.
      */
     timezone?: string | null;
     /**
-     * Start time of the first session related to the booking in
-     * [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format.
+     * Start time of the first session related to the booking in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format.
      * @readonly
      */
     firstSessionStart?: string | null;
     /**
-     * End time of the last session related to the booking in
-     * [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format.
+     * End time of the last session related to the booking in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format.
      * @readonly
      */
     lastSessionEnd?: string | null;
@@ -443,38 +465,26 @@ declare enum ValueType {
 type ValueTypeWithLiterals = ValueType | 'SHORT_TEXT' | 'LONG_TEXT' | 'CHECK_BOX';
 /** Booking status. */
 declare enum BookingStatus {
-    /**
-     * The booking was created, but the customer hasn't completed the related
-     * eCommerce order yet.
-     */
+    /** The booking was created, but the customer hasn't completed the related eCommerce order yet. */
     CREATED = "CREATED",
     /**
-     * The merchant has confirmed the booking and it appears in the
-     * business calendar. Merchants can set up their *services*
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction))
-     * to automatically confirm all `PENDING` bookings.
+     * The merchant has confirmed the booking and it appears in the business calendar. Merchants can set up their services
+     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)) to automatically confirm all `PENDING` bookings.
      */
     CONFIRMED = "CONFIRMED",
     /**
-     * The customer has canceled the booking. Depending on the relevant service's
-     * _policy snapshot_
+     * The customer has canceled the booking. Depending on the relevant service's policy snapshot
      * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policy-snapshots/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policy-snapshots/introduction))
-     * they may have to pay a _cancellation fee_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-fees/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/booking-fees/introduction)).
+     * they may have to pay a cancellation fee ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-fees/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/booking-fees/introduction)).
      */
     CANCELED = "CANCELED",
-    /**
-     * The merchant must manually confirm the booking before it appears
-     * in the business calendar.
-     */
+    /** The merchant must manually confirm the booking before it appears in the business calendar. */
     PENDING = "PENDING",
     /** The merchant has declined the booking before the customer was charged. */
     DECLINED = "DECLINED",
     /**
      * The booking is on a waitlist.
-     * Currently, you can't call Register to Waitlist
-     * ([REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/waitlist/register-to-waitlist))
-     * for course or appointment bookings, even though this is supported in live sites.
+     * Currently, you can't call Register to Waitlist ([REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/waitlist/register-to-waitlist)) for course or appointment bookings, even though this is supported in live sites.
      * You can call Register to Waitlist only for class session bookings.
      */
     WAITING_LIST = "WAITING_LIST"
@@ -527,7 +537,7 @@ declare enum SelectedPaymentOption {
 type SelectedPaymentOptionWithLiterals = SelectedPaymentOption | 'UNDEFINED' | 'OFFLINE' | 'ONLINE' | 'MEMBERSHIP' | 'MEMBERSHIP_OFFLINE';
 interface ParticipantNotification {
     /**
-     * Whether to send the message about the changes to the customer.
+     * Whether to send a message about the changes to the customer.
      *
      * Default: `false`
      */
@@ -606,8 +616,7 @@ interface ParticipantChoices {
 }
 interface ServiceChoices {
     /**
-     * Number of participants for this _variant_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
+     * Number of participants for this variant ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * @min 1
      */
     numberOfParticipants?: number | null;
@@ -775,7 +784,14 @@ interface CreateBookingFlowControlSettings {
     /**
      * Whether the availability is checked before creating the booking.
      *
-     * When passing `false`, a booking is only created when the slot or schedule is available.
+     * - `false`: A booking is only created when the slot or schedule is available.
+     * - `true`: The booking is created regardless of availability conflicts. Make sure the call's [identity](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities) has the required permissions.
+     *
+     * *Use cases for `true`:**
+     * - Emergency or priority bookings that must be accommodated.
+     * - Administrative bookings that override normal availability rules.
+     * - Testing or demonstration purposes.
+     *
      * Default: `false`.
      */
     skipAvailabilityValidation?: boolean;
@@ -783,7 +799,7 @@ interface CreateBookingFlowControlSettings {
      * Whether `PENDING` bookings are automatically set to `CONFIRMED` for
      * services that normally require the owner's manual confirmation.
      *
-     * Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY` permission scope
+     * Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY` permission
      * when passing `true`.
      * Default: `false`.
      */
@@ -792,7 +808,7 @@ interface CreateBookingFlowControlSettings {
      * Whether customers can pay using a payment method that isn't supported
      * for the service, but that's supported for other services.
      *
-     * Your app must have the `BOOKINGS.MANAGE_PAYMENTS` permission scope when passing
+     * Your app must have the `BOOKINGS.MANAGE_PAYMENTS` permission when passing
      * `true`.
      * Default: `false`.
      */
@@ -1246,47 +1262,58 @@ interface MarkBookingAsPendingFlowControlSettings {
 }
 interface CreateMultiServiceBookingRequest {
     /**
-     * Single-service bookings to combine in a multi-service booking.
+     * Between 2 to 8 new single-service booking specifications to create and combine in a multi-service booking.
+     *
+     * Each single-service booking specification must include `slot` details (`scheduleId`, `startDate`, and `endDate`).
+     * Specify contact details, number of participants, and any additional fields as needed.
+     *
+     * For sequential bookings, ensure the timing allows services to be scheduled back-to-back.
      * @minSize 2
      * @maxSize 8
      */
     bookings: Booking[];
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /**
-     * Whether to send an SMS reminder to the customer 24 hours before the
-     * session starts. The phone number is taken from `contactDetails.phone`.
+     * Whether to send an SMS reminder to the customer 24 hours before the session starts.
+     * Wix Bookings takes the phone number from `contactDetails.phone`.
      *
      * Default: `true`
      */
     sendSmsReminder?: boolean | null;
     /**
      * Whether to ignore specific standard procedures of the Wix Bookings flow.
-     * For example, whether to check availability before updating the status.
+     * For example, whether to skip checking availability before updating the status.
      */
     flowControlSettings?: CreateBookingFlowControlSettings;
     /** Whether to return the created single-service bookings. */
     returnFullEntity?: boolean;
-    /** Multi service booking type. */
+    /**
+     * Multi-service booking type.
+     *
+     * Currently only `SEQUENTIAL_BOOKINGS` is supported.
+     */
     multiServiceBookingType?: MultiServiceBookingTypeWithLiterals;
 }
 interface CreateMultiServiceBookingResponse {
     /**
-     * Created multi service booking.
-     * Contains the booking results in the same order as specified in the request.
+     * Created multi-service booking.
+     * Contains the single-service bookings in the same order as specified in the request.
      */
     multiServiceBooking?: MultiServiceBooking;
 }
+/**
+ * A multi-service booking combines multiple single-service bookings into a package.
+ *
+ * Currently, multi-service bookings support only sequential scheduling where services are scheduled back-to-back at the same location, with each single-service booking starting when the previous 1 ends.
+ */
 interface MultiServiceBooking {
     /**
      * Multi-service booking ID.
      * @format GUID
      */
     id?: string | null;
-    /** The created bookings that are part of the multi-service booking. */
+    /** The single-service bookings that make up the multi-service booking package. */
     bookings?: BookingResult[];
 }
 interface BookingResult {
@@ -1300,22 +1327,17 @@ interface BookingResult {
 }
 interface RescheduleMultiServiceBookingRequest {
     /**
-     * ID of the multi service booking to reschedule.
+     * ID of the multi-service booking to reschedule.
      * @format GUID
      */
     multiServiceBookingId: string | null;
     /** Information about the single-service bookings to reschedule. */
     rescheduleBookingsInfo: RescheduleBookingInfo[];
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /**
-     * Information about whether specific procedures of the standard Wix Bookings
-     * rescheduling flow are changed. For example, whether the availability of
-     * the new slot is checked before rescheduling the booking or if you can
-     * reschedule the booking even though the rescheduling policy doesn't allow it.
+     * Information about whether specific procedures of the standard Wix Bookings rescheduling flow are changed.
+     * For example, whether the availability of the new slot is checked before rescheduling the booking or if the customer can reschedule the booking even though the service's rescheduling policy doesn't allow it.
      */
     flowControlSettings?: RescheduleBookingFlowControlSettings;
     /** Whether to return the rescheduled bookings entities. */
@@ -1323,13 +1345,12 @@ interface RescheduleMultiServiceBookingRequest {
 }
 interface RescheduleBookingInfo extends RescheduleBookingInfoParticipantsInfoOneOf {
     /**
-     * Total number of participants. Available only for services with variants.
+     * Total number of participants. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * Specify when all participants book the same variant.
      */
     totalParticipants?: number;
     /**
-     * Information about the service choices to book. Available only for services with
-     * variants.
+     * Information about the service choices to book. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * Specify when not all participants book the same variant.
      */
     participantsChoices?: ParticipantChoices;
@@ -1342,21 +1363,19 @@ interface RescheduleBookingInfo extends RescheduleBookingInfoParticipantsInfoOne
     slot?: V2Slot;
     /**
      * Revision number, which increments by 1 each time the booking is updated.
-     * To prevent conflicting changes, the current revision must be specified when
-     * managing the booking.
+     * To prevent conflicting changes, the current revision must be specified when managing the booking.
      */
     revision?: string | null;
 }
 /** @oneof */
 interface RescheduleBookingInfoParticipantsInfoOneOf {
     /**
-     * Total number of participants. Available only for services with variants.
+     * Total number of participants. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * Specify when all participants book the same variant.
      */
     totalParticipants?: number;
     /**
-     * Information about the service choices to book. Available only for services with
-     * variants.
+     * Information about the service choices to book. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
      * Specify when not all participants book the same variant.
      */
     participantsChoices?: ParticipantChoices;
@@ -1379,11 +1398,11 @@ interface GetMultiServiceBookingAvailabilityResponse {
     totalCapacity?: number | null;
     /** Number of open spots. */
     remainingCapacity?: number | null;
-    /** Indicators for policy violations of the multi service booking. */
+    /** Indicators for policy violations of the multi-service booking. */
     policyViolations?: BookingPolicyViolations;
     /** Multi-service booking policy settings. */
     policySettings?: BookingPolicySettings;
-    /** Info of the bookings this availability was calculated for. */
+    /** Details of the multi-service booking. */
     multiServiceBookingInfo?: GetMultiServiceBookingAvailabilityResponseBookingInfo[];
 }
 interface GetMultiServiceBookingAvailabilityResponseBookingInfo {
@@ -1399,16 +1418,11 @@ interface CancelMultiServiceBookingRequest {
      * @format GUID
      */
     multiServiceBookingId: string | null;
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /**
-     * Information about whether specific procedures of the standard Wix Bookings
-     * cancellation flow are changed. For example, whether you can cancel
-     * a booking even though the cancellation policy doesn't allow it or whether
-     * to issue a refund.
+     * Information about whether specific procedures of the standard Wix Bookings cancellation flow are changed.
+     * For example, whether the customer can cancel the booking even though the service's cancellation policy doesn't allow it or whether to issue a refund upon cancellation.
      */
     flowControlSettings?: CancelBookingFlowControlSettings;
     /** Whether to return the canceled single-service bookings. */
@@ -1426,26 +1440,26 @@ interface MarkMultiServiceBookingAsPendingRequest {
     multiServiceBookingId: string | null;
     /** Information about the single-service bookings to mark as `PENDING`. */
     markAsPendingBookingsInfo?: BookingInfo[];
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /**
-     * Whether to send an SMS reminder to the customer 24 hours before the
-     * session starts. The phone number is taken from `contactDetails.phone`.
+     * Whether to send an SMS reminder to the customer 24 hours before the session starts.
+     * Wix Bookings takes the phone number from `contactDetails.phone`.
      *
      * Default: `true`
      */
     sendSmsReminder?: boolean | null;
     /** Whether this booking has a conflict with at least 1 other confirmed booking. */
     doubleBooked?: boolean | null;
-    /** Whether to return the single-service bookings that were marked as `PENDING`. */
+    /**
+     * Whether to return the single-service bookings that were marked as `PENDING`.
+     *
+     * Default: `false`
+     */
     returnFullEntity?: boolean;
     /**
-     * Information about whether specific procedures of the standard Wix Bookings
-     * creation flow are changed. For example, whether the availability is checked
-     * before updating the booking.
+     * Information about whether specific procedures of the standard Wix Bookings creation flow are changed.
+     * For example, whether Wix Bookings checks availability before updating the booking.
      */
     flowControlSettings?: MarkBookingAsPendingFlowControlSettings;
 }
@@ -1457,8 +1471,7 @@ interface BookingInfo {
     bookingId?: string | null;
     /**
      * Revision number, which increments by 1 each time the booking is updated.
-     * To prevent conflicting changes, the current revision must be specified when
-     * managing the booking.
+     * To prevent conflicting changes, the current revision must be specified when managing the booking.
      */
     revision?: string | null;
     /** Payment status to set for the single-service booking. */
@@ -1476,14 +1489,11 @@ interface ConfirmMultiServiceBookingRequest {
     multiServiceBookingId: string | null;
     /** Information about the single-service bookings to confirm. */
     confirmBookingsInfo?: BookingInfo[];
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /**
-     * Whether to send an SMS reminder to the customer 24 hours before the
-     * session starts. The phone number is taken from `contactDetails.phone`.
+     * Whether to send an SMS reminder to the customer 24 hours before the session starts.
+     * Wix Bookings takes the phone number from `contactDetails.phone`.
      *
      * Default: `true`
      */
@@ -1493,36 +1503,32 @@ interface ConfirmMultiServiceBookingRequest {
     /** Whether to return the confirmed single-service bookings. */
     returnFullEntity?: boolean;
     /**
-     * Information about whether specific procedures of the standard Wix Bookings
-     * confirmation flow are changed. For example, whether the availability is
-     * checked before confirming the booking.
+     * Information about whether specific procedures of the standard Wix Bookings confirmation flow are changed.
+     * For example, whether Wix Bookings checks availability before confirming the booking.
      */
     flowControlSettings?: ConfirmBookingFlowControlSettings;
 }
 interface ConfirmMultiServiceBookingResponse {
-    /** Confirmed multi service booking. */
+    /** Confirmed multi-service booking. */
     multiServiceBooking?: MultiServiceBooking;
 }
 interface DeclineMultiServiceBookingRequest {
     /**
-     * ID of the multi service booking to decline.
+     * ID of the multi-service booking to decline.
      * @format GUID
      */
     multiServiceBookingId: string | null;
     /** Information about the single-service bookings to decline. */
     declineBookingsInfo?: BookingInfo[];
-    /**
-     * Information about whether to notify the customer and
-     * the message to send.
-     */
+    /** Information about whether to notify the customer and the message to send. */
     participantNotification?: ParticipantNotification;
     /** Whether this booking has a conflict with at least 1 other confirmed booking. */
     doubleBooked?: boolean | null;
     /** Whether to return the declined single-service bookings. */
     returnFullEntity?: boolean;
     /**
-     * Information about whether specific procedures of the standard Wix Bookings
-     * declining flow are changed. For example, whether to issue a refund.
+     * Information about whether specific procedures of the standard Wix Bookings declining flow are changed.
+     * For example, whether to issue a refund upon cancellation.
      */
     flowControlSettings?: DeclineBookingFlowControlSettings;
 }
@@ -1542,11 +1548,10 @@ interface BulkGetMultiServiceBookingAllowedActionsRequest {
 interface BulkGetMultiServiceBookingAllowedActionsResponse {
     /**
      * Information about the multi-service bookings that were retrieved.
-     * Including their ID, index in the bulk request and whether they were
-     * successfully updated.
+     * Includes their ID, index in the bulk request and whether they were successfully processed.
      */
     results?: BulkCalculateAllowedActionsResult[];
-    /** Total number of successes and failures for Bulk Update Bookings. */
+    /** Total number of successes and failures for Bulk Get Multi Service Booking Allowed Actions. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface GetMultiServiceBookingRequest {
@@ -1564,9 +1569,8 @@ interface GetMultiServiceBookingResponse {
 }
 interface MultiServiceBookingMetadata {
     /**
-     * Total number of `CONFIRMED` and `PENDING` single-service bookings belonging
-     * to the multi-service booking. The total includes the number of single-service
-     * bookings which couldn't be retrieved due to lack of permissions.
+     * Total number of `CONFIRMED` and `PENDING` single-service bookings belonging to the multi-service booking.
+     * The total includes the number of single-service bookings which couldn't be retrieved due to lack of permissions.
      */
     totalNumberOfScheduledBookings?: number | null;
 }
@@ -1581,19 +1585,22 @@ interface AddBookingsToMultiServiceBookingRequest {
      * @maxSize 8
      */
     bookings: BookingIdAndRevision[];
-    /** Whether to return the single-service bookings that were added to the multi-service booking. */
+    /**
+     * Whether to return the single-service bookings that were added to the multi-service booking.
+     *
+     * Default: `false`
+     */
     returnFullEntity?: boolean;
 }
 interface BookingIdAndRevision {
     /**
-     * ID of the booking.
+     * ID of the single-service booking.
      * @format GUID
      */
     bookingId?: string | null;
     /**
      * Revision number, which increments by 1 each time the booking is updated.
-     * To prevent conflicting changes, the current revision must be specified when
-     * managing the booking.
+     * To prevent conflicting changes, the current revision must be specified when managing the booking.
      */
     revision?: string | null;
 }
@@ -1612,7 +1619,11 @@ interface RemoveBookingsFromMultiServiceBookingRequest {
      * @maxSize 8
      */
     bookings?: BookingIdAndRevision[];
-    /** Whether to return the single-service bookings. */
+    /**
+     * Whether to return the single-service bookings.
+     *
+     * Default: `false`
+     */
     returnFullEntity?: boolean;
 }
 interface RemoveBookingsFromMultiServiceBookingResponse {