Reservation resource exceptions

Date-specific overrides of the weekly availability: close a resource (or the whole organization) on a date, or give a resource different hours that day.

Endpoints

MethodPathDescription
GET/reservation-resource-exceptionsList exceptions
GET/reservation-resource-exceptions/:idGet an exception
POST/reservation-resource-exceptionsCreate an exception
PATCH/reservation-resource-exceptions/:idUpdate an exception
DELETE/reservation-resource-exceptions/:idDelete an exception

The exception object

json

Fields

FieldTypeDescription
idintegerRead-only. Unique ID.
organization_idintegerOwning organization. Required on create; must be the API key's organization.
resource_idinteger | nullResource affected. null = organization-wide (applies to every resource).
exception_typestringOne of blocked, special_hours, holiday. Required on create. See below.
datestring (YYYY-MM-DD)Date affected. Required on create. Send YYYY-MM-DD; it is returned as a midnight timestamp (2026-12-24T00:00:00.000Z), so use the date part.
start_timestring | nullFor special_hours: opening time that day, HH:mm.
end_timestring | nullFor special_hours: closing time that day, HH:mm.
reasonstring | nullFree-text reason, max 255 characters.
is_recurring_yearlybooleanDefault false. Stored only: exceptions apply only to their exact date; create one per year if needed.
created_atstring (date-time)Read-only. Creation time.
updated_atstring (date-time)Read-only. Last update time.
deleted_atstring (date-time) | nullRead-only. Set when the exception is deleted.

exception_type

ValueEffect
blockedWith a resource_id: the resource is unavailable all day (no slots from it, and reservations needing it are rejected). With resource_id: null: the whole date is closed, available slots returns "This date is blocked" for every service, and reservations on services with linked resources are rejected.
special_hoursReplaces the resource's weekly hours with start_time–end_time on that date when computing available slots. Requires a resource_id; organization-wide special_hours are ignored. Reservation creation still validates against the weekly hours.
holidayStored only; has no effect on slots or bookings. Use blocked to close a date.

Related

Report an issue with this documentation

Please log in to report issues with our documentation.