DNS Settings for a Zone

Copy Markdown View Source

Update DNS Settings

PATCH /zones/{zone_id}/dns_settings

Update DNS settings for a zone

Responses

200 Show DNS Settings response

Data is at body["result"]

{
  "flatten_all_cnames": "*boolean*",
  "foundation_dns": "*boolean*",
  "internal_dns": {
    "reference_zone_id": "*string*"
  },
  "multi_provider": "*boolean*",
  "nameservers": {
    "ns_set": "*integer*",
    "type": "*string*"
  },
  "ns_ttl": "*number*",
  "secondary_overrides": "*boolean*",
  "soa": {
    "expire": "*number*",
    "min_ttl": "*number*",
    "mname": "*string*",
    "refresh": "*number*",
    "retry": "*number*",
    "rname": "*string*",
    "ttl": "*number*"
  },
  "zone_mode": "*string*"
}

4XX Show DNS Settings response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Show DNS Settings

GET /zones/{zone_id}/dns_settings

Show DNS settings for a zone

Responses

200 Show DNS Settings response

Data is at body["result"]

{
  "flatten_all_cnames": "*boolean*",
  "foundation_dns": "*boolean*",
  "internal_dns": {
    "reference_zone_id": "*string*"
  },
  "multi_provider": "*boolean*",
  "nameservers": {
    "ns_set": "*integer*",
    "type": "*string*"
  },
  "ns_ttl": "*number*",
  "secondary_overrides": "*boolean*",
  "soa": {
    "expire": "*number*",
    "min_ttl": "*number*",
    "mname": "*string*",
    "refresh": "*number*",
    "retry": "*number*",
    "rname": "*string*",
    "ttl": "*number*"
  },
  "zone_mode": "*string*"
}

4XX Show DNS Settings response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}