Edit vacation block

Update an existing all-day vacation blackout for Harbor Soho so peak-season staffing rules stay aligned with the current operation.

In this article

Use this guide when an existing vacation block needs a new date range, scope, reason, or repeat rule.

In the GB demo, Harbor Demo Group uses Harbor Soho and the Peak season blackout example.

Before you start

Harbor Demo Group is active and Harbor Soho is the selected location.
An existing vacation blackout calendar event is available for Harbor Soho, such as Peak season blackout.
Your user can view the event and has vacation-blackout:manage to save changes.
Staff and staff roles are available if the block is scoped to specific roles or staff members.

1.
Open the vacations calendar
From Harbor Soho, open the Vacations calendar and find the existing Peak season blackout in the relevant month view.
2.
Open the blackout
Select the blackout event. Users with management permission reach the Edit vacation block form; users with view-only access see a read-only event detail.
3.
Review the Info tab
Check the current start date, end date, scope, and reason. The form edits all-day blocked dates rather than precise working hours.
4.
Adjust scope and reason
Choose Total, Role, or Staff scope. Role scope requires at least one staff role, Staff scope requires at least one staff member, and every update needs a clear reason.
5.
Update repeat settings
Open the Repeat tab when the blackout should recur, then choose a valid daily, weekly, monthly, or yearly rule with its interval and end settings.
6.
Save the update
Select Save. The app validates the change, updates the existing vacation blackout event, and returns to the originating calendar route on success.
7.
Cancel or recover from errors
Use Cancel or back to leave without saving. If the API rejects the update, the form stays open and shows the resolved error message.

The selected organisation and location must be present before the form can load.
The event must exist in the current location and keep kind vacation_blackout.
Start and end dates are required, and the start must be before the end.
Reason is required.
Role scope requires at least one staff role; Staff scope requires at least one staff member.
The update cannot change kind and only accepts reason, scope, staff_role_ids, and staff_ids in the vacation_blackout payload.
The dedicated edit form does not expose deletion, and recurrence removal was not verified for this form.

The vacation blackout is updated for Harbor Soho, and later staff vacation creation or edits are validated against the revised rule.