Delete subdomain of a web hosting package

Delete one subdomain of a web hosting package that nothing uses.

DDestructiveNot idempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_subdomain_deleteon https://mcp.manitu.de/mcp

POST

/v1/webhosting/subdomain/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 falseopenWorldHint false

Description for the model

Deletes a subdomain of a web hosting package of the manitu customer account this connection works in, by site_id and fqdn from manitu_webhosting_subdomain_list. Only one nothing uses: a website (vHost) or mail addresses at it give a conflict (in_use, saying what) - remove those first, with the customer. Its records go from the DNS zone of the domain only where the zone is at manitu; elsewhere (dns_zone: not_at_manitu) the customer removes them himself at his DNS provider - do not say they are gone before the answer says dns_zone: updated. Files and mail are not touched. Refused with a conflict when the package cannot be changed now (not_configurable). Ask the customer for an explicit yes first.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

fqdnstringrequired

The subdomain from manitu_webhosting_subdomain_list, e.g. cloud.example.de. Never guess one.

min length 3max length 253

dns_zone_updateboolean

Merge manitu's records for the subdomain into the DNS zone of the domain (default true). false only if the customer keeps the zone by hand - then he must set the records himself.

Result structuredContent, checked against the schema

fqdnstringrequired

The subdomain deleted.

dns_zonestringrequired

What became of the DNS zone of the domain: updated - manitu's records for the subdomain were merged in (the customer's own MX, A and AAAA kept where possible; changes made by hand should be checked); skipped - not asked for or nothing to change; not_at_manitu - the zone is elsewhere, the customer must set the records there, else the subdomain does not work; failed - the subdomain is saved, the zone not - the customer should check it.

One of updated skipped not_at_manitu failed

Authentication

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

Request body JSON; unknown fields are refused

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

fqdnstringrequired

The subdomain from manitu_webhosting_subdomain_list, e.g. cloud.example.de. Never guess one.

min length 3max length 253

dns_zone_updateboolean

Merge manitu's records for the subdomain into the DNS zone of the domain (default true). false only if the customer keeps the zone by hand - then he must set the records himself.

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

fqdnstringrequired

The subdomain deleted.

dns_zonestringrequired

One of updated skipped not_at_manitu failed

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_webhosting_subdomain_delete",
    "arguments": {
      "site_id": 12345,
      "fqdn": "example.com"
    }
  }
}

Result

{
  "structuredContent": {
    "fqdn": "example.com",
    "dns_zone": "updated"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/subdomain/delete

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/subdomain/delete' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345,
    "fqdn": "example.com"
  }'

const response = await fetch('https://api.manitu.de/v1/webhosting/subdomain/delete', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "site_id": 12345,
    "fqdn": "example.com"
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/subdomain/delete');

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

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

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/webhosting/subdomain/delete",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
        "fqdn": "example.com",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "fqdn": "example.com",
    "dns_zone": "updated"
  }
}

Delete subdomain of a web hosting package

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