---
title: "Change the settings of a room booking installation"
method: PATCH
path: "/api/apps/room_booking/{installation_id}/settings"
tags: ["Apps - Room Booking"]
---

# Change the settings of a room booking installation

`PATCH /api/apps/room_booking/{installation_id}/settings`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/apps/room_booking/{installation_id}/settings`
- Auth: HTTP bearer

Keys left out keep their value. The company logo images are uploaded in the browser; show_company_logo only switches them on.

## Request body

- object
  - `timezone` string, nullable: IANA name for every calendar without its own; null follows the owner
  - `public_bookings` boolean: Booking with TRMNL
  - `dark_mode` boolean
  - `show_company_logo` boolean
  - `daily_public_booking_url_rotation` boolean
  - `time_format` 'null' | '24_hour' | '12_hour', nullable: null detects it from the time zone
  - `walk_up_calendar` boolean: Upcoming bookings on the public booking page
  - `walk_up_booking_window_days` 1 | 2 | 7 | 30

## Response `200`

Updated

- object
  - `data` RoomBookingSettings
    - `timezone` string, nullable
    - `public_bookings` boolean: Booking with TRMNL
    - `dark_mode` boolean
    - `show_company_logo` boolean
    - `daily_public_booking_url_rotation` boolean
    - `time_format` 'null' | '24_hour' | '12_hour', nullable: null detects it from the time zone
    - `walk_up_calendar` boolean
    - `walk_up_booking_window_days` 1 | 2 | 7 | 30
    - `company_logo_attached` boolean
    - `color_company_logo_attached` boolean

## Other responses

- `401`: Unauthorized
- `404`: Installation belongs to another user
- `422`: A time zone that does not exist

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)