Set DNS records of a name

Set the records of one name and type in the DNS zone of a domain - replacing what is there.

WWriteIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_record_seton https://mcp.manitu.de/mcp

POST

/v1/domain/dns/record/seton https://api.manitu.de

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Sets the records of one name and type in the DNS zone of a domain at manitu - the values given replace all records of that name and type ("point home at 203.0.113.7", "the MX of the domain are ..."). host is relative to the domain ("@" the domain itself, "www", "*.dev"); a value as in a zone file, a TXT the text itself; a name in a value without a final dot is relative to the domain. The same call again changes nothing (changed false). To add one more value use manitu_domain_dns_record_add, to remove manitu_domain_dns_record_delete; for many changes at once manitu_domain_dns_zone_set. Tell the customer the name, type and values first and wait for an explicit yes - web site and e-mail of the domain depend on the zone. The NS records of the domain itself are manitu's, and a CNAME stands alone (cname_not_alone). 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}$

value_listarray of stringrequired

The values - all of them: what is not listed is removed. A CNAME has exactly one.

min items 1max items 50

ttlinteger

How long resolvers may keep it, in seconds. Left out: the zone's default.

min 60max 604800

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

value_listarray of stringrequired

The values - all of them: what is not listed is removed. A CNAME has exactly one.

min items 1max items 50

ttlinteger

How long resolvers may keep it, in seconds. Left out: the zone's default.

min 60max 604800

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

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/set

Request

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

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

<?php

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

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","value_list":["string"]}',
    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/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "name": "example.com",
        "host": "string",
        "type": "A",
        "value_list": [
            "string",
        ],
    },
)
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"
  }
}

Set 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