DNS

Clone another domain's DNS onto this one

Copies the DNS setup of a source domain you own onto this domain - useful for multi-TLD brands (brand.com → brand.dev) that share the same A/CNAME/MX. Merges by default (source records win on any type+name collision, this domain's other records are kept); set replace: true for an exact mirror.

Mail routing: a change to where the domain's mail is delivered (its MX or NS records, the address records an MX host inside the zone resolves through, or those of a host that receives Domani mail and publishes no MX) needs the email:auth_secrets scope, since whoever receives the mail receives its sign-in codes. Without it the request answers 403 INSUFFICIENT_SCOPE before anything changes, and a token confined to mailboxes answers 403 MAILBOX_CONFINED even with it. Other records need only domains:write. Every routing change is recorded in the audit log.

post/api/domains/{domain}/dns/clone

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/domains/{domain}/dns/clone
  • Auth: HTTP bearer

Path parameters

domainstring required
Example:brand.dev

Target domain (DNS is written here)

Request body

fromstring required

Source domain to copy DNS from (must be yours)

replaceboolean

Exact mirror - drop target records the source doesn't have. Default: merge

Example request

{
  "from": "brand.com"
}

Response

DNS cloned

successboolean
from_domainstring
to_domainstring

Example response

{
  "records": [
    {
      "name": "@",
      "value": "76.76.21.21",
      "ttl": 3600
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.