---
title: "PATCH /api/custom-apps/{urn}"
method: PATCH
path: "/api/custom-apps/{urn}"
tags: ["CustomApp"]
---

# PATCH /api/custom-apps/{urn}

`PATCH /api/custom-apps/{urn}`

## Path parameters

- `urn` string, required

## Request body

- UpdateCustomAppDto
  - `config` object, required
    - `services` object, required
    - `x-runtipi` object, required
      - `schema_version` unknown, required
      - `overrides` object[]
        - `architecture` 'amd64' | 'arm64', required
        - `services` object, required
    - `networks` object

## Response `default`

## Changes

- **2026-01-15** `0aba722212fc` — 2 info
  - request property `config/services/additionalProperties/x-runtipi/internal_port` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/x-runtipi/overrides/items/services/additionalProperties/x-runtipi/internal_port` list-of-types was widened by adding types `string` to media type `application/json`
- **2026-01-15** `77748aef5e7c` — 1 breaking, 3 info
  - request property `config/x-runtipi/schema_version` was restricted to a list of enum values
  - the `schema_version` request property const value `1` was removed
  - added the new `1.00` enum value to the request property `config/x-runtipi/schema_version`
  - added the new `2.00` enum value to the request property `config/x-runtipi/schema_version`
- **2026-01-06** `5335be4f6af0` — 2 breaking, 2 warning, 1 info
  - added the new required request property `config/x-runtipi`
  - the `config/services` request property type changed from `array` to `object`
  - removed the request property `config/overrides`
  - removed the request property `config/schemaVersion`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/custom-apps/:urn/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)