removeBookingsFromMultiServiceBooking( )


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Removes single-service bookings from a multi-service booking and converts them to independent single-service bookings.

Removal options

Remove all permitted bookings: If you specify an empty bookings array, all single-service bookings for which the call's identity has read permissions are removed from the multi-service booking.

Selective removal: Specify single-service booking IDs and revisions to remove only specific single-service bookings from the package.

Sequential scheduling: To maintain sequential scheduling, remove only first or last single-service bookings. For middle bookings, first reschedule all relevant single-service bookings to eliminate gaps. To do so, call Reschedule Multi Service Booking (SDK | REST) before removing the unwanted bookings.

Removal behavior

Independent bookings: Removed single-service bookings become independent bookings. You can manage them using single-service booking methods.

Automatic cleanup: Multi-service bookings must contain at least 2 services. If removal results in only 1 remaining single-service booking for the multi-service booking, the entire multi-service booking is deleted and the remaining single-service booking becomes a standalone booking.

Revision control: Specify current revision numbers to prevent conflicting modifications during the removal process.

Authentication
  • When developing websites or building an app with Blocks, this method may require elevated permissions, depending on the identity of the user calling it and the calling user's permissions.
  • When building apps without Blocks or for headless projects, you can only call this method directly when authenticated as a Wix app or Wix user identity. When authenticated as a different identity, you can call this method using elevation.
  • Elevation permits users to call methods they typically cannot access. Therefore, you should only use it intentionally and securely.
Permissions
Manage Bookings
Learn more about app permissions.
Method Declaration
Copy
Method Parameters
multiServiceBookingIdstringRequired

ID of the multi-service booking.


optionsRemoveBookingsFromMultiServiceBookingOptions
Returns
Return Type:Promise<RemoveBookingsFromMultiServiceBookingResponse>
Errors
404Not Found

There are 2 errors with this status code.

428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?