Delete DNS records of a name

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

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); the value is written as in a zone file, a TXT as the text itself. Nothing to remove changes nothing (changed false). The NS records of the domain itself are manitu's and stay (apex_ns_not_allowed); any other record can be removed, also one that should not be there. Refused with a conflict when manitu does not hold the zone (zone_not_hosted_here), 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, the base of the next change. Made with a session of the customer panel, the call is carried out at once; otherwise the caller confirms it first: approval_required with the way call_again, then the same call again with its approval_token - unless the access is set to make such changes without asking. For a record of type MX, NS, SRV or CAA, at a wildcard, or at the host _acme-challenge, autodiscover or autoconfig (and below), it waits instead until a person signed in to the customer panel approves it (approval_required; its state: manitu_approval_getPOST /v1/approval/get).

DDestructiveIdempotentNeeds service_domain

Counts against: writes (60 per hour per account)

Tool
manitu_domain_dns_zone_record_deleteon https://mcp.manitu.de/mcp
POST
/v1/domain/dns/zone/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.
This request removes something.
readOnlyHint falsedestructiveHint trueidempotentHint trueopenWorldHint false

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 user 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 and stay (apex_ns_not_allowed); anything else can be removed, also a record that should not be there. Refused with a conflict when manitu does not hold the zone (zone_not_hosted_here), 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.

Reasons it may answer: resource_not_found, permission_missing, zone_not_hosted_here, zone_not_editable, zone_changed, zone_stored_not_readable, zone_not_loadable, cname_not_alone, wildcard_ns_not_allowed, value_invalid, apex_ns_not_allowed, cname_at_apex and 2 more.

name (required)string

The domain name, with international characters or in ASCII.

min length 1max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
host (required)string

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 253pattern ^[^\x00-\x1F\x7F]*$
type (required)string

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT
zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_getPOST /v1/domain/dns/zone/get or from the answer to the last change - refused with zone_changed if the zone changed since. A new zone_revision after your own change is expected, not a change by someone else.

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
approval_tokenstringwrite-only

The token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.

min length 1max length 255
The tool list tells the model a little more about some of these fields, at the end of their description. Programs over REST do not get these hints.
namestring

The domain, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
hoststring

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

pattern ^[^\x00-\x1F\x7F]*$
typestring
One of A AAAA CAA CNAME MX NS SRV TXT
changedboolean

false: it was so already - nothing was stored.

ttlinteger | null

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

value_listarray of string

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

zone_revisionstring

The revision of the zone now.

pattern ^[^\x00-\x1F\x7F]*$

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

name (required)string

The domain name, with international characters or in ASCII.

min length 1max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
host (required)string

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 253pattern ^[^\x00-\x1F\x7F]*$
type (required)string

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT
zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_getPOST /v1/domain/dns/zone/get or from the answer to the 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
approval_tokenstringwrite-only

The token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.

min length 1max length 255
namestring

The domain, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
hoststring

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

pattern ^[^\x00-\x1F\x7F]*$
typestring
One of A AAAA CAA CNAME MX NS SRV TXT
changedboolean

false: it was so already - nothing was stored.

ttlinteger | null

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

value_listarray of string

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

zone_revisionstring

The revision of the zone now.

pattern ^[^\x00-\x1F\x7F]*$
200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.404What the call names does not exist, or not for this caller (NOT_FOUND). Look it up again - do not guess another.409Not possible in the current state (PRECONDITION_FAILED). The reason says what stands in the way; the same call may succeed once it has changed.429Too many calls. The Retry-After header says when to try again.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.
resource_not_foundWhat the call names does not exist in the account, or not for this access.NOT_FOUNDpermission_missingThis access lacks a permission the call needs; the main access of the account can grant it.PERMISSION_DENIEDzone_not_hosted_hereThe zone of the domain is not a primary zone held here - its name servers are elsewhere.PRECONDITION_FAILEDzone_not_editableThe domain is not active, so its zone cannot be changed.PRECONDITION_FAILEDzone_changedThe zone changed since it was read: read it again and apply the change again.PRECONDITION_FAILEDzone_stored_not_readableThe zone as stored cannot be read; the provider has to repair it.PRECONDITION_FAILEDzone_not_loadableThe name server would not load the zone; the old zone stays.INVALID_INPUTcname_not_aloneA CNAME stands alone at its name - no other record beside it.INVALID_INPUTwildcard_ns_not_allowedNS records delegate one name, never a wildcard.INVALID_INPUTvalue_invalidThe value is not one of the type.INVALID_INPUTapex_ns_not_allowedThe NS records of the domain itself are the provider's - neither added nor removed.INVALID_INPUTcname_at_apexA CNAME cannot stand at the domain itself, beside its SOA and NS.INVALID_INPUThost_invalidThe host is no DNS name.INVALID_INPUTname_needs_final_dotA name written with the domain at its end needs a final dot - or none of the domain.INVALID_INPUT
Example