---
title: "Unpublish zone"
method: POST
path: "/v1/dns/zones/{zone_name}/unpublish"
tags: ["zones"]
---

# Unpublish zone

`POST /v1/dns/zones/{zone_name}/unpublish`

## Request

- Base URL: `https://api.noip.com`
- URL: `https://api.noip.com/v1/dns/zones/{zone_name}/unpublish`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Request reverting the publication of the zone.
When the zone becomes unpublished, it will not be resolvable on the primary nameservers.

## Path parameters

- `zone_name` string, required: The name of the zone.

## Response `202`

resource updated

- CommandSuccess
  - `warnings` Warning[]
    - `code` string, required: A code for this warning.
    - `title` string, required: A title for this warning.
    - `detail` string, nullable: Contextual information about this warning.

## Other responses

- `401`: unauthorized (code: 2465)
- `403`: 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)
- `404`: Multiple error variants are possible: - zone not found (code: 2510) - zone not shared (code: 2728)
- `409`: Multiple error variants are possible: - zone is already unpublished (code: 3810) - zone unpublication already requested (code: 4644)

---

[API](https://skmtc.dev/noip/apis/no-ip-api.md) - [All operations](https://skmtc.dev/noip/apis/no-ip-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noip/apis/no-ip-api/revisions/cf71cf05abd0?raw)