---
title: "POST /api/custom-apps"
method: POST
path: "/api/custom-apps"
tags: ["CustomApp"]
---

# POST /api/custom-apps

`POST /api/custom-apps`

## Request body

- CreateCustomAppDto
  - `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
  - `name` string, required

## Response `default`

- CreateCustomAppResponseDto
  - `appName` string, required
  - `appUrn` string, required
  - `storeId` string, required

## 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/post.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)