shadw/Docs
Dashboard
APIs & SDKs/shadw REST API/Create a DNS record

Create a DNS record

POSThttps://api.shadw.cloud/v1/domains/{domain}/records

Create a DNS record. shadw's authoritative DNS server answers queries for the domain from these records.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a short-lived JWT minted with POST /v1/token. An API key scopes the request to the team it was created under.

Path parameters

domainstringRequired

The domain name.

Body parameters

type"A" | "AAAA" | "CNAME" | "TXT" | "MX" | "NS"Required

Record type.

namestringRequired

Subdomain (e.g. "www") or "@" for the apex.

valuestringRequired

Record value (IP, hostname, text…).

ttlnumberOptional

Time-to-live in seconds (default 3600).

prioritynumberOptional

Priority (MX records).