> For the complete documentation index, see [llms.txt](https://mobile-calendar.gitbook.io/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mobile-calendar.gitbook.io/v1/rest-api/settings.md).

# Settings

Account settings (panel → Settings).

## Get account settings

> Returns all account settings (panel → Settings): general, calendar, reservation form, invoices, OTA/iCal sync, notifications and pricing grid. For an employee token the employee's own settings are returned, with the owner-only invoice settings taken from the account owner. \`meta.editDate\` is the last modification time. Required scope: \`settings.read\`.

```json
{"openapi":"3.0.0","info":{"title":"Public REST API v1 – mobile-calendar.com","version":"1.0.0"},"tags":[{"name":"settings","description":"Account settings (panel → Settings)."}],"servers":[{"url":"https://api.mobile-calendar.com/v1/public","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","description":"Pass the token in header: Authorization: Bearer <JWT>","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"SettingsResponse":{"description":"Settings with metadata","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/SettingsEntry"},"meta":{"type":"object","allOf":[{"$ref":"#/components/schemas/MetaWithRuid"},{"properties":{"editDate":{"description":"Last modification time (UTC, ISO 8601); null when the account still uses defaults.","type":"string","format":"date-time","nullable":true}},"type":"object"}]}},"type":"object"},"SettingsEntry":{"description":"All account settings (panel → Settings). Booleans are real booleans; colours are HEX; times are HH:MM in the account time zone. Fields marked 'Owner only' are read from the account owner for employees and cannot be changed by them.","required":["generalHomepage","generalThemeMode","generalDateFormat","generalTimeFormat","generalFirstDayOfWeek","generalMeasurementSystem","timeZone","calendarCalendarDate","calendarShape","calendarLabels","calendarFastViewTurnOn","calendarFastView","calendarDragAndDrop","calendarDisplaySource","calendarDisplayCheckInOut","calendarColorsTurnOn","calendarColorsNoPayment","calendarColorsWaitingForPrepayment","calendarColorsPaidPrepayment","calendarColorsPaidAll","calendarColorsWaitingForPayment","reservationFormView","reservationField","reservationConfirmation","reservationAutomaticPrepaymentAmountTurnOn","reservationAutomaticPrepaymentAmountType","reservationAutomaticPrepaymentAmountPrice","reservationAutomaticPrepaymentDaysTurnOn","reservationAutomaticPrepaymentDays","reservationCheckInCheckOutHoursTurnOn","reservationDefaultInfo","reservationLockAsReservationTurnOn","reservationAutomaticColorChangeOnCheckinTurnOn","reservationAutomaticColorChangeOnCheckinColor","reservationAutomaticColorChangeOnCheckoutTurnOn","reservationAutomaticColorChangeOnCheckoutColor","roomDirtyRoomCheckOutTurnOn","invoicesDefaultRate","invoicesFormDataDefaultSource","invoicesCompanyName","invoicesAddress","invoicesTaxId","invoicesBankAccountNumber","invoicesIssuePlace","invoicesAdditionalInformations","invoicesAutoDocsFill","invoicesKsefJstTurnOn","invoicesNumberingType","invoicesFormat","syncBookingStatusDefaultStatus","syncBookingColorDefaultColor","syncAirbnbColorDefaultColor","syncBookingPaymentDefaultPayment","syncChannelManagerNotificationEmail","syncChannelManagerNotificationPush","syncIcalendarImport","notificationsShowNewChanges","notificationsPushArrivalsDepartures","notificationsPushArrivalsDeparturesTime","notificationsPushPrepayments","notificationsPushPrepaymentsTime","notifySound","pricingRestrictions"],"properties":{"generalHomepage":{"description":"Panel start page.","type":"string","enum":["calendar","dashboard"]},"generalThemeMode":{"description":"Panel theme: 0 = light, 1 = dark, 2 = follow system.","type":"integer","enum":[0,1,2]},"generalDateFormat":{"description":"Date format used in the panel and in messages/confirmations.","type":"string","enum":["YYYY-MM-DD","DD-MM-YYYY","YYYY/MM/DD","DD/MM/YYYY","YYYY.MM.DD","DD.MM.YYYY","DD MMM YYYY","ddd DD MMM"]},"generalTimeFormat":{"description":"Time format: 24h (`HH:mm`) or 12h (`hh:mm A`).","type":"string","enum":["HH:mm","hh:mm A"]},"generalFirstDayOfWeek":{"description":"First day of the week in calendars.","type":"string","enum":["MON","SUN"]},"generalMeasurementSystem":{"description":"Measurement system (room size etc.).","type":"string","enum":["METRIC","IMPERIAL"]},"timeZone":{"description":"Account time zone (canonical IANA identifier, e.g. `Europe/Warsaw`) — used by automatic messages, door locks and the booking engine.","type":"string","enum":["Africa/Cairo","Africa/Johannesburg","Africa/Lagos","America/Anchorage","America/Argentina/Buenos_Aires","America/Chicago","America/Denver","America/Los_Angeles","America/Mexico_City","America/New_York","America/Santiago","America/Sao_Paulo","Asia/Bangkok","Asia/Dubai","Asia/Hong_Kong","Asia/Jakarta","Asia/Jerusalem","Asia/Karachi","Asia/Kolkata","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Tokyo","Australia/Adelaide","Australia/Brisbane","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Copenhagen","Europe/Dublin","Europe/Helsinki","Europe/Istanbul","Europe/Kyiv","Europe/Lisbon","Europe/London","Europe/Madrid","Europe/Oslo","Europe/Paris","Europe/Prague","Europe/Rome","Europe/Stockholm","Europe/Vienna","Europe/Warsaw","Pacific/Auckland","Pacific/Fiji","Pacific/Honolulu","Pacific/Port_Moresby"]},"calendarCalendarDate":{"description":"Show the date picker on the calendar toolbar.","type":"boolean"},"calendarShape":{"description":"Rounded (true) or square (false) reservation bars.","type":"boolean"},"calendarLabels":{"description":"Fields printed on the reservation bar, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarFastViewTurnOn":{"description":"Show the quick-view popover when hovering a reservation.","type":"boolean"},"calendarFastView":{"description":"Fields shown in the quick-view popover, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","payment","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarDragAndDrop":{"description":"Allow moving/resizing reservations by drag and drop.","type":"boolean"},"calendarDisplaySource":{"description":"Show the reservation source icon on the bar.","type":"boolean"},"calendarDisplayCheckInOut":{"description":"Show check-in / check-out markers on the bar.","type":"boolean"},"calendarColorsTurnOn":{"description":"Colour reservation bars by payment status (using the `calendarColors*` colours).","type":"boolean"},"calendarColorsNoPayment":{"description":"Bar colour: no payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPrepayment":{"description":"Bar colour: waiting for prepayment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidPrepayment":{"description":"Bar colour: prepayment paid.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidAll":{"description":"Bar colour: paid in full.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPayment":{"description":"Bar colour: waiting for payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationFormView":{"description":"Reservation form layout: `TAB` = split into tabs, `NORMAL` = single page.","type":"string","enum":["NORMAL","TAB"]},"reservationField":{"description":"Optional sections visible in the reservation form.","type":"array","items":{"type":"string","enum":["hours","adults","children","registration","moreClientData","source","meals","additionalServices","doorCode","discount"]}},"reservationConfirmation":{"description":"Fields printed on the reservation confirmation (PDF/e-mail).","type":"array","items":{"type":"string","enum":["roomName","additionalInformations","addDate","companyName","taxId","bankAccountNo","objectName","street","city","postalCode","country","objectPhone","objectEmail","website","checkIn","checkOut","reservationNo","arrival","departure","daysStay","adults","children","forename","name","phone","email","payment","toPay","room","meals","additionalServices","localTax","source","idCard","guestSignature","hotelSignature"]}},"reservationAutomaticPrepaymentAmountTurnOn":{"description":"Pre-fill the prepayment amount of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentAmountType":{"description":"How `reservationAutomaticPrepaymentAmountPrice` is interpreted: false = percent of the total, true = fixed amount in the account currency.","type":"boolean"},"reservationAutomaticPrepaymentAmountPrice":{"description":"Default prepayment: percent (0–100) or amount, depending on `reservationAutomaticPrepaymentAmountType`.","type":"number","format":"float","minimum":0,"nullable":true},"reservationAutomaticPrepaymentDaysTurnOn":{"description":"Pre-fill the prepayment due date of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentDays":{"description":"Default number of days the guest has to pay the prepayment.","type":"integer","maximum":365,"minimum":0,"nullable":true},"reservationCheckInCheckOutHoursTurnOn":{"description":"Let the reservation form override the property check-in/check-out hours.","type":"boolean"},"reservationDefaultInfo":{"description":"Text pre-filled in the \"additional information\" field of new reservations.","type":"string","maxLength":65535,"nullable":true},"reservationLockAsReservationTurnOn":{"description":"Treat date locks (blockades) like reservations in statistics and sync.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinTurnOn":{"description":"Recolour the reservation bar automatically on check-in.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinColor":{"description":"Colour applied on check-in.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationAutomaticColorChangeOnCheckoutTurnOn":{"description":"Recolour the reservation bar automatically on check-out.","type":"boolean"},"reservationAutomaticColorChangeOnCheckoutColor":{"description":"Colour applied on check-out.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"roomDirtyRoomCheckOutTurnOn":{"description":"Mark the room as dirty automatically on check-out.","type":"boolean"},"invoicesDefaultRate":{"description":"Default VAT rate for new invoice items, e.g. `23`, `8`, `zw`. Owner only — employees cannot change it (422).","type":"string","maxLength":5},"invoicesFormDataDefaultSource":{"description":"Seller data on invoices: false = account data (/account), true = the `invoices*` fields below. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesCompanyName":{"description":"Seller name printed on invoices (when `invoicesFormDataDefaultSource` is true). Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAddress":{"description":"Seller address printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesTaxId":{"description":"Seller tax ID printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesBankAccountNumber":{"description":"Seller bank account printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesIssuePlace":{"description":"Place of issue printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAdditionalInformations":{"description":"Footer / additional text printed on every invoice. Owner only — employees cannot change it (422).","type":"string","maxLength":65535,"nullable":true},"invoicesAutoDocsFill":{"description":"Pre-fill invoice items from the reservation. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesKsefJstTurnOn":{"description":"KSeF: enables the JST checkbox (invoice for a local-government subordinate unit, Podmiot2/JST=1) and the KSeF role selectors (Podmiot3/Rola) on the invoice form. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesNumberingType":{"description":"Invoice numbering: 0 = monthly (`invoicesFormat` must be a monthly pattern), 1 = yearly. Cannot be changed once an invoice has been issued in the current year (422). Owner only — employees cannot change it (422).","type":"integer","enum":[0,1]},"invoicesFormat":{"description":"Invoice number pattern; must match `invoicesNumberingType` (monthly patterns contain `MM`). Owner only — employees cannot change it (422).","type":"string","enum":["NUMBER/MM/YYYY","YYYY/MM/NUMBER","NUMBER-MM-YYYY","YYYY-MM-NUMBER","NUMBER/YYYY","YYYY/NUMBER","NUMBER-YYYY","YYYY-NUMBER"]},"syncBookingStatusDefaultStatus":{"description":"Payment status assigned to reservations imported from OTAs: 0 = no payment, 1 = prepayment paid, 2 = paid in full.","type":"integer","enum":[0,1,2]},"syncBookingColorDefaultColor":{"description":"Bar colour for reservations imported from OTAs other than Airbnb; null = default colour.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncAirbnbColorDefaultColor":{"description":"Bar colour for reservations imported from Airbnb; null = default colour. Owner only — employees cannot change it (422).","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncBookingPaymentDefaultPayment":{"description":"Payment method assigned to imported reservations: 0 = none, 1 = cash, 2 = bank transfer, 3 = card, 4 = virtual card.","type":"integer","enum":[0,1,2,3,4]},"syncChannelManagerNotificationEmail":{"description":"E-mail notification about channel manager events.","type":"boolean"},"syncChannelManagerNotificationPush":{"description":"Push notification about channel manager events.","type":"boolean"},"syncIcalendarImport":{"description":"Import reservations from connected iCal feeds.","type":"boolean"},"notificationsShowNewChanges":{"description":"Show the \"new changes\" indicator in the panel.","type":"boolean"},"notificationsPushArrivalsDepartures":{"description":"Daily push with today's arrivals and departures.","type":"boolean"},"notificationsPushArrivalsDeparturesTime":{"description":"Time of the arrivals/departures push (`HH:MM`, account time zone).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notificationsPushPrepayments":{"description":"Daily push about overdue prepayments.","type":"boolean"},"notificationsPushPrepaymentsTime":{"description":"Time of the prepayments push (`HH:MM`).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notifySound":{"description":"Notification sound in the panel; null = silent.","type":"string","enum":["DEFINITE"],"nullable":true},"pricingRestrictions":{"description":"Restriction rows visible in the pricing grid.","type":"array","items":{"type":"string","enum":["price1","minStay","maxStay","availArrival","availDeparture","minimumStayArrival","maximumStayArrival","exactStayArrival","closed","minAdvanceRes","maxAdvanceRes"]}}},"type":"object"},"MetaWithRuid":{"description":"Metadata with request tracking.","required":["ruid"],"properties":{"ruid":{"description":"Request Unique ID","type":"string","format":"uuid"}},"type":"object"},"ApiProblem401":{"description":"Missing authentication or invalid credentials.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"401 Unauthorized","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]},"ApiProblemBase":{"description":"RFC 7807 Problem Details (base schema).","required":["type","title","status","detail","instance"],"properties":{"type":{"description":"RFC 7807 base — DO NOT use directly in endpoints.\nIn endpoints reference ApiProblem400/401/403/409/422/429/500.","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"},"ApiProblem403":{"description":"Authenticated user but no access.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"403 Forbidden","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]}}},"paths":{"/settings":{"get":{"tags":["settings"],"summary":"Get account settings","description":"Returns all account settings (panel → Settings): general, calendar, reservation form, invoices, OTA/iCal sync, notifications and pricing grid. For an employee token the employee's own settings are returned, with the owner-only invoice settings taken from the account owner. `meta.editDate` is the last modification time. Required scope: `settings.read`.","operationId":"getSettings","responses":{"200":{"description":"Settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem401"}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem403"}}}}}}}}}
```

## Update account settings (partial)

> Changes only the settings present in the body (see SettingsUpdateRequest); all other settings keep their values. Unknown setting names are rejected. Employees cannot change owner-only (invoice) settings. Required scope: \`settings.update\`.

```json
{"openapi":"3.0.0","info":{"title":"Public REST API v1 – mobile-calendar.com","version":"1.0.0"},"tags":[{"name":"settings","description":"Account settings (panel → Settings)."}],"servers":[{"url":"https://api.mobile-calendar.com/v1/public","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","description":"Pass the token in header: Authorization: Bearer <JWT>","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"SettingsUpdateRequest":{"description":"Partial update — send only the settings to change (any subset of SettingsEntry fields, same types and constraints). Unknown field names are rejected (422), so a typo never becomes a silent no-op. Cross-field rules: `invoicesFormat` must match `invoicesNumberingType` (monthly vs yearly patterns); `invoicesNumberingType` cannot change once an invoice was issued this year. `editDate` from the GET response is ignored.","minProperties":1,"properties":{"generalHomepage":{"description":"Panel start page.","type":"string","enum":["calendar","dashboard"]},"generalThemeMode":{"description":"Panel theme: 0 = light, 1 = dark, 2 = follow system.","type":"integer","enum":[0,1,2]},"generalDateFormat":{"description":"Date format used in the panel and in messages/confirmations.","type":"string","enum":["YYYY-MM-DD","DD-MM-YYYY","YYYY/MM/DD","DD/MM/YYYY","YYYY.MM.DD","DD.MM.YYYY","DD MMM YYYY","ddd DD MMM"]},"generalTimeFormat":{"description":"Time format: 24h (`HH:mm`) or 12h (`hh:mm A`).","type":"string","enum":["HH:mm","hh:mm A"]},"generalFirstDayOfWeek":{"description":"First day of the week in calendars.","type":"string","enum":["MON","SUN"]},"generalMeasurementSystem":{"description":"Measurement system (room size etc.).","type":"string","enum":["METRIC","IMPERIAL"]},"timeZone":{"description":"Account time zone (canonical IANA identifier, e.g. `Europe/Warsaw`) — used by automatic messages, door locks and the booking engine.","type":"string","enum":["Africa/Cairo","Africa/Johannesburg","Africa/Lagos","America/Anchorage","America/Argentina/Buenos_Aires","America/Chicago","America/Denver","America/Los_Angeles","America/Mexico_City","America/New_York","America/Santiago","America/Sao_Paulo","Asia/Bangkok","Asia/Dubai","Asia/Hong_Kong","Asia/Jakarta","Asia/Jerusalem","Asia/Karachi","Asia/Kolkata","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Tokyo","Australia/Adelaide","Australia/Brisbane","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Copenhagen","Europe/Dublin","Europe/Helsinki","Europe/Istanbul","Europe/Kyiv","Europe/Lisbon","Europe/London","Europe/Madrid","Europe/Oslo","Europe/Paris","Europe/Prague","Europe/Rome","Europe/Stockholm","Europe/Vienna","Europe/Warsaw","Pacific/Auckland","Pacific/Fiji","Pacific/Honolulu","Pacific/Port_Moresby"]},"calendarCalendarDate":{"description":"Show the date picker on the calendar toolbar.","type":"boolean"},"calendarShape":{"description":"Rounded (true) or square (false) reservation bars.","type":"boolean"},"calendarLabels":{"description":"Fields printed on the reservation bar, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarFastViewTurnOn":{"description":"Show the quick-view popover when hovering a reservation.","type":"boolean"},"calendarFastView":{"description":"Fields shown in the quick-view popover, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","payment","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarDragAndDrop":{"description":"Allow moving/resizing reservations by drag and drop.","type":"boolean"},"calendarDisplaySource":{"description":"Show the reservation source icon on the bar.","type":"boolean"},"calendarDisplayCheckInOut":{"description":"Show check-in / check-out markers on the bar.","type":"boolean"},"calendarColorsTurnOn":{"description":"Colour reservation bars by payment status (using the `calendarColors*` colours).","type":"boolean"},"calendarColorsNoPayment":{"description":"Bar colour: no payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPrepayment":{"description":"Bar colour: waiting for prepayment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidPrepayment":{"description":"Bar colour: prepayment paid.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidAll":{"description":"Bar colour: paid in full.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPayment":{"description":"Bar colour: waiting for payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationFormView":{"description":"Reservation form layout: `TAB` = split into tabs, `NORMAL` = single page.","type":"string","enum":["NORMAL","TAB"]},"reservationField":{"description":"Optional sections visible in the reservation form.","type":"array","items":{"type":"string","enum":["hours","adults","children","registration","moreClientData","source","meals","additionalServices","doorCode","discount"]}},"reservationConfirmation":{"description":"Fields printed on the reservation confirmation (PDF/e-mail).","type":"array","items":{"type":"string","enum":["roomName","additionalInformations","addDate","companyName","taxId","bankAccountNo","objectName","street","city","postalCode","country","objectPhone","objectEmail","website","checkIn","checkOut","reservationNo","arrival","departure","daysStay","adults","children","forename","name","phone","email","payment","toPay","room","meals","additionalServices","localTax","source","idCard","guestSignature","hotelSignature"]}},"reservationAutomaticPrepaymentAmountTurnOn":{"description":"Pre-fill the prepayment amount of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentAmountType":{"description":"How `reservationAutomaticPrepaymentAmountPrice` is interpreted: false = percent of the total, true = fixed amount in the account currency.","type":"boolean"},"reservationAutomaticPrepaymentAmountPrice":{"description":"Default prepayment: percent (0–100) or amount, depending on `reservationAutomaticPrepaymentAmountType`.","type":"number","format":"float","minimum":0,"nullable":true},"reservationAutomaticPrepaymentDaysTurnOn":{"description":"Pre-fill the prepayment due date of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentDays":{"description":"Default number of days the guest has to pay the prepayment.","type":"integer","maximum":365,"minimum":0,"nullable":true},"reservationCheckInCheckOutHoursTurnOn":{"description":"Let the reservation form override the property check-in/check-out hours.","type":"boolean"},"reservationDefaultInfo":{"description":"Text pre-filled in the \"additional information\" field of new reservations.","type":"string","maxLength":65535,"nullable":true},"reservationLockAsReservationTurnOn":{"description":"Treat date locks (blockades) like reservations in statistics and sync.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinTurnOn":{"description":"Recolour the reservation bar automatically on check-in.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinColor":{"description":"Colour applied on check-in.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationAutomaticColorChangeOnCheckoutTurnOn":{"description":"Recolour the reservation bar automatically on check-out.","type":"boolean"},"reservationAutomaticColorChangeOnCheckoutColor":{"description":"Colour applied on check-out.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"roomDirtyRoomCheckOutTurnOn":{"description":"Mark the room as dirty automatically on check-out.","type":"boolean"},"invoicesDefaultRate":{"description":"Default VAT rate for new invoice items, e.g. `23`, `8`, `zw`. Owner only — employees cannot change it (422).","type":"string","maxLength":5},"invoicesFormDataDefaultSource":{"description":"Seller data on invoices: false = account data (/account), true = the `invoices*` fields below. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesCompanyName":{"description":"Seller name printed on invoices (when `invoicesFormDataDefaultSource` is true). Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAddress":{"description":"Seller address printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesTaxId":{"description":"Seller tax ID printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesBankAccountNumber":{"description":"Seller bank account printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesIssuePlace":{"description":"Place of issue printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAdditionalInformations":{"description":"Footer / additional text printed on every invoice. Owner only — employees cannot change it (422).","type":"string","maxLength":65535,"nullable":true},"invoicesAutoDocsFill":{"description":"Pre-fill invoice items from the reservation. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesKsefJstTurnOn":{"description":"KSeF: enables the JST checkbox (invoice for a local-government subordinate unit, Podmiot2/JST=1) and the KSeF role selectors (Podmiot3/Rola) on the invoice form. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesNumberingType":{"description":"Invoice numbering: 0 = monthly (`invoicesFormat` must be a monthly pattern), 1 = yearly. Cannot be changed once an invoice has been issued in the current year (422). Owner only — employees cannot change it (422).","type":"integer","enum":[0,1]},"invoicesFormat":{"description":"Invoice number pattern; must match `invoicesNumberingType` (monthly patterns contain `MM`). Owner only — employees cannot change it (422).","type":"string","enum":["NUMBER/MM/YYYY","YYYY/MM/NUMBER","NUMBER-MM-YYYY","YYYY-MM-NUMBER","NUMBER/YYYY","YYYY/NUMBER","NUMBER-YYYY","YYYY-NUMBER"]},"syncBookingStatusDefaultStatus":{"description":"Payment status assigned to reservations imported from OTAs: 0 = no payment, 1 = prepayment paid, 2 = paid in full.","type":"integer","enum":[0,1,2]},"syncBookingColorDefaultColor":{"description":"Bar colour for reservations imported from OTAs other than Airbnb; null = default colour.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncAirbnbColorDefaultColor":{"description":"Bar colour for reservations imported from Airbnb; null = default colour. Owner only — employees cannot change it (422).","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncBookingPaymentDefaultPayment":{"description":"Payment method assigned to imported reservations: 0 = none, 1 = cash, 2 = bank transfer, 3 = card, 4 = virtual card.","type":"integer","enum":[0,1,2,3,4]},"syncChannelManagerNotificationEmail":{"description":"E-mail notification about channel manager events.","type":"boolean"},"syncChannelManagerNotificationPush":{"description":"Push notification about channel manager events.","type":"boolean"},"syncIcalendarImport":{"description":"Import reservations from connected iCal feeds.","type":"boolean"},"notificationsShowNewChanges":{"description":"Show the \"new changes\" indicator in the panel.","type":"boolean"},"notificationsPushArrivalsDepartures":{"description":"Daily push with today's arrivals and departures.","type":"boolean"},"notificationsPushArrivalsDeparturesTime":{"description":"Time of the arrivals/departures push (`HH:MM`, account time zone).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notificationsPushPrepayments":{"description":"Daily push about overdue prepayments.","type":"boolean"},"notificationsPushPrepaymentsTime":{"description":"Time of the prepayments push (`HH:MM`).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notifySound":{"description":"Notification sound in the panel; null = silent.","type":"string","enum":["DEFINITE"],"nullable":true},"pricingRestrictions":{"description":"Restriction rows visible in the pricing grid.","type":"array","items":{"type":"string","enum":["price1","minStay","maxStay","availArrival","availDeparture","minimumStayArrival","maximumStayArrival","exactStayArrival","closed","minAdvanceRes","maxAdvanceRes"]}}},"type":"object"},"SettingsResponse":{"description":"Settings with metadata","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/SettingsEntry"},"meta":{"type":"object","allOf":[{"$ref":"#/components/schemas/MetaWithRuid"},{"properties":{"editDate":{"description":"Last modification time (UTC, ISO 8601); null when the account still uses defaults.","type":"string","format":"date-time","nullable":true}},"type":"object"}]}},"type":"object"},"SettingsEntry":{"description":"All account settings (panel → Settings). Booleans are real booleans; colours are HEX; times are HH:MM in the account time zone. Fields marked 'Owner only' are read from the account owner for employees and cannot be changed by them.","required":["generalHomepage","generalThemeMode","generalDateFormat","generalTimeFormat","generalFirstDayOfWeek","generalMeasurementSystem","timeZone","calendarCalendarDate","calendarShape","calendarLabels","calendarFastViewTurnOn","calendarFastView","calendarDragAndDrop","calendarDisplaySource","calendarDisplayCheckInOut","calendarColorsTurnOn","calendarColorsNoPayment","calendarColorsWaitingForPrepayment","calendarColorsPaidPrepayment","calendarColorsPaidAll","calendarColorsWaitingForPayment","reservationFormView","reservationField","reservationConfirmation","reservationAutomaticPrepaymentAmountTurnOn","reservationAutomaticPrepaymentAmountType","reservationAutomaticPrepaymentAmountPrice","reservationAutomaticPrepaymentDaysTurnOn","reservationAutomaticPrepaymentDays","reservationCheckInCheckOutHoursTurnOn","reservationDefaultInfo","reservationLockAsReservationTurnOn","reservationAutomaticColorChangeOnCheckinTurnOn","reservationAutomaticColorChangeOnCheckinColor","reservationAutomaticColorChangeOnCheckoutTurnOn","reservationAutomaticColorChangeOnCheckoutColor","roomDirtyRoomCheckOutTurnOn","invoicesDefaultRate","invoicesFormDataDefaultSource","invoicesCompanyName","invoicesAddress","invoicesTaxId","invoicesBankAccountNumber","invoicesIssuePlace","invoicesAdditionalInformations","invoicesAutoDocsFill","invoicesKsefJstTurnOn","invoicesNumberingType","invoicesFormat","syncBookingStatusDefaultStatus","syncBookingColorDefaultColor","syncAirbnbColorDefaultColor","syncBookingPaymentDefaultPayment","syncChannelManagerNotificationEmail","syncChannelManagerNotificationPush","syncIcalendarImport","notificationsShowNewChanges","notificationsPushArrivalsDepartures","notificationsPushArrivalsDeparturesTime","notificationsPushPrepayments","notificationsPushPrepaymentsTime","notifySound","pricingRestrictions"],"properties":{"generalHomepage":{"description":"Panel start page.","type":"string","enum":["calendar","dashboard"]},"generalThemeMode":{"description":"Panel theme: 0 = light, 1 = dark, 2 = follow system.","type":"integer","enum":[0,1,2]},"generalDateFormat":{"description":"Date format used in the panel and in messages/confirmations.","type":"string","enum":["YYYY-MM-DD","DD-MM-YYYY","YYYY/MM/DD","DD/MM/YYYY","YYYY.MM.DD","DD.MM.YYYY","DD MMM YYYY","ddd DD MMM"]},"generalTimeFormat":{"description":"Time format: 24h (`HH:mm`) or 12h (`hh:mm A`).","type":"string","enum":["HH:mm","hh:mm A"]},"generalFirstDayOfWeek":{"description":"First day of the week in calendars.","type":"string","enum":["MON","SUN"]},"generalMeasurementSystem":{"description":"Measurement system (room size etc.).","type":"string","enum":["METRIC","IMPERIAL"]},"timeZone":{"description":"Account time zone (canonical IANA identifier, e.g. `Europe/Warsaw`) — used by automatic messages, door locks and the booking engine.","type":"string","enum":["Africa/Cairo","Africa/Johannesburg","Africa/Lagos","America/Anchorage","America/Argentina/Buenos_Aires","America/Chicago","America/Denver","America/Los_Angeles","America/Mexico_City","America/New_York","America/Santiago","America/Sao_Paulo","Asia/Bangkok","Asia/Dubai","Asia/Hong_Kong","Asia/Jakarta","Asia/Jerusalem","Asia/Karachi","Asia/Kolkata","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Tokyo","Australia/Adelaide","Australia/Brisbane","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Copenhagen","Europe/Dublin","Europe/Helsinki","Europe/Istanbul","Europe/Kyiv","Europe/Lisbon","Europe/London","Europe/Madrid","Europe/Oslo","Europe/Paris","Europe/Prague","Europe/Rome","Europe/Stockholm","Europe/Vienna","Europe/Warsaw","Pacific/Auckland","Pacific/Fiji","Pacific/Honolulu","Pacific/Port_Moresby"]},"calendarCalendarDate":{"description":"Show the date picker on the calendar toolbar.","type":"boolean"},"calendarShape":{"description":"Rounded (true) or square (false) reservation bars.","type":"boolean"},"calendarLabels":{"description":"Fields printed on the reservation bar, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarFastViewTurnOn":{"description":"Show the quick-view popover when hovering a reservation.","type":"boolean"},"calendarFastView":{"description":"Fields shown in the quick-view popover, in order.","type":"array","items":{"type":"string","enum":["reservationNo","forename","name","phone","email","arrival","departure","daysStay","adults","children","payment","additionalInfo","source","sentMessages","addDate","editDate","employee"]}},"calendarDragAndDrop":{"description":"Allow moving/resizing reservations by drag and drop.","type":"boolean"},"calendarDisplaySource":{"description":"Show the reservation source icon on the bar.","type":"boolean"},"calendarDisplayCheckInOut":{"description":"Show check-in / check-out markers on the bar.","type":"boolean"},"calendarColorsTurnOn":{"description":"Colour reservation bars by payment status (using the `calendarColors*` colours).","type":"boolean"},"calendarColorsNoPayment":{"description":"Bar colour: no payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPrepayment":{"description":"Bar colour: waiting for prepayment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidPrepayment":{"description":"Bar colour: prepayment paid.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsPaidAll":{"description":"Bar colour: paid in full.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"calendarColorsWaitingForPayment":{"description":"Bar colour: waiting for payment.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationFormView":{"description":"Reservation form layout: `TAB` = split into tabs, `NORMAL` = single page.","type":"string","enum":["NORMAL","TAB"]},"reservationField":{"description":"Optional sections visible in the reservation form.","type":"array","items":{"type":"string","enum":["hours","adults","children","registration","moreClientData","source","meals","additionalServices","doorCode","discount"]}},"reservationConfirmation":{"description":"Fields printed on the reservation confirmation (PDF/e-mail).","type":"array","items":{"type":"string","enum":["roomName","additionalInformations","addDate","companyName","taxId","bankAccountNo","objectName","street","city","postalCode","country","objectPhone","objectEmail","website","checkIn","checkOut","reservationNo","arrival","departure","daysStay","adults","children","forename","name","phone","email","payment","toPay","room","meals","additionalServices","localTax","source","idCard","guestSignature","hotelSignature"]}},"reservationAutomaticPrepaymentAmountTurnOn":{"description":"Pre-fill the prepayment amount of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentAmountType":{"description":"How `reservationAutomaticPrepaymentAmountPrice` is interpreted: false = percent of the total, true = fixed amount in the account currency.","type":"boolean"},"reservationAutomaticPrepaymentAmountPrice":{"description":"Default prepayment: percent (0–100) or amount, depending on `reservationAutomaticPrepaymentAmountType`.","type":"number","format":"float","minimum":0,"nullable":true},"reservationAutomaticPrepaymentDaysTurnOn":{"description":"Pre-fill the prepayment due date of new reservations.","type":"boolean"},"reservationAutomaticPrepaymentDays":{"description":"Default number of days the guest has to pay the prepayment.","type":"integer","maximum":365,"minimum":0,"nullable":true},"reservationCheckInCheckOutHoursTurnOn":{"description":"Let the reservation form override the property check-in/check-out hours.","type":"boolean"},"reservationDefaultInfo":{"description":"Text pre-filled in the \"additional information\" field of new reservations.","type":"string","maxLength":65535,"nullable":true},"reservationLockAsReservationTurnOn":{"description":"Treat date locks (blockades) like reservations in statistics and sync.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinTurnOn":{"description":"Recolour the reservation bar automatically on check-in.","type":"boolean"},"reservationAutomaticColorChangeOnCheckinColor":{"description":"Colour applied on check-in.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"reservationAutomaticColorChangeOnCheckoutTurnOn":{"description":"Recolour the reservation bar automatically on check-out.","type":"boolean"},"reservationAutomaticColorChangeOnCheckoutColor":{"description":"Colour applied on check-out.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"roomDirtyRoomCheckOutTurnOn":{"description":"Mark the room as dirty automatically on check-out.","type":"boolean"},"invoicesDefaultRate":{"description":"Default VAT rate for new invoice items, e.g. `23`, `8`, `zw`. Owner only — employees cannot change it (422).","type":"string","maxLength":5},"invoicesFormDataDefaultSource":{"description":"Seller data on invoices: false = account data (/account), true = the `invoices*` fields below. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesCompanyName":{"description":"Seller name printed on invoices (when `invoicesFormDataDefaultSource` is true). Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAddress":{"description":"Seller address printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesTaxId":{"description":"Seller tax ID printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesBankAccountNumber":{"description":"Seller bank account printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":50},"invoicesIssuePlace":{"description":"Place of issue printed on invoices. Owner only — employees cannot change it (422).","type":"string","maxLength":150},"invoicesAdditionalInformations":{"description":"Footer / additional text printed on every invoice. Owner only — employees cannot change it (422).","type":"string","maxLength":65535,"nullable":true},"invoicesAutoDocsFill":{"description":"Pre-fill invoice items from the reservation. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesKsefJstTurnOn":{"description":"KSeF: enables the JST checkbox (invoice for a local-government subordinate unit, Podmiot2/JST=1) and the KSeF role selectors (Podmiot3/Rola) on the invoice form. Owner only — employees cannot change it (422).","type":"boolean"},"invoicesNumberingType":{"description":"Invoice numbering: 0 = monthly (`invoicesFormat` must be a monthly pattern), 1 = yearly. Cannot be changed once an invoice has been issued in the current year (422). Owner only — employees cannot change it (422).","type":"integer","enum":[0,1]},"invoicesFormat":{"description":"Invoice number pattern; must match `invoicesNumberingType` (monthly patterns contain `MM`). Owner only — employees cannot change it (422).","type":"string","enum":["NUMBER/MM/YYYY","YYYY/MM/NUMBER","NUMBER-MM-YYYY","YYYY-MM-NUMBER","NUMBER/YYYY","YYYY/NUMBER","NUMBER-YYYY","YYYY-NUMBER"]},"syncBookingStatusDefaultStatus":{"description":"Payment status assigned to reservations imported from OTAs: 0 = no payment, 1 = prepayment paid, 2 = paid in full.","type":"integer","enum":[0,1,2]},"syncBookingColorDefaultColor":{"description":"Bar colour for reservations imported from OTAs other than Airbnb; null = default colour.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncAirbnbColorDefaultColor":{"description":"Bar colour for reservations imported from Airbnb; null = default colour. Owner only — employees cannot change it (422).","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6})$","nullable":true},"syncBookingPaymentDefaultPayment":{"description":"Payment method assigned to imported reservations: 0 = none, 1 = cash, 2 = bank transfer, 3 = card, 4 = virtual card.","type":"integer","enum":[0,1,2,3,4]},"syncChannelManagerNotificationEmail":{"description":"E-mail notification about channel manager events.","type":"boolean"},"syncChannelManagerNotificationPush":{"description":"Push notification about channel manager events.","type":"boolean"},"syncIcalendarImport":{"description":"Import reservations from connected iCal feeds.","type":"boolean"},"notificationsShowNewChanges":{"description":"Show the \"new changes\" indicator in the panel.","type":"boolean"},"notificationsPushArrivalsDepartures":{"description":"Daily push with today's arrivals and departures.","type":"boolean"},"notificationsPushArrivalsDeparturesTime":{"description":"Time of the arrivals/departures push (`HH:MM`, account time zone).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notificationsPushPrepayments":{"description":"Daily push about overdue prepayments.","type":"boolean"},"notificationsPushPrepaymentsTime":{"description":"Time of the prepayments push (`HH:MM`).","type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"notifySound":{"description":"Notification sound in the panel; null = silent.","type":"string","enum":["DEFINITE"],"nullable":true},"pricingRestrictions":{"description":"Restriction rows visible in the pricing grid.","type":"array","items":{"type":"string","enum":["price1","minStay","maxStay","availArrival","availDeparture","minimumStayArrival","maximumStayArrival","exactStayArrival","closed","minAdvanceRes","maxAdvanceRes"]}}},"type":"object"},"MetaWithRuid":{"description":"Metadata with request tracking.","required":["ruid"],"properties":{"ruid":{"description":"Request Unique ID","type":"string","format":"uuid"}},"type":"object"},"ApiProblem400":{"description":"Request syntax/format error.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"400 Bad Request","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]},"ApiProblemBase":{"description":"RFC 7807 Problem Details (base schema).","required":["type","title","status","detail","instance"],"properties":{"type":{"description":"RFC 7807 base — DO NOT use directly in endpoints.\nIn endpoints reference ApiProblem400/401/403/409/422/429/500.","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"},"ApiProblem401":{"description":"Missing authentication or invalid credentials.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"401 Unauthorized","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]},"ApiProblem403":{"description":"Authenticated user but no access.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"403 Forbidden","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]},"ApiProblem422":{"description":"Input data validation error.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"422 Unprocessable Entity (validation)","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"description":"Map: field name → error message(s)","type":"object","additionalProperties":{"$ref":"#/components/schemas/ErrorValue"}}},"type":"object"}]},"ErrorValue":{"description":"Single error message or list of messages.","oneOf":[{"description":"Error value in error map can be:\n- single string, or\n- array of strings (multiple messages for one field).","type":"string"},{"type":"array","items":{"type":"string"}}]}}},"paths":{"/settings":{"patch":{"tags":["settings"],"summary":"Update account settings (partial)","description":"Changes only the settings present in the body (see SettingsUpdateRequest); all other settings keep their values. Unknown setting names are rejected. Employees cannot change owner-only (invoice) settings. Required scope: `settings.update`.","operationId":"updateSettings","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsUpdateRequest"}}}},"responses":{"200":{"description":"Updated settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"400":{"description":"Bad request (malformed JSON, body is not an object, suspicious content)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem401"}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem403"}}}},"422":{"description":"Validation error — e.g. unknown setting, wrong type/enum value, `invoicesFormat` not matching `invoicesNumberingType`, numbering type change after an invoice was issued this year, owner-only setting sent by an employee","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem422"}}}}}}}}}
```