CorefinityCorefinityDocs
Open the Control PanelControl Panel
Packages and capacity · 2 of 12

Switch a CoreCluster's server type

Moves every site of a CoreCluster between the two server types, general (Standard) and optimised (Performance); the CoreCluster is billed at the new price once the last site has moved. It is all or nothing: when any site cannot move yet, nothing is queued and the refusal's refused lists each such site. A CoreCluster with no billing contract takes the change all the same, unpriced: quote is null.

POST/api/corestack/clusters/{cluster}/compute-family

Path parameters

clusterintegerRequired

The id of a CoreCluster. Digits only. At least 1.

Body

applystring

When a change that needs a maintenance window is applied. now applies it at once. tonight queues it for the site's next window. window means the same as tonight. An endpoint that takes window only while maintenance windows are on for your company says so, and refuses it 422 on apply otherwise. Defaults to now.

nowtonightwindow
confirm_namestringRequired

The CoreCluster's name, typed exactly. Up to 253 characters.

familystringRequired

The server type to move to. general is Standard and optimised is Performance.

generaloptimised
quote_idstring or null

The id of a quote from POST /corestack/billing/quote. With it, the change is refused 409 stale when the price is no longer the quote's. Format: uuid.

Returns

201 The moves are queued or started: one entry of items for each site, with its own operation once it has started. settled is true when no site had to move.

Fields of the 201 answer
alreadyarray of objectsRequired

The sites that are on the server type already.

clusterobjectRequired

The CoreCluster, as GET /corestack/clusters/{cluster} answers it.

itemsarray of objectsRequired

One entry for each site that moves.

Fields of each item
itemobject
operationobject or null
reasonstring or null
siteobject or null
startedboolean
operationany or nullRequired

Always null. Each site's move is its own operation.

pendingany or nullRequired
queuedbooleanRequired
quoteobject or nullRequired
settledbooleanRequired

Whether no site had to move.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403billing_forbiddenBilling is for the organisation's owner and billing contacts. Ask one of them to do this.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409same_familyThis is already the server type. Choose a different one.
422confirm_mismatchSend the confirmation exactly as the field named in field asks for it.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
503temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
503tier_cluster_missingThe platform has no compute cluster for this here yet. Contact support.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/corestack/clusters/1017/compute-family \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "confirm_name": "Northwind UK 1",
    "family": "optimised"
  }'
{
  "already": [],
  "cluster": {},
  "items": [],
  "operation": null,
  "pending": null,
  "queued": false,
  "quote": null,
  "settled": true
}
Try it

Try it is off for this endpointIt can add to your bill. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT