TRMNL Octri Demo
PATCH/api/apps/room_booking/{installation_id}/calendars/{id}

Update a room booking calendar

Updates a room booking calendar's settings. Supply fields appropriate to the calendar type: iCal calendars use name, ics_url, timezone, and capacity, while Google and Microsoft calendars use override_name; both types support show_booking_qr and show_company_logo. The response includes the updated calendar.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 7 body fields
installation_idstringrequired
The unique identifier of the room booking installation.
idstringrequired
The calendar identifier returned by the calendar list.

Settings to update on the calendar; available fields depend on the calendar provider.

capacityintegeroptional
The calendar's booking capacity.
ics_urlstringoptional
The iCal feed URL.
namestringoptional
The calendar name, used for iCal calendars.
override_namestringoptional
Google and Microsoft calendars only
show_booking_qrbooleanoptional
Whether to show the booking QR code.
show_company_logobooleanoptional
Whether to show the company logo.
timezonestringoptional
The calendar time zone.

4 status codes
200Returns the updated calendar, including its identifier, type, name, booking settings, and sync details.
dataobjectoptional
401Returned when the request is unauthorized.
errorstringoptional
404Returned when the installation belongs to another user.
422Returned when the requested calendar update is refused.

Error handling

A 401 is returned when the request is unauthorized. A 404 is returned when the installation belongs to another user; the installation_id path parameter must identify the room booking installation, and the id path parameter must identify its calendar. A 422 is returned when the requested change is refused; use fields appropriate to the calendar type.