Calendar: Days

Base URL: $BUSINESS_API

List holidays, closures and extra working days

Logs

GET /calendar/days

Lists the tenant's dated exceptions (holidays, closures and extra working days), sorted by date, in a data array without pagination. Each day records where it came from (manual, file, url, connector or template). Recurring rules are not expanded here; use the rules endpoint or the occurrences evaluator for them. Requires automations:read.

Parameters

fromstring (date-time) · query · optional

Earliest date to include, as YYYY-MM-DD, inclusive; omitted means no lower bound.

tostring (date-time) · query · optional

Latest date to include, as YYYY-MM-DD, inclusive; omitted means no upper bound.

area_idstring · query · optional

Service area id; when set, the list holds that area's days plus the tenant-wide days that have no area, and when omitted it holds every day of the tenant.

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 Calendar days

Permissions automations:read · Roles: admin, analyst, customer_service, finance, operations, owner

curl -X GET "$BUSINESS_API/calendar/days" \
  -H "Authorization: Bearer sk_test_..."
Response 200

Calendar days

Add a holiday, closure or extra working day

Logs

POST /calendar/days

Adds one dated exception to the tenant calendar and returns it with 201. The date must be YYYY-MM-DD and kind must be holiday (the default), closure or working; a working day overrides a weekday that is normally off, and a holiday or closure makes the date non-working for schedules. name_pt falls back to name and name_en falls back to name_pt; the day is stored with source manual. Requires automations:write.

Body application/json

datestring (date-time) · required
kindstring · optional · default holiday

one of holiday, closure, working

namestring · optional
area_idstring · optional

Returns

201 Created day

Errors 400

Permissions automations:write · Roles: admin, finance, operations, owner

curl -X POST "$BUSINESS_API/calendar/days" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-11-19T09:30:00Z",
  "kind": "holiday",
  "name": "Ana Matsinhe",
  "area_id": "are_2ZTQYjrK63ZImD3sMz1O2BhWeZV"
}'
Response 201

Created day

Remove a calendar day

Logs

DELETE /calendar/days/{id}

Removes one dated exception from the tenant calendar and returns 204 with no body. Schedules evaluated afterwards treat the date by its normal weekday again. Returns 404 when the day does not exist in this tenant. Requires automations:write.

Parameters

idstring · path · required

Id of the calendar day to delete, as returned when it was added or listed (prefix cdy).

Returns

204 Deleted

Errors 404

Permissions automations:write · Roles: admin, finance, operations, owner

curl -X DELETE "$BUSINESS_API/calendar/days/{id}" \
  -H "Authorization: Bearer sk_test_..."
Response 204

Deleted