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
The exception object
Fields
| Field | Type | Description |
|---|
id | integer | Read-only. Unique ID. |
organization_id | integer | Owning organization. Required on create; must be the API key's organization. |
resource_id | integer | null | Resource affected. null = organization-wide (applies to every resource). |
exception_type | string | One of blocked, special_hours, holiday. Required on create. See below. |
date | string (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_time | string | null | For special_hours: opening time that day, HH:mm. |
end_time | string | null | For special_hours: closing time that day, HH:mm. |
reason | string | null | Free-text reason, max 255 characters. |
is_recurring_yearly | boolean | Default false. Stored only: exceptions apply only to their exact date; create one per year if needed. |
created_at | string (date-time) | Read-only. Creation time. |
updated_at | string (date-time) | Read-only. Last update time. |
deleted_at | string (date-time) | null | Read-only. Set when the exception is deleted. |
exception_type
| Value | Effect |
|---|
blocked | With 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_hours | Replaces 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. |
holiday | Stored only; has no effect on slots or bookings. Use blocked to close a date. |
Related