CorefinityCorefinityDocs
Open the Control PanelControl Panel
Sites · 20 of 23

corestack_site_compute_family_switch

Change a site's server type.

Scope writeAsks you to confirmRuns as a taskNo secrets returned
On this page

When to use it

Move a CoreStack site to the Standard or the Performance server type, now or tonight. The site moves to the new servers. Price it first with corestack_billing_quote_preview.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_site_compute_family_switch with site_id 4211, family general. (Change a site's server type.) Tell me what it returned.

Inputs

applystring

now (the default) or tonight, in the maintenance window, with everything else queued for the row. window: the row's next maintenance window (tonight is kept as its alias). Defaults to now.

nowwindowtonight
confirm_domainstringRequiredConfirmation

The site's domain, typed to confirm. Up to 253 characters.

familystringRequired

general: Standard; optimised: Performance.

generaloptimised
quote_idstring

A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.

site_idintegerRequired

The site (its production row). At least 1.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corestack_site_compute_family_switch",
  "arguments": {
    "site_id": 4211,
    "family": "general",
    "confirm_domain": "example.co.uk"
  }
}

If it is refused

ReasonWhat to do
same_familyThe row already uses that server type; nothing to change.
cluster_siteThe site is in a CoreCluster, where this is set on the cluster; use the corecluster_ tool.
provisioningThe site is still being created; wait for corestack_site_provisioning_get to finish.
contract_missingThe billing contract changed while the change was being made; read the options again and call again. (A site or cluster with no billing contract is changed all the same, without a quote: it is not billed in the Control Panel.)
staleThe quote no longer matches this change or has expired; preview a new one with corestack_billing_quote_preview and call again with its quote_id.
no_payment_methodThe company has no payment method; the person must add one in the Control Panel.
restart_batches_offThe maintenance window queue was switched off as this was called, and a server type change goes through it now as well as tonight; nothing was changed.
change_pendingA change is already pending for this row; apply or cancel it first (corestack_pending_changes_list).
family_unavailableThat server type is not available here; choose another.
confirm_mismatchA typed confirmation does not match (confirm_domain: the site's domain on production, the canonical host elsewhere; confirm_name: the cluster's or environment's name); ask the person for the exact value.
billing_forbiddenThe person has no billing role in the company; ask a company owner or billing member.
forbiddenThe Control Panel refuses this person the action and names no reason; stop.
demo_keep_requiredThe site or cluster is a free demo that is not kept yet, and this change costs money: it starts once the demo is kept. Ask the person to keep it (corestack_demo_keep, or open keep_url); change names this change and what it would cost a month once kept.
managed_elsewhereAnother control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT