Block off time
Block a time range on a calendar so no new client can book it.
POST https://cotlet.dev/api/v1/acuity-scheduling/calendars/{calendar_id}/off-time/block
write Confirm
Adds a time block on one calendar, with optional notes. It stops new bookings in that range, but an appointment already there stays on the calendar, and group classes are not affected. Returns the block ID and a readable description of the range. Remove a block in Acuity under Availability, Edit Availability/Limits, Blocked Time. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| calendar_id integer required | integer | Calendar to block. |
| start string required | string | Start of the block, e.g. '2026-11-05T09:00:00-0500'. |
| end string required | string | End of the block, e.g. '2026-11-05T17:00:00-0500'. |
| notes string | string | Note for yourself on the block. |
Request
curl -X POST https://cotlet.dev/api/v1/acuity-scheduling/calendars/1/off-time/block \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"start":"2026-11-05T09:00:00-0500","end":"2026-11-05T17:00:00-0500"}'result = client.call("acuity-scheduling", "block_off_time", {"calendar_id":1,"start":"2026-11-05T09:00:00-0500","end":"2026-11-05T17:00:00-0500"})const result = await cotlet.call('acuity-scheduling', 'block_off_time', {"calendar_id":1,"start":"2026-11-05T09:00:00-0500","end":"2026-11-05T17:00:00-0500"});cotlet call acuity-scheduling block_off_time --data '{"calendar_id":1,"start":"2026-11-05T09:00:00-0500","end":"2026-11-05T17:00:00-0500"}'Example response
{
"block_id": 7790112,
"notes": "Out sick",
"description": "Thursday 5 November 2026 9:00am - 5:00pm"
}