Publish zone

POST /v1/dns/zones/{zone_name}/publish

Request publication of the zone. When the zone gets published, it becomes resolvable on the primary nameservers.

Path Parameters

zone_name

The name of the zone.

Example: example.com

Response

202 401 402 403 404 409

---

Accepted

resource updated

{
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Unauthorized

unauthorized (code: 2465)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Payment Required

Multiple error variants are possible:

• DNS names are over limit; please contact support (code: 3354)
• RRset metadata over limit; please contact support (code: 4556)
• Rdata count is over limit; please contact support (code: 4428)
• dns name metadata over limit; please contact support (code: 2218)
• owned zones are over limit; please contact support (code: 4085)
• zone metadata over limit; please contact support (code: 4228)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Forbidden

Multiple error variants are possible:

• changing this zone is forbidden (code: 4238)
• changing this zone is prohibited; please contact support (code: 3903)
• operation only available via the website (code: 4786)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Not Found

zone not found (codes: 2510, 2728)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Conflict

Multiple error variants are possible:

• zone already published (code: 3805)
• zone publication already requested (code: 4738)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}