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

Update a room booking integration

Updates the calendars synchronized for a connected room booking account and its workspace settings. When you provide calendar_ids, it replaces the entire selected set, so any omitted calendar stops syncing and is removed from screens and collections. Use the organizer and parking resource fields for Microsoft workspace integrations; their values are verified against Graph.

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

3 parameters · 3 body fields
installation_idstringrequired
The unique identifier of the room booking installation.
integration_typestringrequired
The account integration type: `google_user`, `google_workspace`, `microsoft_user`, or `microsoft_workspace`.
Allowed:google_usergoogle_workspacemicrosoft_usermicrosoft_workspace
idintegerrequired
The numeric identifier of the integration to update.

Integration settings to update. For Microsoft workspace integrations, you can provide organizer and parking resource settings.

booking_organizer_emailstringoptional
The booking organizer email address for a Microsoft workspace integration; the value is verified against Graph.
calendar_idsarray<integer>optional
The numeric identifiers of the account's calendars to sync. When provided, this is the complete set; omitted calendars stop syncing and are removed from screens and collections.
parking_resource_group_idstringoptional
The Microsoft workspace parking resource group identifier, verified against Graph.

4 status codes
200Returns the updated integration details, including its selected calendar count and workspace settings.
dataobjectoptional
401Returned when the request is unauthorized.
errorstringoptional
404Returned when the installation belongs to another user.
422Returned when Graph cannot verify the booking organizer mailbox.

Error handling

A 401 is returned when the authenticated user is unauthorized, a 404 when the installation belongs to another user, and a 422 when Graph cannot verify the organizer mailbox. The integration_type path parameter must be one of google_user, google_workspace, microsoft_user, or microsoft_workspace; calendar_ids, when provided, replaces the full set of calendars to sync.