Delete DNS records of a name

Remove one record, or all records of one name and type, from the DNS zone of a domain.

DDestructiveIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_record_deleteon https://mcp.manitu.de/mcp

POST

/v1/domain/dns/record/deleteon 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

Removes records from the DNS zone of a domain at manitu: the record of one name and type with the value given, or - without value - all records of that name and type. host is relative to the domain ("@" the domain itself); a value as in a zone file, a TXT the text itself. Nothing to remove changes nothing (changed false). Tell the customer what is removed and wait for an explicit yes - web site and e-mail of the domain depend on the zone; removing an A, MX or CNAME can take a site or mail off line. The NS records of the domain itself are manitu's. 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

hoststringrequired

The name of the record, relative to the domain: "@" for the domain itself, "www" for www.<domain>, "*.dev" for a wildcard - with international characters or in ASCII.

min length 1max length 253

typestringrequired

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT

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}$

valuestring

Only the record with this value. Left out: all records of this name and type.

min length 1max length 4096

Result structuredContent, checked against the schema

namestringrequired

The domain, with international characters.

hoststringrequired

The name of the record, relative to the domain, in ASCII; "@" for the domain itself.

typestringrequired

One of A AAAA CAA CNAME MX NS SRV TXT

changedbooleanrequired

false: it was so already - nothing was stored.

ttlinteger | nullrequired

The TTL of the records now, in seconds; null: the zone's default.

value_listarray of stringrequired

The values of this host and type now, as stored - empty when there are none left.

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

hoststringrequired

The name of the record, relative to the domain: "@" for the domain itself, "www" for www.<domain>, "*.dev" for a wildcard - with international characters or in ASCII.

min length 1max length 253

typestringrequired

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT

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}$

valuestring

Only the record with this value. Left out: all records of this name and type.

min length 1max length 4096

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

namestringrequired

The domain, with international characters.

hoststringrequired

The name of the record, relative to the domain, in ASCII; "@" for the domain itself.

typestringrequired

One of A AAAA CAA CNAME MX NS SRV TXT

changedbooleanrequired

false: it was so already - nothing was stored.

ttlinteger | nullrequired

The TTL of the records now, in seconds; null: the zone's default.

value_listarray of stringrequired

The values of this host and type now, as stored - empty when there are none left.

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_record_delete",
    "arguments": {
      "name": "example.com",
      "host": "string",
      "type": "A"
    }
  }
}

Result

{
  "structuredContent": {
    "name": "example.com",
    "host": "string",
    "type": "A",
    "changed": true,
    "ttl": 1,
    "value_list": [
      "string"
    ],
    "zone_revision": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/domain/dns/record/delete

Request

curl -X POST 'https://api.manitu.de/v1/domain/dns/record/delete' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "example.com",
    "host": "string",
    "type": "A"
  }'

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

<?php

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

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"name":"example.com","host":"string","type":"A"}',
    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/record/delete",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "name": "example.com",
        "host": "string",
        "type": "A",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "name": "example.com",
    "host": "string",
    "type": "A",
    "changed": true,
    "ttl": 1,
    "value_list": [
      "string"
    ],
    "zone_revision": "string"
  }
}

Delete DNS records of a name

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