Delete mail address of a web hosting package

Delete one mail address of a web hosting package - a mailbox with all its mail.

DDestructiveNot idempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_mail_address_deleteon https://mcp.manitu.de/mcp

POST

/v1/webhosting/mail/address/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 mail address of a web hosting package of the manitu customer account this connection works in, by site_id and mail_address from manitu_webhosting_mail_address_list, of any type. Its aliases go with it; a MAILBOX GOES WITH ALL ITS MAIL, for good; the address is taken out of other addresses' targets. Mail to it is then handled by the catch-all of its domain, if there is one, else refused. To switch a mailbox off for a while, use manitu_webhosting_mail_address_set with mailbox.suspended instead; to remove an alias, set the alias_list of its address. Refused with a conflict when the package cannot be changed now (not_configurable). Ask the customer for an explicit yes first, naming the address, its type and - for a mailbox - that its mail is lost.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254

Result structuredContent, checked against the schema

mail_addressstringrequired

The address deleted.

typestring | nullrequired

What it was - as in the list.

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

mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254

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

mail_addressstringrequired

The address deleted.

typestring | nullrequired

What it was - as in the list.

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_mail_address_delete",
    "arguments": {
      "site_id": 12345,
      "mail_address": "info@example.com"
    }
  }
}

Result

{
  "structuredContent": {
    "mail_address": "info@example.com",
    "type": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/mail/address/delete

Request

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

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

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/mail/address/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,"mail_address":"info@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/mail/address/delete",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
        "mail_address": "info@example.com",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "mail_address": "info@example.com",
    "type": "string"
  }
}

Delete mail address 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