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

Refresh calendars for a connected room booking account

Synchronizes the calendars visible to a connected room booking account from its provider. Use this operation to refresh the account's calendar list so newly available rooms can be selected. After synchronization, retrieve the calendars with the room booking calendars endpoint.

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

3 parameters
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 synchronize.

5 status codes
200Returns the synchronized integration details, including its calendar counts and synchronization timestamps.
dataobjectoptional
401Returned when the request is unauthorized.
errorstringoptional
404Returned when the integration is of a different type than the requested `integration_type`.
422Returned when the calendar provider cannot be read.
429Returned when the account has reached its hourly synchronization limit.
errorstringoptional

Error handling

A 401 is returned when the authenticated user is unauthorized, a 404 when the integration is of another type, a 422 when the provider cannot be read, and a 429 when the account has reached its hourly sync limit. The integration_type path parameter must be one of google_user, google_workspace, microsoft_user, or microsoft_workspace, and the id path parameter must identify an integration of that type.