DNS Zones

Get All DNS Zones

Lists all configured DNS zones for an organization. Displays both primary and secondary zones, along with the number of records they contain.

URL: GET /api/v1/organizations/{organizationId}/dns-zones

Example Response (200 OK):

[
  {
    "dnsZoneId": "11ed0603-0bf3-4e1e-888a-f4bed05f4c77",
    "name": "meine-firma.de",
    "dnsZoneType": "primary",
    "recordCount": 12,
    "soaSerialNumber": "2026012801"
  }
]

Add Primary DNS Zone

Creates a new primary zone. In this mode, you have full control over all records.

URL: POST /api/v1/organizations/{organizationId}/dns-zones/primary

Request Body:

{
  "name": "neue-zone.cloud",
  "soaMName": "ns1.domains.stackit.cloud",
  "soaRName": "admin.neue-zone.cloud.",
  "soaRefreshInterval": 86400,
  "soaRetryInterval": 7200,
  "soaExpire": 3600000,
  "soaMinTtl": 180
}

Add Secondary DNS Zone

Creates a secondary zone. STACKIT acts as a secondary here and mirrors the data from your own primary nameserver.

URL: POST /api/v1/organizations/{organizationId}/dns-zones/secondary

Request Body:

{
  "name": "slave-zone.de",
  "primaryNameServerIpAddress": "1.2.3.4"
}

Update DNS Zone

Updates the SOA (Start of Authority) settings or the IP of the primary nameserver.

URL: PATCH /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}

Request Body (SOA Update):

{
  "soaRName": "hostmaster.stackit.cloud.",
  "soaMName": "ns1.domains.stackit.cloud.",
  "soaRefreshInterval": 86400,
  "soaRetryInterval": 7200,
  "soaExpire": 3600000,
  "soaMinTtl": 180,
  "primaryNameserverIpAddress": "194.175.123.125"
}

Delete DNS Zone

Irrevocably removes a zone from the system. Note: This command also deletes all contained Resource Records, Web Forwards, and Mail Forwards.

URL: DELETE /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}

Response (Deleted successfully):

204 No Content