Reset DNS zone of a domain

Put the DNS zone of a domain back to the records its web hosting package sets up.

DDestructiveIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_zone_reseton https://mcp.manitu.de/mcp

POST

/v1/domain/dns/zone/reseton https://api.manitu.de

Try it

Removes something for good. Agents name what will be lost and wait for an explicit yes; a program should ask the same.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint trueidempotentHint trueopenWorldHint false

Description for the model

Puts the DNS zone of a domain at manitu back to the records its web hosting package sets up for web site and e-mail - for a zone that was broken by hand. mode replace makes it a new zone: every other record (own servers, TXT for verifications, ...) is gone. mode merge puts manitu's records in and keeps the others. A custom MX and A/AAAA of the domain itself are kept where they can be. Read the zone first (manitu_domain_dns_zone_get), tell the customer what will be lost, and wait for an explicit yes. Only for a domain in a web hosting package (else conflict no_webhosting_package); refused with a conflict when manitu does not hold the zone (zone_not_primary_at_manitu), the domain is not active (zone_not_editable) or the zone changed since zone_revision (zone_changed). Every change counts the serial up and answers the new zone_revision - pass that one with the next change. A new serial after your own change is expected, not a change by someone else.

Arguments

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

modestringrequired

replace: the zone as a new one, every other record is gone. merge: manitu's records for web and mail put in, the other records kept.

One of replace merge

zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_get or from the answer of your last change - refused with zone_changed if the zone changed since.

pattern ^[0-9a-f]{64}$

Result structuredContent, checked against the schema

namestringrequired

The domain, with international characters.

modestringrequired

One of replace merge

zone_datastringrequired

The zone now, as BIND zone file text (raw).

zone_revisionstringrequired

The revision of the zone now.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

modestringrequired

replace: the zone as a new one, every other record is gone. merge: manitu's records for web and mail put in, the other records kept.

One of replace merge

zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_get or from the answer of your last change - refused with zone_changed if the zone changed since.

pattern ^[0-9a-f]{64}$

Response in `data`; the rest of the body as on every call

namestringrequired

The domain, with international characters.

modestringrequired

One of replace merge

zone_datastringrequired

The zone now, as BIND zone file text (raw).

zone_revisionstringrequired

The revision of the zone now.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_domain_dns_zone_reset",
    "arguments": {
      "name": "example.com",
      "mode": "replace"
    }
  }
}

Result

{
  "structuredContent": {
    "name": "example.com",
    "mode": "replace",
    "zone_data": "string",
    "zone_revision": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/domain/dns/zone/reset

Request

curl -X POST 'https://api.manitu.de/v1/domain/dns/zone/reset' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "example.com",
    "mode": "replace"
  }'

const response = await fetch('https://api.manitu.de/v1/domain/dns/zone/reset', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "example.com",
    "mode": "replace"
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/domain/dns/zone/reset');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"name":"example.com","mode":"replace"}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/domain/dns/zone/reset",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "name": "example.com",
        "mode": "replace",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "name": "example.com",
    "mode": "replace",
    "zone_data": "string",
    "zone_revision": "string"
  }
}

Reset DNS zone of a domain

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call