APIs & SDKs/shadw REST API/Import DNS records

Import DNS records

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

Bulk-import records (DNS migration) from a list and/or a pasted BIND zone file. Idempotent — exact duplicates are skipped.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a JWT of at most 1 hour from POST /v1/token, which is server-only once HIVE_JWT_SECRET is set. An API key scopes the request to the team it was created under.

Path parameters

domainstringRequired

The domain name.

Body parameters

recordsDnsRecord[]Optional

Structured records to import.

zonestringOptional

Raw BIND-style zone text to parse and import.

ts

const response = await fetch('https://api.shadw.cloud/v1/domains/{domain}/import', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY', // hive_… (Settings → API Keys)
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "records": [],
    "zone": "zone"
  }),
});

const data = await response.json();
console.log(data);

Response

json

{ "imported": 3, "records": [ /* … */ ] }