---
title: "PATCH /api/app-lifecycle/{urn}/update-config"
method: PATCH
path: "/api/app-lifecycle/{urn}/update-config"
tags: ["AppLifecycle"]
---

# PATCH /api/app-lifecycle/{urn}/update-config

`PATCH /api/app-lifecycle/{urn}/update-config`

## Path parameters

- `urn` string, required

## Request body

- AppFormBody
  - `domain` string
  - `enableAuth` boolean
  - `exposed` boolean
  - `exposedLocal` boolean
  - `forcePull` boolean
  - `isVisibleOnGuestDashboard` boolean
  - `localSubdomain` string
  - `maxBackups` number
  - `openPort` boolean
  - `port` number
  - `skipEnv` boolean
  - `skipPull` boolean
  - `skipRun` boolean

## Response `default`

- LifecycleRequestDto
  - `requestId` union, required — a UUID
    - string, uuid — a UUID
    - '00000000-0000-0000-0000-000000000000', uuid — a UUID
    - 'ffffffff-ffff-ffff-ffff-ffffffffffff', uuid — a UUID

## Changes

- **2026-03-06** `87821b08d809` — 1 info
  - api operation id `updateAppConfig` removed and replaced with `updateAppSettings`
- **2026-01-15** `77748aef5e7c` — 1 info
  - added the new optional request property `forcePull`
- **2025-11-02** `cfec28cc6df5` — 4 info
  - the `openPort` request property default value `true` was removed
  - the `skipEnv` request property default value `false` was removed
  - the `skipPull` request property default value `false` was removed
  - the `skipRun` request property default value `false` was removed
- **2025-10-14** `7b4084eaeb8d` — 1 info
  - added the new optional request property `maxBackups`
- **2025-09-19** `04aac8a043a6` — 1 breaking
  - removed the success response with the status `200`

[Full history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/app-lifecycle/:urn/update-config/patch.md)

---

[API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [All operations](https://skmtc.dev/runtipi/apis/runtipi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtipi/runtipi-api/revisions/5c7deb969194/schema)