This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Replaces the list of the locations (SDK | REST) where the business offers the service.
Removing a service location may impact existing sessions and their
participants. If you remove at least one service location, you must
specify removedLocationSessionsAction
to indicate what happens to all
future sessions scheduled at this location.
{"removedLocationSessionsAction.action": "KEEP_AT_CURRENT_LOCATION"}
.
This ensures nothing changes for the customer, but the business must be
able to provide access to the removed location in the future.{"removedLocationSessionsAction.action": "MOVE_TO_LOCATION"}
and
moveToLocationOptions.newLocation
.You can't mix and match to keep some sessions at the previous location while moving other sessions to an updated location.
Past session details aren't changed, no matter which option you choose for future sessions.
Future sessions scheduled for a location defined by the customer are also not updated.
Depending on whether the new or updated location is a business or custom location, you need to specify different fields.
locations.business.id
.locations.custom.address
.You can specify a participantNotification.message
that's immediately send
to all customers who had booked at a changed location. Ensure
participantNotification.notifyParticipants
is set to true
to send the
message.
You can only call this method when authenticated as a Wix app or Wix user identity.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.