---
title: "Create a domain"
method: POST
path: "/v1/domains"
tags: ["Domains"]
---

# Create a domain

`POST /v1/domains`

create a domain that user owns

## Request body

- object
  - `name` string, required
  - `project` string, required
  - `type` string, required

## Response `201`

Successful operation

- object
  - `domain` object
    - `_id` string

## Other responses

- `400` — Bad request
- `401` — Missing authentication
- `404` — App does not exists.
- `409` — Conflict

## Changes

- **2023-10-06** `cf08e00ba33f` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2023-09-28** `0473216ad4bf` — 1 info
  - api operation id `createAppDomain` was added
- **2023-09-25** `d253f41e4513` — 1 breaking
  - added required request body

[Change history](https://skmtc.dev/liara-cloud/apis/paas/changes/v1/domains/post.md)

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) · [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liara-cloud/paas/revisions/4413e6f56089/schema)