List the plans a web hosting package can be changed to
The higher plans one web hosting package can be changed to, with their prices, and the plan it has now.
Lists the higher plans a web hosting package can be changed to, by its site_id, each with its option_id and price (in cent, net or gross, per period), and the plan it has now (current_plan). An empty list means there is none - the highest plan, or a package of the old technology. The change itself is manitu_webhosting_upgradePOST /v1/webhosting/upgrade. Changes nothing.
manitu_webhosting_upgrade_option_list on https://mcp.manitu.de/mcpAnnotations as tools/list sends them
Description for the model
Lists the plans a web hosting package can be changed to (an upgrade: a higher plan, for a higher price), by its site_id - each with its option_id and price (in cent, net or gross, per period) - and the plan it has now (current_plan). An empty list: there is none (the highest plan, or a package of the old technology). To change it: manitu_webhosting_upgradePOST /v1/webhosting/upgrade with the option_id. It changes nothing.
Arguments
site_id (required)integer | stringThe site_id of the package. Never guess one.
Result structuredContent, checked against the schema
site_idintegerThe package.
current_planobjectThe plan the package has now.
current_plan.namestringThe plan, e.g. Webhosting M.
current_plan.price_centintegerThe price per period, in euro cent.
current_plan.price_typestringnet: without VAT; gross: with VAT.
current_plan.period_typestringWhat the price is for: month or year (times period_length), onetime, or none.
current_plan.period_lengthintegerHow many months or years one period has.
upgrade_option_listarray of objectupgrade_option_list[].option_idstringWhat manitu_webhosting_upgradePOST /v1/webhosting/upgrade takes, e.g. webhosting_l.
upgrade_option_list[].planobjectThe plan after the change.
upgrade_option_list[].plan.namestringThe plan, e.g. Webhosting M.
upgrade_option_list[].plan.price_centintegerThe price per period, in euro cent.
upgrade_option_list[].plan.price_typestringnet: without VAT; gross: with VAT.
upgrade_option_list[].plan.period_typestringWhat the price is for: month or year (times period_length), onetime, or none.
upgrade_option_list[].plan.period_lengthintegerHow many months or years one period has.
Authentication
One of X-API-Key, Authorization: Bearer … - never more than one in a request. More
Request body JSON; unknown fields are refused
site_id (required)integer | stringThe site_id of the package.
Response in data; the rest of the body as on every call
site_idintegerThe package.
current_planobjectThe plan the package has now.
current_plan.namestringThe plan, e.g. Webhosting M.
current_plan.price_centintegerThe price per period, in euro cent.
current_plan.price_typestringnet: without VAT; gross: with VAT.
current_plan.period_typestringWhat the price is for: month or year (times period_length), onetime, or none.
current_plan.period_lengthintegerHow many months or years one period has.
upgrade_option_listarray of objectupgrade_option_list[].option_idstringWhat manitu_webhosting_upgradePOST /v1/webhosting/upgrade takes, e.g. webhosting_l.
upgrade_option_list[].planobjectThe plan after the change.
upgrade_option_list[].plan.namestringThe plan, e.g. Webhosting M.
upgrade_option_list[].plan.price_centintegerThe price per period, in euro cent.
upgrade_option_list[].plan.price_typestringnet: without VAT; gross: with VAT.
upgrade_option_list[].plan.period_typestringWhat the price is for: month or year (times period_length), onetime, or none.
upgrade_option_list[].plan.period_lengthintegerHow many months or years one period has.
Statuses
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.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.