Create (or revive) a subdomain (ns_delegation parent only)

Requires EDITOR. Returns status=draft; no external call (auto-supply is cron-driven).

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Project (tenant) identifier. Row-level tenant isolation is enforced on every query.

id

required

string

Custom domain identifier.

Request Body^required

Media typeapplication/json

object

label

required

string

>= 1 characters <= 63 characters

Example^generated

json

{
  "label": "example"
}

Responses

201

Created subdomain.

Media typeapplication/json

object

subdomain

object

id

string

domainId

string

projectId

string

label

string

fqdn

string

status

string

cloudflareJson

route53Json

createdAt

string

updatedAt

string

key

additional properties

any

400

Parent not ns_delegation, or invalid label.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Not authenticated (401 via requireAuthenticated) or insufficient project role (403).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

404

Resource not found (or cross-tenant — same 404).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

409

Subdomain already occupied/exists.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}