Convert website of a web hosting package

Make a website an alias of another one, or an alias a website of its own.

DDestructiveNot idempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_web_vhost_converton https://mcp.manitu.de/mcp

POST

/v1/webhosting/web/vhost/converton 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

Converts a website (vHost) of a web hosting package of the manitu customer account this connection works in, by site_id and fqdn from manitu_webhosting_web_vhost_list. to alias (alias_of required - another website, not an alias): it then shows what that website shows, with its HTTPS settings; its own folder or redirect, HSTS and alternative hostname are given up for good, its own aliases move to that website (moved_alias_list). to website: an alias becomes a website of its own and keeps showing what it showed, changeable with manitu_webhosting_web_vhost_set. Status, certificate and description stay. A websitebuilder cannot be converted (not_convertible); converting to the type it has is a conflict (already_type). Takes up to an hour everywhere. Refused with a conflict when the package cannot be changed now (not_configurable). Tell the customer what is given up and ask 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 website from manitu_webhosting_web_vhost_list, e.g. shop.example.de. Never guess one.

min length 3max length 253

tostringrequired

website or alias.

One of website alias

alias_ofstring

For to alias - required then: the website (or websitebuilder) it belongs to, by fqdn from manitu_webhosting_web_vhost_list. Not an alias, not itself.

min length 3max length 253

redirect_to_parentboolean

For to alias: redirect visitors to that website's name (HTTP 301, default true); false: show the same under its own name.

Result structuredContent, checked against the schema

fqdnstringrequired

The name, e.g. www.example.de - a domain or subdomain of the package; what the other tools take. Unicode for an internationalized domain.

fqdn_asciistringrequired

The same name as DNS has it (xn--... for an internationalized domain).

typestringrequired

website (the customer's files from a folder, or a redirect to a URL), websitebuilder (made with manitu's website builder) or alias (a further name of a website - see alias).

One of website websitebuilder alias

statusstringrequired

inactive: switched off, the files are kept - visitors get when_inactive.

One of active inactive

when_inactiveobjectrequired

What visitors get while it is inactive.

when_inactive.responsestringrequired

An HTTP status (403, 404, 503 - 503 tells search engines to come back), hide (as if there were no website) or page (a page of manitu's, see page).

One of http_status_403 http_status_404 http_status_503 hide page

when_inactive.pagestring | nullrequired

Which page, for response page: disabled, underconstruction or maintenance.

One of disabled underconstruction maintenance null

websiteobject | nullrequired

For type website, else null.

website.target_dirstring | nullrequired

The folder shown, relative to the web root, e.g. /htdocs/www.example.com/ (the older layout: /web/...) - see manitu_webhosting_web_structure_get; null when it redirects.

website.redirect_urlstring | nullrequired

The URL every visitor is sent to - null when it shows a folder.

website.allow_wordpress_xmlrpcbooleanrequired

WordPress' XML-RPC interface reachable - off by default, a frequent target of brute force attacks that manitu's firewall cannot block.

websitebuilderobject | nullrequired

For type websitebuilder, else null. The editor opens with manitu_webhosting_web_vhost_websitebuilder_get.

websitebuilder.target_dirstringrequired

The folder manitu set for it - not to be changed.

aliasobject | nullrequired

For type alias, else null. An alias shows what its website shows, with its HTTPS settings; status, certificate and description are its own.

alias.ofstring | nullrequired

The website it belongs to (fqdn) - null only for an old alias that lost it.

alias.redirect_to_parentbooleanrequired

Visitors are redirected to the website's name (HTTP 301); false: the alias shows the same under its own name.

httpsobject | nullrequired

For a website or websitebuilder; null for an alias (its website's apply).

https.redirectbooleanrequired

Visitors coming with http:// are sent to https://.

https.hstsobjectrequired

HSTS (Strict-Transport-Security): browsers remember to use only HTTPS.

https.hsts.activebooleanrequired

https.hsts.max_ageintegerrequired

How long browsers remember it, in seconds.

https.hsts.include_subdomainsbooleanrequired

https.hsts.preloadbooleanrequired

alternative_hostnameobject | nullrequired

A second name under vhost.manitu.de that shows the same - e.g. before a domain transfer or while DNS is not there yet. Null for an alias.

alternative_hostname.activebooleanrequired

alternative_hostname.fqdnstring | nullrequired

The name, e.g. 1a2b3c4d.vhost.manitu.de - null while not active. A new one each time it is switched on.

alternative_hostname.noindexbooleanrequired

Search engines are asked not to index it under this name.

alias_listarray of string | nullrequired

Its aliases (fqdn) - null for an alias.

certificateobject | nullrequired

Its SSL certificate - null if none.

certificate.typestringrequired

One of letsencrypt custom

certificate.statusstringrequired

pending: asked for, usually issued within an hour; error: could not be issued - often the name does not point to manitu yet.

One of active pending error expired

certificate.expires_atstring | nullrequired

When it runs out (the same as manitu_webhosting_web_certificate_get) - Let's Encrypt renews in time; null while pending.

Format date-time

descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

created_atstring | nullrequired

Format date-time

moved_alias_listarray of stringrequired

The aliases it had as a website - they belong to its new website (alias.of) now.

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 website from manitu_webhosting_web_vhost_list, e.g. shop.example.de. Never guess one.

min length 3max length 253

tostringrequired

website or alias.

One of website alias

alias_ofstring

For to alias - required then: the website (or websitebuilder) it belongs to, by fqdn from manitu_webhosting_web_vhost_list. Not an alias, not itself.

min length 3max length 253

redirect_to_parentboolean

For to alias: redirect visitors to that website's name (HTTP 301, default true); false: show the same under its own name.

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

fqdnstringrequired

The name, e.g. www.example.de - a domain or subdomain of the package; what the other tools take. Unicode for an internationalized domain.

fqdn_asciistringrequired

The same name as DNS has it (xn--... for an internationalized domain).

typestringrequired

website (the customer's files from a folder, or a redirect to a URL), websitebuilder (made with manitu's website builder) or alias (a further name of a website - see alias).

One of website websitebuilder alias

statusstringrequired

inactive: switched off, the files are kept - visitors get when_inactive.

One of active inactive

when_inactiveobjectrequired

What visitors get while it is inactive.

when_inactive.responsestringrequired

An HTTP status (403, 404, 503 - 503 tells search engines to come back), hide (as if there were no website) or page (a page of manitu's, see page).

One of http_status_403 http_status_404 http_status_503 hide page

when_inactive.pagestring | nullrequired

Which page, for response page: disabled, underconstruction or maintenance.

One of disabled underconstruction maintenance null

websiteobject | nullrequired

For type website, else null.

website.target_dirstring | nullrequired

The folder shown, relative to the web root, e.g. /htdocs/www.example.com/ (the older layout: /web/...) - see manitu_webhosting_web_structure_get; null when it redirects.

website.redirect_urlstring | nullrequired

The URL every visitor is sent to - null when it shows a folder.

website.allow_wordpress_xmlrpcbooleanrequired

WordPress' XML-RPC interface reachable - off by default, a frequent target of brute force attacks that manitu's firewall cannot block.

websitebuilderobject | nullrequired

For type websitebuilder, else null. The editor opens with manitu_webhosting_web_vhost_websitebuilder_get.

websitebuilder.target_dirstringrequired

The folder manitu set for it - not to be changed.

aliasobject | nullrequired

For type alias, else null. An alias shows what its website shows, with its HTTPS settings; status, certificate and description are its own.

alias.ofstring | nullrequired

The website it belongs to (fqdn) - null only for an old alias that lost it.

alias.redirect_to_parentbooleanrequired

Visitors are redirected to the website's name (HTTP 301); false: the alias shows the same under its own name.

httpsobject | nullrequired

For a website or websitebuilder; null for an alias (its website's apply).

https.redirectbooleanrequired

Visitors coming with http:// are sent to https://.

https.hstsobjectrequired

HSTS (Strict-Transport-Security): browsers remember to use only HTTPS.

https.hsts.activebooleanrequired

https.hsts.max_ageintegerrequired

How long browsers remember it, in seconds.

https.hsts.include_subdomainsbooleanrequired

https.hsts.preloadbooleanrequired

alternative_hostnameobject | nullrequired

A second name under vhost.manitu.de that shows the same - e.g. before a domain transfer or while DNS is not there yet. Null for an alias.

alternative_hostname.activebooleanrequired

alternative_hostname.fqdnstring | nullrequired

The name, e.g. 1a2b3c4d.vhost.manitu.de - null while not active. A new one each time it is switched on.

alternative_hostname.noindexbooleanrequired

Search engines are asked not to index it under this name.

alias_listarray of string | nullrequired

Its aliases (fqdn) - null for an alias.

certificateobject | nullrequired

Its SSL certificate - null if none.

certificate.typestringrequired

One of letsencrypt custom

certificate.statusstringrequired

pending: asked for, usually issued within an hour; error: could not be issued - often the name does not point to manitu yet.

One of active pending error expired

certificate.expires_atstring | nullrequired

When it runs out (the same as manitu_webhosting_web_certificate_get) - Let's Encrypt renews in time; null while pending.

Format date-time

descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

created_atstring | nullrequired

Format date-time

moved_alias_listarray of stringrequired

The aliases it had as a website - they belong to its new website (alias.of) 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_webhosting_web_vhost_convert",
    "arguments": {
      "site_id": 12345,
      "fqdn": "example.com",
      "to": "website"
    }
  }
}

Result

{
  "structuredContent": {
    "fqdn": "example.com",
    "fqdn_ascii": "string",
    "type": "website",
    "status": "active",
    "when_inactive": {
      "response": "http_status_403",
      "page": "disabled"
    },
    "website": {
      "target_dir": "/web",
      "redirect_url": "https://www.example.com/",
      "allow_wordpress_xmlrpc": true
    },
    "websitebuilder": {
      "target_dir": "/web"
    },
    "alias": {
      "of": "string",
      "redirect_to_parent": true
    },
    "https": {
      "redirect": true,
      "hsts": {
        "active": true,
        "max_age": 1,
        "include_subdomains": true,
        "preload": true
      }
    },
    "alternative_hostname": {
      "active": true,
      "fqdn": "example.com",
      "noindex": true
    },
    "alias_list": [
      "string"
    ],
    "certificate": {
      "type": "letsencrypt",
      "status": "active",
      "expires_at": "2026-10-23T12:00:00+02:00"
    },
    "description": "Example",
    "created_at": "2026-10-23T12:00:00+02:00",
    "moved_alias_list": [
      "string"
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/web/vhost/convert

Request

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

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

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/web/vhost/convert');

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","to":"website"}',
    CURLOPT_RETURNTRANSFER => true,
]);

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

import os

import requests

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

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "fqdn": "example.com",
    "fqdn_ascii": "string",
    "type": "website",
    "status": "active",
    "when_inactive": {
      "response": "http_status_403",
      "page": "disabled"
    },
    "website": {
      "target_dir": "/web",
      "redirect_url": "https://www.example.com/",
      "allow_wordpress_xmlrpc": true
    },
    "websitebuilder": {
      "target_dir": "/web"
    },
    "alias": {
      "of": "string",
      "redirect_to_parent": true
    },
    "https": {
      "redirect": true,
      "hsts": {
        "active": true,
        "max_age": 1,
        "include_subdomains": true,
        "preload": true
      }
    },
    "alternative_hostname": {
      "active": true,
      "fqdn": "example.com",
      "noindex": true
    },
    "alias_list": [
      "string"
    ],
    "certificate": {
      "type": "letsencrypt",
      "status": "active",
      "expires_at": "2026-10-23T12:00:00+02:00"
    },
    "description": "Example",
    "created_at": "2026-10-23T12:00:00+02:00",
    "moved_alias_list": [
      "string"
    ]
  }
}

Convert website 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