---
title: "Changes to PATCH /api/user-settings"
method: PATCH
path: "/api/user-settings"
---

# Changes to PATCH /api/user-settings

`PATCH /api/user-settings`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2026-07-17** `5c7deb969194` — 1 info
- **2025-10-14** `7b4084eaeb8d` — 1 info
- **2025-09-20** `b18f9d8a574e` — 1 info
- **2025-09-19** `04aac8a043a6` — 3 breaking, 5 warning, 1 info
- **2025-09-07** `8894b9440760` — 6 breaking, 1 warning
- **2025-05-09** `0db10235cd0a` — 4 breaking, 4 warning, 6 info

## Changes

- **2026-07-17** `5c7deb969194` — 1 info
  - added the new optional request property `trustedProxyIps`
- **2025-10-14** `7b4084eaeb8d` — 1 info
  - added the new optional request property `maxBackups`
- **2025-09-20** `b18f9d8a574e` — 1 info
  - request property `postgresPort` list-of-types was widened by adding types `string` to media type `application/json`
- **2025-09-19** `04aac8a043a6` — 3 breaking, 5 warning, 1 info
  - request property `port` list-of-types was narrowed by removing types `number` from media type `application/json`
  - request property `sslPort` list-of-types was narrowed by removing types `number` from media type `application/json`
  - the `postgresPort` request property type changed from `number` to `integer`
  - the `postgresPort` request property's max was set to `65535.00`
  - the `postgresPort` request property's min was set to `0.00`
  - changed the pattern of the request property `dnsIp` from `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$`
  - changed the pattern of the request property `internalIp` from `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$`
  - changed the pattern of the request property `listenIp` from `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$`
  - request property `eventsTimeout` list-of-types was widened by adding types `string` to media type `application/json`
- **2025-09-07** `8894b9440760` — 6 breaking, 1 warning
  - added the pattern `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to the request property `dnsIp`
  - added the pattern `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to the request property `internalIp`
  - added the pattern `^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$` to the request property `listenIp`
  - the `dnsIp` request property format changed from no format to `ipv4`
  - the `internalIp` request property format changed from no format to `ipv4`
  - the `listenIp` request property format changed from no format to `ipv4`
  - the `eventsTimeout` request property's max was set to `9007199254740991.00`
- **2025-05-09** `0db10235cd0a` — 4 breaking, 4 warning, 6 info
  - request property `eventsTimeout` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `port` list-of-types was narrowed by removing types `integer and string` from media type `application/json`
  - request property `postgresPort` list-of-types was narrowed by removing types `integer and string` from media type `application/json`
  - request property `sslPort` list-of-types was narrowed by removing types `integer and string` from media type `application/json`
  - the `eventsTimeout` request property's exclusiveMinimum was set to `false`
  - the `eventsTimeout` request property's min was set to `1.00`
  - removed the request property `maxBackups`
  - removed the request property `trustedProxyIps`
  - removed the pattern `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$` from the request property `dnsIp`
  - removed the pattern `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$` from the request property `internalIp`
  - removed the pattern `^((?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])[.]){3}(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$` from the request property `listenIp`
  - the `dnsIp` request property format was generalized from `ipv4` to no format
  - the `internalIp` request property format was generalized from `ipv4` to no format
  - the `listenIp` request property format was generalized from `ipv4` to no format

---

[Operation](https://skmtc.dev/runtipi/apis/runtipi-api/docs/api/user-settings/patch.md) · [API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [Page](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/user-settings/patch)