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

# Set zone metadata

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

Set metadata associated to a zone.
Zone metadata is stored until the zone gets deleted.
New keys are added, existing keys are updated. To remove a key, set its value to an empty string.

See [metadata filters](metadata-filter-expressions) for an in-depth explanation about metadata filters.

## Path parameters

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

## Request body

- SetMetadata — A metadata field.
  - `metadata` Metadata — A collection of string key/value pairs that provide additional information or classification for an object.

## 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)
- `402` — zone metadata over limit; please contact support (code: 4228)
- `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)

---

[API](https://skmtc.net/noip/apis/no-ip-api.md) · [All operations](https://skmtc.net/noip/apis/no-ip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/noip/no-ip-api/revisions/619d78b2a70e/schema)