---
title: "Changes to POST /api/custom-apps"
method: POST
path: "/api/custom-apps"
---

# Changes to POST /api/custom-apps

`POST /api/custom-apps`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 50 revisions.

- **2026-01-15** `0aba722212fc` — 2 info
- **2026-01-15** `77748aef5e7c` — 1 breaking, 3 info
- **2026-01-06** `5335be4f6af0` — 2 breaking, 2 warning, 1 info
- **2025-10-18** `b488b0059333` — 6 info
- **2025-10-07** `1c014dbe59c0` — 2 info
- **2025-10-05** `d7a1538e689e` — 34 breaking, 1 info
- **2025-09-30** `0fcd4e7364eb` — 1 breaking
- **2025-09-30** `8757aefd507d` — 1 info
- **2025-05-09** `0db10235cd0a` — 1 breaking

## 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`
  - added the new optional request property `config/networks`
- **2025-10-18** `b488b0059333` — 6 info
  - request property `config/overrides/items/services/items/addPorts/items/containerPort` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/overrides/items/services/items/addPorts/items/hostPort` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/overrides/items/services/items/internalPort` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/services/items/addPorts/items/containerPort` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/services/items/addPorts/items/hostPort` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `config/services/items/internalPort` list-of-types was widened by adding types `string` to media type `application/json`
- **2025-10-07** `1c014dbe59c0` — 2 info
  - added the new optional request property `config/overrides/items/services/items/volumes/items/bind`
  - added the new optional request property `config/services/items/volumes/items/bind`
- **2025-10-05** `d7a1538e689e` — 34 breaking, 1 info
  - removed `subschema #1` from the `config/overrides/items/services/items/addPorts/items/interface` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/hostname` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/networkMode` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/pid` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/shmSize` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/user` request property `anyOf` list
  - removed `subschema #1` from the `config/overrides/items/services/items/workingDir` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/addPorts/items/interface` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/hostname` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/networkMode` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/pid` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/shmSize` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/user` request property `anyOf` list
  - removed `subschema #1` from the `config/services/items/workingDir` request property `anyOf` list
  - the `config/overrides/items/services/items/addPorts/items/containerPort` request property type changed from `number` to `integer`
  - the `config/overrides/items/services/items/addPorts/items/hostPort` request property type changed from `number` to `integer`
  - the `config/overrides/items/services/items/addPorts/items/interface` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/hostname` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/internalPort` request property type changed from `number` to `integer`
  - the `config/overrides/items/services/items/networkMode` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/pid` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/shmSize` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/user` request property type changed from no type to `string`
  - the `config/overrides/items/services/items/workingDir` request property type changed from no type to `string`
  - the `config/services/items/addPorts/items/containerPort` request property type changed from `number` to `integer`
  - the `config/services/items/addPorts/items/hostPort` request property type changed from `number` to `integer`
  - the `config/services/items/addPorts/items/interface` request property type changed from no type to `string`
  - the `config/services/items/hostname` request property type changed from no type to `string`
  - the `config/services/items/internalPort` request property type changed from `number` to `integer`
  - the `config/services/items/networkMode` request property type changed from no type to `string`
  - the `config/services/items/pid` request property type changed from no type to `string`
  - the `config/services/items/shmSize` request property type changed from no type to `string`
  - the `config/services/items/user` request property type changed from no type to `string`
  - the `config/services/items/workingDir` request property type changed from no type to `string`
  - the request property `config/services/items/internalPort` became optional
- **2025-09-30** `0fcd4e7364eb` — 1 breaking
  - added the new required request property `config/schemaVersion`
- **2025-09-30** `8757aefd507d` — 1 info
  - endpoint added
- **2025-05-09** `0db10235cd0a` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/runtipi/apis/runtipi-api/docs/api/custom-apps/post.md) · [API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [Page](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/custom-apps/post)