---
title: "Create App"
method: POST
path: "/v1/apps"
tags: ["Apps"]
---

# Create App

`POST /v1/apps`

Create an app with the specified details in the request body.

## Request body

- CreateAppRequest
  - `enable_subdomains` boolean
  - `name` string
  - `network` string
  - `org_slug` string

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `422` — Rejected by validation. status is name_taken when the app name is already in use.

## Changes

- **2026-08-20** `9e6a180c40a3` — 1 warning, 1 info
  - added the new `name_taken` enum value to the `status` response property for the response status `400`
  - added the non-success response with the status `422`
- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/apps/post.md)

---

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