v1

latestOpenAPI 3.1.02026-07-244861122.7 KB
zones

Set zone 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 for an in-depth explanation about metadata filters.

post/v1/dns/zones/{zone_name}/metadata

Path parameters

zone_namestring required

The name of the zone.

Example:example.com

The name of the zone.

Request body

metadataMetadata

A collection of string key/value pairs that provide additional information or classification for an object.

Example request

{
  "metadata": {
    "public property": "public value"
  }
}

Response

resource updated