@wix/bookings 1.0.1 → 1.0.2

package/build/cjs/src/bookings-v2-booking.types.d.ts

@@ -0,0 +1,1594 @@
+/** The booking object, version 2. */
+export interface Booking extends BookingParticipantsInfoOneOf {
+    /**
+     * Booking ID.
+     * @readonly
+     */
+    id?: string | null;
+    /** An object describing the slot or schedule that was booked. */
+    bookedEntity?: BookedEntity;
+    /** Contact details of the site visitor or member making the booking. */
+    contactDetails?: ContactDetails;
+    /** Additional custom fields submitted with the booking form. */
+    additionalFields?: CustomFormField[];
+    /**
+     * Booking status.
+     * One of:
+     * - `"CREATED"` - The booking was created.
+     * - `"UPDATED"` - The booking was updated.
+     * - `"CONFIRMED"` - The booking has been confirmed and appears on the bookings calendar.
+     * Booking can be manually confirmed using the Set As Confirmed endpoint.
+     * Booking can be automatically confirmed when the following requirements are met:
+     * + The service is configured as automatically confirmed.
+     * + Invoking eCommerce checkout API and an order has been created.
+     * - `"CANCELED"` - The booking has been canceled and synced to bookings calendar.
+     * The booking can be canceled using cancel API.
+     * - `"PENDING"` - The booking waiting to be confirmed or declined buy the owner and is synced to bookings calendar.
+     * Bookings can be manually set as pending using setAsPending API, requires manage booking status permissions.
+     * Booking can be automatically set as pending when the following requirements are met:
+     * + The Service is configured as manually confirmed.
+     * + Invoking the eCommerce checkout API and an order has been created.
+     * - `"WAITING_LIST"` - The booking is pending on a waiting list.
+     * Booking can be created with this status when invoking waiting list join API.
+     * - `"DECLINED"` - The booking was declined by the owner and synced to bookings calendar.
+     * Booking can be manually declined using decline API and requires manage booking permissions.
+     * Booking can be automatically declined when the following requirements are met:
+     * + Invoking eCommerce checkout API and the order declined event has been sent.
+     * + Invoking eCommerce checkout API and order approved event has been sent, but the booking is offline and the booking causes a double booking.
+     */
+    status?: BookingStatus;
+    /**
+     * Payment status.
+     * One of:
+     * - `"NOT_PAID"` The booking is not paid for.
+     * - `"PAID"` The booking is fully paid.
+     * - `"PARTIALLY_PAID"` The booking is partially paid.
+     * - `"REFUNDED"` The booking is refunded.
+     * @readonly
+     */
+    paymentStatus?: PaymentStatus;
+    /**
+     * Selected payment option.
+     * One of the payment options offered by the service, or another option if `skipSelectedPaymentOptionValidation` is `true`.
+     * When undefined, the payment option is resolved by the service configuration on checkout.
+     */
+    selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Date and time the booking was created.
+     * @readonly
+     */
+    createdDate?: Date;
+    /** External ID provided by the client app on creation. */
+    externalUserId?: string | null;
+    /** Revision number to be used when updating, rescheduling, or cancelling the booking. The revision number is automatically incremented when the booing is updated. */
+    revision?: string | null;
+    /**
+     * ID of the creator of the Booking
+     * If `appId` and another ID are present, the other ID takes precedence.
+     * @readonly
+     */
+    createdBy?: CommonIdentificationData;
+    /**
+     * The start date of this booking. For a slot, this is the start date of the slot. For a schedule, the start date of the first session.
+     * @readonly
+     */
+    startDate?: Date;
+    /**
+     * The end date of this booking. For a slot, this is the end date of the slot. For a schedule, the end date of the last session.
+     * @readonly
+     */
+    endDate?: Date;
+    /**
+     * Date and time the booking was updated.
+     * @readonly
+     */
+    updatedDate?: Date;
+    /**
+     * Additional custom fields. This includes fields managed by Wix, by 3rd-party apps, and by the site.
+     *
+     * Empty fields are not returned.
+     */
+    extendedFields?: ExtendedFields;
+    /**
+     * Indicating if this booking overlaps another existing confirmed booking
+     * @readonly
+     */
+    doubleBooked?: boolean | null;
+    /** Total number of participants. Available only when the booking includes a single service variant. */
+    totalParticipants?: number;
+    /**
+     * Information about the booked service choices and participants.
+     * Available only when the booking includes multiple service variants.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+/** @oneof */
+export interface BookingParticipantsInfoOneOf {
+    /** Total number of participants. Available only when the booking includes a single service variant. */
+    totalParticipants?: number;
+    /**
+     * Information about the booked service choices and participants.
+     * Available only when the booking includes multiple service variants.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+export interface BookedEntity extends BookedEntityItemOneOf {
+    /** Session title at the time of booking. */
+    title?: string | null;
+    /**
+     * List of tags for the booking.
+     * System-assigned tags for sessions and schedules are:
+     * + "INDIVIDUAL" Appointments, including appointments with more than 1 participant.
+     * + "GROUP" Individual classes.
+     * + "COURSE" Courses.
+     */
+    tags?: string[] | null;
+    /** The booked slot, which once booked becomes a session. The booking is automatically assigned to the session if given, or a session is be created if one doesn't already exist. */
+    slot?: BookedSlot;
+    /** The booked schedule. The booking is automatically assigned to the schedule's sessions. */
+    schedule?: BookedSchedule;
+}
+/** @oneof */
+export interface BookedEntityItemOneOf {
+    /** The booked slot, which once booked becomes a session. The booking is automatically assigned to the session if given, or a session is be created if one doesn't already exist. */
+    slot?: BookedSlot;
+    /** The booked schedule. The booking is automatically assigned to the schedule's sessions. */
+    schedule?: BookedSchedule;
+}
+export interface BookedSlot {
+    /**
+     * ID of the underlying session when session is a single session or generated from a recurring session.
+     * If `sessionId` is defined in the Create Booking request, the `startDate`, `endDate`, timezone, resource, and location fields from the request are ignored and populated from the session's information.
+     */
+    sessionId?: string | null;
+    /** Service ID. */
+    serviceId?: string;
+    /** Schedule ID. Required. */
+    scheduleId?: string;
+    /**
+     * The start time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
+     * format. Required.
+     */
+    startDate?: string | null;
+    /**
+     * The end time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
+     * format. Required.
+     */
+    endDate?: string | null;
+    /** The timezone according to which the slot was shown to the user when booking, and should be shown in future. */
+    timezone?: string | null;
+    /** The resource used on the slot. */
+    resource?: BookedResource;
+    /** Location where the slot's session takes place. */
+    location?: Location;
+}
+export interface BookedResource {
+    /** Booked resource ID. */
+    id?: string;
+    /** Resource's name at the time of booking. */
+    name?: string | null;
+    /** Resource's email at the time of booking. */
+    email?: string | null;
+    /** Resources schedule ID. */
+    scheduleId?: string | null;
+}
+export interface Location {
+    /**
+     * Business location ID. Available only for locations that are business locations,
+     * meaning the `location_type` is `"OWNER_BUSINESS"`.
+     */
+    id?: string | null;
+    /** Location name. */
+    name?: string | null;
+    /** The full address of this location. */
+    formattedAddress?: string | null;
+    /**
+     * Location type.
+     *
+     * - `"OWNER_BUSINESS"`: The business address, as set in the site’s general settings.
+     * - `"OWNER_CUSTOM"`: The address as set when creating the service.
+     * - `"CUSTOM"`: The address as set for the individual session.
+     */
+    locationType?: LocationType;
+}
+export declare enum LocationType {
+    UNDEFINED = "UNDEFINED",
+    OWNER_BUSINESS = "OWNER_BUSINESS",
+    OWNER_CUSTOM = "OWNER_CUSTOM",
+    CUSTOM = "CUSTOM"
+}
+export interface BookedSchedule {
+    /** Schedule ID. */
+    scheduleId?: string;
+    /** ID of the booked service. */
+    serviceId?: string | null;
+    /**
+     * Location where the schedule's sessions take place. Read only.
+     * @readonly
+     */
+    location?: Location;
+    /** The timezone according to which the slot was shown to the user when booking, and should be shown in future. */
+    timezone?: string | null;
+    /**
+     * The start time of the first session in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
+     * format. Required.
+     * @readonly
+     */
+    firstSessionStart?: string | null;
+    /**
+     * The end time of the last session in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
+     * format. Required.
+     * @readonly
+     */
+    lastSessionEnd?: string | null;
+}
+export interface ContactDetails {
+    /** Contact's ID. */
+    contactId?: string | null;
+    /** Contact's first name. When populated from a standard booking form, this property corresponds to the **Name** field. */
+    firstName?: string | null;
+    /** Contact's last name. */
+    lastName?: string | null;
+    /** Contact's email, used to create a new contact or get existing one from the [Contacts API](https://dev.wix.com/api/rest/contacts/contacts). Used to validate coupon usage limitations per contact. If not passed, the coupon usage limitation will not be enforced. (Coupon usage limitation validation is not supported yet). */
+    email?: string | null;
+    /** Contact's phone number. */
+    phone?: string | null;
+    /** Contact's full address. */
+    fullAddress?: Address;
+    /** Contact's time zone. */
+    timeZone?: string | null;
+    /** Contact's country in [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. */
+    countryCode?: string | null;
+}
+/** Physical address */
+export interface Address extends AddressStreetOneOf {
+    /** Country code. */
+    country?: string | null;
+    /** Subdivision. Usually state, region, prefecture or province code, according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). */
+    subdivision?: string | null;
+    /** City name. */
+    city?: string | null;
+    /** Zip/postal code. */
+    postalCode?: string | null;
+    /** Free text providing more detailed address info. Usually contains Apt, Suite, and Floor. */
+    addressLine2?: string | null;
+    /** A string containing the full address of this location. */
+    formattedAddress?: string | null;
+    /** Free text to help find the address. */
+    hint?: string | null;
+    /** Coordinates of the physical address. */
+    geocode?: AddressLocation;
+    /** Country full name. */
+    countryFullname?: string | null;
+    /** Multi-level subdivisions from top to bottom. */
+    subdivisions?: Subdivision[];
+    /** Street name, number and apartment number. */
+    streetAddress?: StreetAddress;
+    /** Main address line, usually street and number, as free text. */
+    addressLine?: string | null;
+}
+/** @oneof */
+export interface AddressStreetOneOf {
+    /** Street name, number and apartment number. */
+    streetAddress?: StreetAddress;
+    /** Main address line, usually street and number, as free text. */
+    addressLine?: string | null;
+}
+export interface StreetAddress {
+    /** Street number. */
+    number?: string;
+    /** Street name. */
+    name?: string;
+    /** Apartment number. */
+    apt?: string;
+}
+export interface AddressLocation {
+    /** Address latitude. */
+    latitude?: number | null;
+    /** Address longitude. */
+    longitude?: number | null;
+}
+export interface Subdivision {
+    /** Subdivision code. Usually state, region, prefecture or province code, according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). */
+    code?: string;
+    /** Subdivision full name. */
+    name?: string;
+}
+export interface CustomFormField {
+    /** ID of the form field as defined in the form. */
+    id?: string;
+    /** Value that was submitted for this field. */
+    value?: string | null;
+    /**
+     * Form field's label at the time of submission.
+     * @readonly
+     */
+    label?: string | null;
+    /**
+     * <!--ONLY:VELO
+     * One of:
+     * - `"SHORT_TEXT"`
+     * - `"LONG_TEXT"`
+     * - `"CHECK_BOX"`
+     * <!--END:ONLY:VELO-->
+     */
+    valueType?: ValueType;
+}
+export declare enum ValueType {
+    /** Short text. This is the default value type. */
+    SHORT_TEXT = "SHORT_TEXT",
+    /** Long text */
+    LONG_TEXT = "LONG_TEXT",
+    /** a text that represent the check box value: if selected the value is "true", otherwise "false". */
+    CHECK_BOX = "CHECK_BOX"
+}
+/** Booking status. */
+export declare enum BookingStatus {
+    CREATED = "CREATED",
+    CONFIRMED = "CONFIRMED",
+    CANCELED = "CANCELED",
+    PENDING = "PENDING",
+    DECLINED = "DECLINED",
+    WAITING_LIST = "WAITING_LIST"
+}
+/**
+ * Payment status.
+ * Automatically updated when using eCom checkout APIs.
+ */
+export declare enum PaymentStatus {
+    UNDEFINED = "UNDEFINED",
+    NOT_PAID = "NOT_PAID",
+    PAID = "PAID",
+    /** not supported yet. */
+    PARTIALLY_PAID = "PARTIALLY_PAID",
+    /** not supported yet */
+    REFUNDED = "REFUNDED"
+}
+/**
+ * The selected payment option.
+ * One of the payment options offered by the service.
+ * This field is be set when the user selects an option during booking.
+ * If left undefined, the payment option is resolved by the service configuration on checkout.
+ */
+export declare enum SelectedPaymentOption {
+    UNDEFINED = "UNDEFINED",
+    OFFLINE = "OFFLINE",
+    ONLINE = "ONLINE",
+    MEMBERSHIP = "MEMBERSHIP",
+    /** Payment can only be done using a membership and must be manually redeemed in the dashboard by the site owner. */
+    MEMBERSHIP_OFFLINE = "MEMBERSHIP_OFFLINE"
+}
+export interface BookingSource {
+    /**
+     * Platform from which a booking was created
+     * <!--ONLY:VELO
+     * One of:
+     * - `"WEB"` Desktop browser.
+     * - `"MOBILE_APP"` Mobile application.
+     * <!--END:ONLY:VELO-->
+     */
+    platform?: Platform;
+    /**
+     * Actor that created this booking.
+     * <!--ONLY:VELO
+     * One of:
+     * - `"BUSINESS"`
+     * - `"CUSTOMER"`
+     * <!--END:ONLY:VELO-->
+     */
+    actor?: Actor;
+    /**
+     * Wix site ID of the application that created the booking.
+     * @readonly
+     */
+    appDefId?: string | null;
+    /**
+     * Name of the application that created the booking, as saved in Wix Developers Center at the time of booking.
+     * @readonly
+     */
+    appName?: string | null;
+}
+export declare enum Platform {
+    UNDEFINED_PLATFORM = "UNDEFINED_PLATFORM",
+    WEB = "WEB",
+    MOBILE_APP = "MOBILE_APP"
+}
+export declare enum Actor {
+    UNDEFINED_ACTOR = "UNDEFINED_ACTOR",
+    BUSINESS = "BUSINESS",
+    CUSTOMER = "CUSTOMER"
+}
+export interface ParticipantNotification {
+    /**
+     * Whether to send the message about the changes to the customer.
+     *
+     * Default: `false`
+     */
+    notifyParticipants?: boolean;
+    /** Custom message to send to the participants about the changes to the booking. */
+    message?: string | null;
+}
+export interface CommonIdentificationData extends CommonIdentificationDataIdOneOf {
+    /**
+     * ID of of a contact in the site's [CRM by Ascend](https://www.wix.com/ascend/crm) system.
+     * @readonly
+     */
+    contactId?: string | null;
+    /** ID of a site visitor that has not logged in to the site. */
+    anonymousVisitorId?: string;
+    /** ID of a site visitor that has logged in to the site. */
+    memberId?: string;
+    /** ID of a Wix user (site owner, contributor, etc.). */
+    wixUserId?: string;
+    /** ID of an app. */
+    appId?: string;
+}
+/** @oneof */
+export interface CommonIdentificationDataIdOneOf {
+    /** ID of a site visitor that has not logged in to the site. */
+    anonymousVisitorId?: string;
+    /** ID of a site visitor that has logged in to the site. */
+    memberId?: string;
+    /** ID of a Wix user (site owner, contributor, etc.). */
+    wixUserId?: string;
+    /** ID of an app. */
+    appId?: string;
+}
+export declare enum IdentificationDataIdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+export interface FlowControlSettings {
+    /**
+     * When true, skips availability checking and allows booking.
+     * Requires BOOKINGS.OVERRIDE_AVAILABILITY permissions.
+     */
+    skipAvailabilityValidation?: boolean;
+    /**
+     * When true, allows booking a confirmation-required service without requiring confirmation.
+     * Requires BOOKINGS.IGNORE_BOOKING_POLICY permissions.
+     */
+    skipBusinessConfirmation?: boolean;
+    /**
+     * When true, skips selected payment option checking as defined in `selectedPaymentOption` field
+     * and allows booking.
+     * Requires BOOKINGS.MANAGE_PAYMENTS permissions.
+     */
+    skipSelectedPaymentOptionValidation?: boolean;
+    /** When true, refunds the booking's payment when the booking is canceled. */
+    withRefund?: boolean | null;
+}
+export interface ExtendedFields {
+    /**
+     * Data Extensions extended fields
+     * Key: Namespace
+     * Value: extended fields data in Struct format
+     */
+    namespaces?: Record<string, Record<string, any>>;
+}
+export interface ParticipantChoices {
+    /** Information about the booked service choices. Includes the number of participants. */
+    serviceChoices?: ServiceChoices[];
+}
+export interface ServiceChoices {
+    /** Number of participants for this variant. */
+    numberOfParticipants?: number | null;
+    /** Service choices for these participants. */
+    choices?: ServiceChoice[];
+}
+export interface ServiceChoice extends ServiceChoiceChoiceOneOf {
+    /**
+     * ID of the corresponding option for the choice. For example, the choice `child`
+     * could correspond to the option `ageGroup`. In this case, `optionId` is the ID
+     * for the `ageGroup` option.
+     */
+    optionId?: string;
+    /**
+     * Value for one of the choices in the [`CustomServiceOption.choices`](https://example.com) list.
+     * Choices are specific values for an option the customer can choose to book. For example,
+     * the option `ageGroup` may have these choices: `child`, `student`, `adult`, and `senior`.
+     * Each choice may have a different price.
+     */
+    custom?: string;
+}
+/** @oneof */
+export interface ServiceChoiceChoiceOneOf {
+    /**
+     * Value for one of the choices in the [`CustomServiceOption.choices`](https://example.com) list.
+     * Choices are specific values for an option the customer can choose to book. For example,
+     * the option `ageGroup` may have these choices: `child`, `student`, `adult`, and `senior`.
+     * Each choice may have a different price.
+     */
+    custom?: string;
+}
+export interface BookingChanged {
+    /** The booking before the changes. */
+    previousBooking?: Booking;
+    /** The booking after the changes. */
+    currentBooking?: Booking;
+}
+export interface CreateBookingRequest {
+    /** The booking to create. */
+    booking?: Booking;
+    /** Information about a message to send to the customer. */
+    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`.
+     * Default: `true`.
+     */
+    sendSmsReminder?: boolean | null;
+    /**
+     * Information about whether specific procedures of the standard Wix Bookings
+     * creation flow are changed. For example, whether the availability is
+     * checked before creating the booking or if additional payment options are
+     * accepted.
+     */
+    flowControlSettings?: CreateBookingFlowControlSettings;
+}
+export 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. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     * Default: `false`.
+     */
+    skipAvailabilityValidation?: boolean;
+    /**
+     * 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
+     * when passing `true`.
+     * Default: `false`.
+     */
+    skipBusinessConfirmation?: boolean;
+    /**
+     * 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
+     * `true`.
+     * Default: `false`.
+     */
+    skipSelectedPaymentOptionValidation?: boolean;
+}
+export interface CreateBookingResponse {
+    /** Created booking. */
+    booking?: Booking;
+}
+/**
+ * The fieldMask should not include both the "numberOfParticipants" and "participantsInfo" paths, doing so will result
+ * in an error. "participantsInfo" should be preferred over "numberOfParticipants"
+ */
+export interface UpdateBookingRequest {
+    booking?: Booking;
+    mask?: string[];
+}
+export interface UpdateBookingResponse {
+    booking?: Booking;
+}
+export interface LegacyCreateBookingRequest {
+    booking?: Booking;
+}
+export interface LegacyCreateBookingResponse {
+    booking?: Booking;
+}
+/**
+ * The fieldMask for each booking should not include both the "numberOfParticipants" and "participantsInfo" paths, doing so will result
+ * in an error. "participantsInfo" should be preferred over "numberOfParticipants"
+ */
+export interface BulkUpdateBookingRequest {
+    bookings?: MaskedBooking[];
+}
+export interface MaskedBooking {
+    booking?: Booking;
+    mask?: string[];
+}
+export interface BulkUpdateBookingResponse {
+    results?: ItemMetadata[];
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface ItemMetadata {
+    /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
+    id?: string | null;
+    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    originalIndex?: number;
+    /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
+    success?: boolean;
+    /** Details about the error in case of failure. */
+    error?: ApplicationError;
+}
+export interface ApplicationError {
+    /** Error code. */
+    code?: string;
+    /** Description of the error. */
+    description?: string;
+    /** Data related to the error. */
+    data?: Record<string, any> | null;
+}
+export interface BulkActionMetadata {
+    /** Number of items that were successfully processed. */
+    totalSuccesses?: number;
+    /** Number of items that couldn't be processed. */
+    totalFailures?: number;
+    /** Number of failures without details because detailed failure threshold was exceeded. */
+    undetailedFailures?: number;
+}
+export interface BulkCreateBookingRequest {
+    /**
+     * Bookings to create.
+     * Max: 8 bookings.
+     */
+    createBookingsInfo?: CreateBookingInfo[];
+    /** Whether to return the created bookings entities. */
+    returnFullEntity?: boolean;
+}
+export interface CreateBookingInfo {
+    /** The booking to create */
+    booking?: Booking;
+    /** Information about a message to send to the customer. */
+    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`.
+     * Default: `true`.
+     */
+    sendSmsReminder?: boolean | null;
+    /**
+     * Information about whether specific procedures of the standard Wix Bookings
+     * creation flow are changed. For example, whether the availability is
+     * checked before creating the booking or if additional payment options are
+     * accepted.
+     */
+    flowControlSettings?: CreateBookingFlowControlSettings;
+}
+export interface BulkCreateBookingResponse {
+    /**
+     * Bulk create booking results.
+     * For each booking includes whether its creation succeeded along with proper error if such occurred, and the created booking entity if `returnFullEntity` was passed as true.
+     */
+    results?: BulkBookingResult[];
+    /** Total successes and failures of the bulk create booking action. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface BulkBookingResult {
+    itemMetadata?: ItemMetadata;
+    item?: Booking;
+}
+export interface RescheduleBookingRequest extends RescheduleBookingRequestParticipantsInfoOneOf {
+    /** Id of the booking to reschedule. */
+    bookingId: string;
+    /** Information about the new slot. */
+    slot: V2Slot;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the rescheduling 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.
+     */
+    flowControlSettings?: RescheduleBookingRequestFlowControlSettings;
+    /**
+     * Total number of participants. Available only for services with
+     * variants.
+     * Pass when all participants book the same variant.
+     */
+    totalParticipants?: number;
+    /**
+     * Information about the service choices to book. Available only for services with
+     * variants.
+     * Pass when not all participants book the same variant.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+/** @oneof */
+export interface RescheduleBookingRequestParticipantsInfoOneOf {
+    /**
+     * Total number of participants. Available only for services with
+     * variants.
+     * Pass when all participants book the same variant.
+     */
+    totalParticipants?: number;
+    /**
+     * Information about the service choices to book. Available only for services with
+     * variants.
+     * Pass when not all participants book the same variant.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+export interface V2Slot {
+    /** Identifier for underlying session when session is a single session or generated from a recurring session. Required. */
+    sessionId?: string | null;
+    /** Service identifier. Required. */
+    serviceId?: string;
+    /** Schedule identifier. Required. */
+    scheduleId?: string;
+    /** The start time of this Slot (formatted according to RFC3339). Required. */
+    startDate?: string | null;
+    /** The end time of this Slot (formatted according to RFC3339). Required. */
+    endDate?: string | null;
+    /** The timezone according to which the slot is calculated presented. */
+    timezone?: string | null;
+    /** The resource required for this slot. Currently, in Bookings, this is the relevant staff. Required. */
+    resource?: SlotSlotResource;
+    /** Geographic location of the slot. */
+    location?: SlotLocation;
+}
+export declare enum LocationLocationType {
+    UNDEFINED = "UNDEFINED",
+    OWNER_BUSINESS = "OWNER_BUSINESS",
+    OWNER_CUSTOM = "OWNER_CUSTOM",
+    CUSTOM = "CUSTOM"
+}
+export interface SlotSlotResource {
+    /**
+     * Resource ID
+     * @readonly
+     */
+    id?: string | null;
+    /** Read only. Resource name. */
+    name?: string | null;
+}
+export interface SlotLocation {
+    /** Business Location ID. Present if the location is a business location. */
+    id?: string | null;
+    /** Location name. */
+    name?: string | null;
+    /** A string containing the full address of this location. */
+    formattedAddress?: string | null;
+    /**
+     * Location type.
+     * One of:
+     * - `"OWNER_BUSINESS"` The business address as set in the site’s general settings.
+     * - `"OWNER_CUSTOM"` The address as set when creating the service.
+     * - `"CUSTOM"` The address set for the individual session.
+     */
+    locationType?: LocationLocationType;
+}
+export interface RescheduleBookingRequestFlowControlSettings {
+    /**
+     * Whether the rescheduling policy applies when rescheduling the booking.
+     * When passing `false` you can only cancel a booking if the rescheduling
+     * policy allows it. Your app must have the `BOOKINGS.IGNORE_BOOKING_POLICY `
+     * permission scope when passing `true`.
+     * Default: `false`.
+     * <!--ONLY:VELO
+     * Requires "Manage Wix Bookings App" and "Manage Bookings' Calendar" [roles](https://support.wix.com/en/article/roles-permissions-overview#bookings-admin).
+     * <!--END:ONLY:VELO-->
+     */
+    ignoreReschedulePolicy?: boolean;
+    /**
+     * Whether the availability is checked before rescheduling the booking.
+     * When passing `false` a booking is only created when the slot or
+     * schedule is available. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     * Default: `false`.
+     */
+    skipAvailabilityValidation?: boolean;
+    /**
+     * Whether the rescheduled booking's status is automatically set to
+     * `CONFIRMED` for services that normally require the owner's manual
+     * confirmation. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     * Default: `false`.
+     */
+    skipBusinessConfirmation?: boolean;
+}
+export interface RescheduleBookingResponse {
+    /** Rescheduled booking. */
+    booking?: Booking;
+}
+export interface BulkRescheduleBookingRequest {
+    /** Reschedule multiple bookings to multiple slots. */
+    slotsBookings?: SlotBookings[];
+    /** Whether to notify participants about the change and an optional custom message */
+    participantNotification?: ParticipantNotification;
+}
+export interface BulkRescheduleBookingRequestBooking {
+    /** Id of the bookings to be rescheduled. */
+    id?: string;
+    revision?: string | null;
+}
+/** Bookings to be rescheduled to the given slot. */
+export interface SlotBookings {
+    /** The bookings details. */
+    bookings?: BulkRescheduleBookingRequestBooking[];
+    /**
+     * The slot to which the bookings was rescheduled
+     * This bookings will automatically be assigned to the session if given, or will create a new one if not.
+     */
+    slot?: BookedSlot;
+}
+export interface BulkRescheduleBookingResponse {
+    /** The bulk reschedule results. For each booking contains the metadata of the reschedule action. */
+    results?: ItemMetadata[];
+    /** Total successes and failures of the bulk reschedule action. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+/** Update the booked schedule of multiple bookings to the given schedule. */
+export interface BulkUpdateBookedScheduleRequest {
+    /** The bookings whose booked schedule is to be updated to the given schedule. */
+    bookings?: BookingDetails[];
+    /** The id of the schedule to which the bookings booked schedule is to be updated. */
+    scheduleId?: string;
+    /** Whether to notify participants about the change and an optional custom message. */
+    participantNotification?: ParticipantNotification;
+}
+export interface BookingDetails {
+    /** Id of the bookings to be updated. */
+    id?: string;
+    revision?: string | null;
+}
+export interface BulkUpdateBookedScheduleResponse {
+    /** The bulk update results. For each booking contains the metadata of the update action. */
+    results?: ItemMetadata[];
+    /** Total successes and failures of the bulk update action. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface QueryBookingsRequest {
+    query?: QueryV2;
+}
+export interface QueryV2 extends QueryV2PagingMethodOneOf {
+    /**
+     * Filter object in the following format:
+     * `"filter" : {
+     * "fieldName1": "value1",
+     * "fieldName2":{"$operator":"value2"}
+     * }`
+     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the following format:
+     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     */
+    sort?: Sorting[];
+    /** Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned. */
+    fields?: string[];
+    /** Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned. */
+    fieldsets?: string[];
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging;
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+}
+/** @oneof */
+export interface QueryV2PagingMethodOneOf {
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging;
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+}
+export interface Sorting {
+    /** Name of the field to sort by. */
+    fieldName?: string;
+    /** Sort order. */
+    order?: SortOrder;
+}
+export declare enum SortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+export interface Paging {
+    /** Number of items to load. */
+    limit?: number | null;
+    /** Number of items to skip in the current sort order. */
+    offset?: number | null;
+}
+export interface CursorPaging {
+    /** Number of items to load. */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * You can get the relevant cursor token
+     * from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     */
+    cursor?: string | null;
+}
+export interface QueryBookingsResponse {
+    bookings?: Booking[];
+    pagingMetadata?: PagingMetadataV2;
+}
+export interface PagingMetadataV2 {
+    /** Number of items returned in the response. */
+    count?: number | null;
+    /** Offset that was requested. */
+    offset?: number | null;
+    /** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
+    total?: number | null;
+    /** Flag that indicates the server failed to calculate the `total` field. */
+    tooManyToCount?: boolean | null;
+    /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
+    cursors?: Cursors;
+}
+export interface Cursors {
+    /** Cursor pointing to next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to previous page in the list of results. */
+    prev?: string | null;
+}
+export interface ConfirmRequest {
+    /** ID of the booking to be confirmed. */
+    id?: string;
+    /** Whether to notify the participants about the booking confirmation, and an optional custom message. */
+    participantNotification?: ParticipantNotification;
+}
+export interface ConfirmResponse {
+    booking?: Booking;
+}
+export interface ConfirmBookingRequest {
+    /** ID of the booking to confirm. */
+    bookingId: string;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the confirmation and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+}
+export interface ConfirmBookingResponse {
+    booking?: Booking;
+}
+export interface PartySizeRequest extends PartySizeRequestPartySizeForOneOf {
+    sessionId?: string | null;
+    scheduleId?: string | null;
+}
+/** @oneof */
+export interface PartySizeRequestPartySizeForOneOf {
+    sessionId?: string | null;
+    scheduleId?: string | null;
+}
+export interface PartySizeResponse {
+    partySize?: number | null;
+}
+export interface ConsistentQueryBookingsRequest {
+    query?: QueryV2;
+}
+export interface ConsistentQueryBookingsResponse {
+    bookings?: Booking[];
+    pagingMetadata?: PagingMetadataV2;
+}
+export interface SetBookingSessionIdRequest {
+    /** Id of the booking to set its sessionId. */
+    id?: string;
+    /** The sessionId to be set. */
+    sessionId?: string;
+}
+export interface SetBookingSessionIdResponse {
+    /** The updated booking. */
+    booking?: Booking;
+}
+export interface UpdateExtendedFieldsRequest {
+    /** entity_id */
+    id?: string;
+    namespace?: string;
+    namespaceData?: Record<string, any> | null;
+}
+export interface UpdateExtendedFieldsResponse {
+    namespace?: string;
+    /** only data from UpdateExtendedFieldsRequest namespace_data */
+    namespaceData?: Record<string, any> | null;
+}
+export interface DeclineBookingRequest {
+    /** ID of the booking to decline. */
+    bookingId: string;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the decline and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+}
+export interface DeclineBookingResponse {
+    /** eclined booking */
+    booking?: Booking;
+}
+export interface BookingDeclined {
+    /** The booking after the decline. */
+    currentBooking?: Booking;
+    /** Whether the booking is double-booking or was declined by the owner. */
+    doubleBooking?: boolean | null;
+    /** Whether to notify participants about the change and an optional custom message */
+    participantNotification?: ParticipantNotification;
+    /** The identity that did the action triggered the event */
+    declinedBy?: IdentificationData;
+}
+export interface IdentificationData extends IdentificationDataIdOneOf {
+    /**
+     * ID of of a contact in the site's [CRM by Ascend](https://www.wix.com/ascend/crm) system.
+     * @readonly
+     */
+    contactId?: string | null;
+    /** ID of a site visitor that has not logged in to the site. */
+    anonymousVisitorId?: string;
+    /** ID of a site visitor that has logged in to the site. */
+    memberId?: string;
+    /** ID of a Wix user (site owner, contributor, etc.). */
+    wixUserId?: string;
+    /** ID of an app. */
+    appId?: string;
+}
+/** @oneof */
+export interface IdentificationDataIdOneOf {
+    /** ID of a site visitor that has not logged in to the site. */
+    anonymousVisitorId?: string;
+    /** ID of a site visitor that has logged in to the site. */
+    memberId?: string;
+    /** ID of a Wix user (site owner, contributor, etc.). */
+    wixUserId?: string;
+    /** ID of an app. */
+    appId?: string;
+}
+export declare enum IdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+export interface CancelBookingRequest {
+    /** ID of the booking to cancel. */
+    bookingId: string;
+    /**
+     * Information about whether to notify the customer about the cancelation and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+    /**
+     * Information about whether specific procedures of the standard Wix Bookings
+     * cancelation flow are changed. For example, whether the you can cancel
+     * a booking even though the cancelation policy doesn't allow it or whether
+     * to issue a refund.
+     */
+    flowControlSettings?: CancelBookingRequestFlowControlSettings;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes,
+     * the current revision must be passed when managing the booking.
+     */
+    revision: string | null;
+}
+export interface CancelBookingRequestFlowControlSettings {
+    /**
+     * Whether the cancelation policy applies when canceling the booking. When
+     * passing `false` you can only cancel a booking if the cancelation policy
+     * allows it. Your app must have the `BOOKINGS.IGNORE_BOOKING_POLICY `
+     * permission scope when passing `true`.
+     * Default: `false`.
+     * <!--ONLY:VELO
+     * Requires "Manage Wix Bookings App" and "Manage Bookings' Calendar" [roles](https://support.wix.com/en/article/roles-permissions-overview#bookings-admin).
+     * <!--END:ONLY:VELO-->
+     */
+    ignoreCancellationPolicy?: boolean | null;
+    /**
+     * Whether to issue a refund when canceling the booking.
+     * The refund will be issued only if the booking is refundable.
+     * Currently, booking is considered refundable when it was paid by membership.
+     * If passing `true`, the booking flow control settings will be set with refund,
+     * otherwise, either if `false` is passed or the field remains empty,
+     * the booking flow control settings will be set with no refund.
+     * Default: `false`.
+     */
+    withRefund?: boolean | null;
+}
+export interface CancelBookingResponse {
+    /** Canceled booking. */
+    booking?: Booking;
+}
+export interface BookingCanceled {
+    /** The canceled booking. */
+    currentBooking?: Booking;
+    /** Whether the booking should be refunded */
+    issueRefund?: boolean | null;
+    /** Whether to notify participants about the change and an optional custom message */
+    participantNotification?: ParticipantNotification;
+    /** The identity that did the action triggered the event */
+    canceledBy?: IdentificationData;
+}
+export interface UpdateNumberOfParticipantsRequest extends UpdateNumberOfParticipantsRequestParticipantsInfoOneOf {
+    /** ID of the booking to update the number of participants for. */
+    bookingId: string;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Total number of participants. Available only for services with
+     * variants.
+     * Pass when all participants book the same variant.
+     */
+    totalParticipants?: number;
+    /**
+     * Information about the service choices to book. Available only for services with
+     * variants.
+     * Pass when not all participants book the same variant.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+/** @oneof */
+export interface UpdateNumberOfParticipantsRequestParticipantsInfoOneOf {
+    /**
+     * Total number of participants. Available only for services with
+     * variants.
+     * Pass when all participants book the same variant.
+     */
+    totalParticipants?: number;
+    /**
+     * Information about the service choices to book. Available only for services with
+     * variants.
+     * Pass when not all participants book the same variant.
+     */
+    participantsChoices?: ParticipantChoices;
+}
+export interface UpdateNumberOfParticipantsResponse {
+    /** Booking with updated number of participants. */
+    booking?: Booking;
+}
+export interface CalculateAllowedActionsRequest {
+    /** The booking id that we want to calculate the allowedActions for */
+    bookingId?: string | null;
+}
+export interface CalculateAllowedActionsResponse {
+    allowedActions?: AllowedActions;
+}
+/** Possible allowed actions for a Booking */
+export interface AllowedActions {
+    /** Is cancel booking allowed */
+    cancel?: boolean;
+    /** Is reschedule booking allowed */
+    reschedule?: boolean;
+}
+export interface BulkCalculateAllowedActionsRequest {
+    /** The booking id's that we want to calculate the allowedActions for */
+    bookingIds?: string[] | null;
+}
+export interface BulkCalculateAllowedActionsResponse {
+    results?: BulkCalculateAllowedActionsResult[];
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface BulkCalculateAllowedActionsResult {
+    /** (id, indexInGivenSeq, isSuccessful, error) */
+    itemMetadata?: ItemMetadata;
+    item?: AllowedActions;
+}
+export interface GetSlotAvailabilityRequest {
+    /** The slot for which the availability is checked. */
+    slot?: V2Slot;
+    /** The timezone for which availability is to be calculated. */
+    timezone?: string | null;
+}
+export interface GetSlotAvailabilityResponse {
+    availability?: SlotAvailability;
+    bookingPolicySettings?: BookingPolicySettings;
+}
+export interface SlotAvailability {
+    /** Identifier for underlying session when session is a single session or generated from a recurring session. Required. */
+    slot?: V2Slot;
+    /** Whether this available slot is bookable. */
+    bookable?: boolean;
+    /**
+     * Total number of spots for this availability.
+     * For example, for a class of 10 spots with 3 spots booked, `spotsTotal` is 10, `openSpots` is 7.
+     */
+    totalSpots?: number | null;
+    /**
+     * Number of open spots for this availability.
+     * For appointment if there are existing bookings with overlapping time, service & resource, `openSpots` is 0, otherwise `openSpots` is 1.
+     */
+    openSpots?: number | null;
+    /** An object describing the slot's waiting-list and its occupancy. */
+    waitingList?: WaitingList;
+    /** Indicators for booking policy violations for the slot. */
+    bookingPolicyViolations?: BookingPolicyViolations;
+    /** Indicates whether this slot is locked. */
+    locked?: boolean | null;
+}
+export interface WaitingList {
+    /**
+     * Total number of spots and open spots for this waiting list.
+     * For example, a Yoga class of 10 waiting list spots with 3 registered on the waiting list  has total_spots: 10 and open_spots: 7.
+     */
+    totalSpots?: number | null;
+    openSpots?: number | null;
+}
+export interface BookingPolicyViolations {
+    /** Bookings policy violation. Too early to book this slot. */
+    tooEarlyToBook?: boolean | null;
+    /** Bookings policy violation. Too late to book this slot. */
+    tooLateToBook?: boolean | null;
+    /** Bookings policy violation. Online booking is disabled for this slot. */
+    bookOnlineDisabled?: boolean | null;
+}
+export interface BookingPolicySettings {
+    /** Booking policy settings for a given Slot/Schedule */
+    maxParticipantsPerBooking?: number | null;
+}
+export interface GetScheduleAvailabilityRequest {
+    /** The schedule ID for which availability is checked. */
+    scheduleId?: string;
+}
+export interface GetScheduleAvailabilityResponse {
+    availability?: ScheduleAvailability;
+    bookingPolicySettings?: BookingPolicySettings;
+}
+export interface ScheduleAvailability {
+    totalSpots?: number | null;
+    openSpots?: number | null;
+    /** Indicators of booking policy violations for the given Schedule. */
+    bookingPolicyViolations?: BookingPolicyViolations;
+}
+export interface ConfirmOrDeclineRequest {
+    /** ID of the booking to be confirmed or declined. */
+    bookingId?: string;
+    /** Will be updated on the booking to indicate the payment status. */
+    paymentStatus?: PaymentStatus;
+    /** Contact's ID. */
+    contactId?: string | null;
+}
+export interface ConfirmOrDeclineResponse {
+    booking?: Booking;
+}
+export interface ConfirmOrDeclineBookingRequest {
+    /** ID of the booking to be confirmed or declined. */
+    bookingId?: string;
+    /** Will be passed to bookings.update to indicate the payment status. */
+    paymentStatus?: PaymentStatus;
+    /** Contact's ID. */
+    contactId?: string | null;
+}
+export interface ConfirmOrDeclineBookingResponse {
+    booking?: Booking;
+}
+export interface V2CreateBookingRequest extends V2CreateBookingRequestBookableItemOneOf, V2CreateBookingRequestParticipantsInfoOneOf {
+    /** Contact details of the customer booking the service. */
+    contactDetails?: ContactDetails;
+    /**
+     * Additional custom fields of the booking form. The customer must provide
+     * information for each field when booking the service. For example, that they
+     * bring their own towels or whether they use a wheelchair.
+     *
+     * Max: 100 fields
+     */
+    additionalFields?: CustomFormField[];
+    /**
+     * Total number of participants. Available only when the service doesn't have
+     * [variants](https://dev.wix.com/api/rest/wix-bookings/service-options-and-variants/introduction).
+     *
+     * Max: `20`
+     */
+    numberOfParticipants?: number | null;
+    /**
+     * Internal business note. Not visible to the customer.
+     *
+     * Max: 200 characters
+     */
+    internalBusinessNote?: string | null;
+    /**
+     * Payment option the customer intends to use.
+     * Must be one of the payment options defined for the service, unless
+     * you pass `flowControlSettings.skipSelectedPaymentOptionValidation` as `true`.
+     */
+    selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Identifies the source (platform, actor and app) that created this booking.
+     * This property of the booking cannot be changed.
+     * The app_def_id and app_name will be resolved automatically.
+     * TODO GAP See if we need this - might be able to get this data from the headers?
+     */
+    bookingSource?: BookingSource;
+    /**
+     * A user identifier of an external application user that initiated the book request.
+     * Allows an external application to later identify its own bookings and correlate to its own internal users
+     */
+    externalUserId?: string | null;
+    /** Information about a message to send to the customer. */
+    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`.
+     *
+     * Default: `true`.
+     */
+    sendSmsReminder?: boolean | null;
+    /**
+     * Information about whether specific procedures of the standard Wix Bookings
+     * creation flow are changed. For example, whether the availability is
+     * checked before creating the booking or if additional payment options are
+     * accepted.
+     */
+    flowControlSettings?: CreateBookingRequestFlowControlSettings;
+    /**
+     * Information about the slot to create a booking for.
+     * If you set `slot.location.locationType` to `CUSTOM`, the created slot's
+     * location is set to `slot.location.formattedAddress` when provided.
+     * Otherwise it's set to `contactDetails.fullAddress.formattedAddress`.
+     */
+    slot?: Slot;
+    /** Information about the schedule to create a booking for. */
+    schedule?: BookedSchedule;
+}
+/** @oneof */
+export interface V2CreateBookingRequestBookableItemOneOf {
+    /**
+     * Information about the slot to create a booking for.
+     * If you set `slot.location.locationType` to `CUSTOM`, the created slot's
+     * location is set to `slot.location.formattedAddress` when provided.
+     * Otherwise it's set to `contactDetails.fullAddress.formattedAddress`.
+     */
+    slot?: Slot;
+    /** Information about the schedule to create a booking for. */
+    schedule?: BookedSchedule;
+}
+/** @oneof */
+export interface V2CreateBookingRequestParticipantsInfoOneOf {
+}
+export interface Slot {
+    /**
+     * ID for the slot's corresponding session, when the session is either a single session
+     * or a specific session generated from a recurring session.
+     */
+    sessionId?: string | null;
+    /** Service ID. */
+    serviceId?: string;
+    /** Schedule ID. */
+    scheduleId?: string;
+    /**
+     * The start time of this slot in [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
+     * format.
+     *
+     * If `timezone` is specified,
+     * dates are based on the local date/time. This means that the timezone offset
+     * in the `start_date` is ignored.
+     */
+    startDate?: string | null;
+    /**
+     * The end time of this slot in
+     * [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) format.
+     *
+     * If `timezone` is specified,
+     * dates are based on the local date/time. This means that the timezone offset
+     * in the `end_date` is ignored.
+     */
+    endDate?: string | null;
+    /**
+     * The timezone for which slot availability is to be calculated.
+     *
+     * Learn more about [handling Daylight Savings Time (DST) for local time zones](https://dev.wix.com/api/rest/wix-bookings/availability-calendar/query-availability#wix-bookings_availability-calendar_query-availability_handling-daylight-savings-time-dst-for-local-time-zones)
+     * when calculating availability.
+     */
+    timezone?: string | null;
+    /**
+     * The resource required for this slot. Currently, the only supported resource
+     * is the relevant staff member for the slot.
+     */
+    resource?: SlotResource;
+    /** Geographic location of the slot. */
+    location?: Location;
+}
+export interface SlotResource {
+    /**
+     * Resource ID.
+     * @readonly
+     */
+    id?: string | null;
+    /** Resource name. Read only. */
+    name?: string | null;
+}
+export interface CreateBookingRequestFlowControlSettings {
+    /**
+     * Whether the availability is checked before creating the booking. When
+     * passing `false` a booking is only created when the slot or schedule is
+     * available. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     *
+     * Default: `false`.
+     */
+    skipAvailabilityValidation?: boolean;
+    /**
+     * 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
+     * when passing `true`.
+     *
+     * Default: `false`.
+     */
+    skipBusinessConfirmation?: boolean;
+    /**
+     * 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
+     * `true`.
+     *
+     * Default: `false`.
+     */
+    skipSelectedPaymentOptionValidation?: boolean;
+}
+export interface V2CreateBookingResponse {
+    /** Created booking. */
+    booking?: Booking;
+}
+export interface V2CancelBookingRequest {
+    /** ID of the booking to cancel. */
+    bookingId: string;
+    /**
+     * Information about whether to notify the customer about the cancelation and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes,
+     * the current revision must be passed when managing the booking.
+     */
+    revision: string | null;
+}
+export interface V2CancelBookingRequestFlowControlSettings {
+    /**
+     * Whether the cancelation policy applies when canceling the booking. When
+     * passing `false` you can only cancel a booking if the cancelation policy
+     * allows it. Your app must have the `BOOKINGS.IGNORE_BOOKING_POLICY `
+     * permission scope when passing `true`.
+     *
+     * Default: `false`.
+     *
+     * <!--ONLY:VELO
+     * Requires "Manage Wix Bookings App" and "Manage Bookings' Calendar" [roles](https://support.wix.com/en/article/roles-permissions-overview#bookings-admin).
+     * <!--END:ONLY:VELO-->
+     */
+    ignoreCancellationPolicy?: boolean;
+    /**
+     * Whether to issue a refund when canceling the booking.
+     * The refund will be issued only if the booking is refundable.
+     * Currently, booking is considered refundable when it was paid by membership.
+     * If passing `true`, the booking flow control settings will be set with refund,
+     * otherwise, either if `false` is passed or the field remains empty,
+     * the booking flow control settings will be set with no refund.
+     *
+     * Default: `false`.
+     */
+    withRefund?: boolean | null;
+}
+export interface V2CancelBookingResponse {
+    /** Canceled booking. */
+    booking?: Booking;
+}
+export interface V2RescheduleBookingRequest extends V2RescheduleBookingRequestParticipantsInfoOneOf {
+    /** Id of the booking to reschedule. */
+    bookingId: string;
+    /** Information about the new slot. */
+    slot: Slot;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the rescheduling and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+}
+/** @oneof */
+export interface V2RescheduleBookingRequestParticipantsInfoOneOf {
+}
+export interface V2RescheduleBookingRequestFlowControlSettings {
+    /**
+     * Whether the rescheduling policy applies when rescheduling the booking.
+     * When passing `false` you can only cancel a booking if the rescheduling
+     * policy allows it. Your app must have the `BOOKINGS.IGNORE_BOOKING_POLICY `
+     * permission scope when passing `true`.
+     *
+     * Default: `false`.
+     *
+     * <!--ONLY:VELO
+     * Requires "Manage Wix Bookings App" and "Manage Bookings' Calendar" [roles](https://support.wix.com/en/article/roles-permissions-overview#bookings-admin).
+     * <!--END:ONLY:VELO-->
+     */
+    ignoreReschedulePolicy?: boolean;
+    /**
+     * Whether the availability is checked before rescheduling the booking.
+     * When passing `false` a booking is only created when the slot or
+     * schedule is available. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     *
+     * Default: `false`.
+     */
+    skipAvailabilityValidation?: boolean;
+    /**
+     * Whether the rescheduled booking's status is automatically set to
+     * `CONFIRMED` for services that normally require the owner's manual
+     * confirmation. Your app must have the `BOOKINGS.OVERRIDE_AVAILABILITY`
+     * permission scope when passing `true`.
+     *
+     * Default: `false`.
+     */
+    skipBusinessConfirmation?: boolean;
+}
+export interface V2RescheduleBookingResponse {
+    /** Rescheduled booking. */
+    booking?: Booking;
+}
+export interface V2ConfirmBookingRequest {
+    /** ID of the booking to confirm. */
+    bookingId: string;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the confirmation and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+}
+export interface V2ConfirmBookingResponse {
+    booking?: Booking;
+}
+export interface V2DeclineBookingRequest {
+    /** ID of the booking to decline. */
+    bookingId: string;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+    /**
+     * Information about whether to notify the customer about the decline and
+     * the message to send.
+     */
+    participantNotification?: ParticipantNotification;
+}
+export interface V2DeclineBookingResponse {
+    /** Declined booking. */
+    booking?: Booking;
+}
+export interface V2UpdateNumberOfParticipantsRequest extends V2UpdateNumberOfParticipantsRequestParticipantsInfoOneOf {
+    /** ID of the booking to update the number of participants for. */
+    bookingId: string;
+    /** Updated number of participants. */
+    numberOfParticipants?: number | null;
+    /**
+     * Revision number, which increments by 1 each time the booking is updated.
+     * To prevent conflicting changes, the current revision must be passed when
+     * managing the booking.
+     */
+    revision: string | null;
+}
+/** @oneof */
+export interface V2UpdateNumberOfParticipantsRequestParticipantsInfoOneOf {
+}
+export interface V2UpdateNumberOfParticipantsResponse {
+    /** Booking with updated number of participants. */
+    booking?: Booking;
+}