---
title: "Create Zone"
method: POST
path: "/api/v1/zones"
tags: ["Zone"]
---

# Create Zone

`POST /api/v1/zones`

creates a new zone on dns server

## Request body

- object
  - `name` string, required

## Response `201`

Successful operation

- CreateZone
  - `status` string
  - `data` Zone
    - `id` string
    - `name` string — The name of the zone, “liara.ir”, max length: 253, pattern: ^([a-zA-Z0-9][\-a-zA-Z0-9]*\.)+[\-a-zA-Z0-9]{2,20}$
    - `status` string — The status of the zone, valid values: [CREATING, PENDING, ACTIVE, DELETING]
    - `currentNameServers` string[]
    - `nameServers` string[]
    - `lastCheckAt` string — Last time when zones nameservers was checked
    - `createdAt` string — Time when zone was created

## Other responses

- `400` — Bad Request
- `401` — Missing authentication
- `409` — Conflict
- `500` — server does not response

---

[API](https://skmtc.net/liara-cloud/apis/dns.md) · [All operations](https://skmtc.net/liara-cloud/apis/dns/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liara-cloud/dns/versions/85a963889e53/schema)