CorefinityCorefinityDocs
Open the Control PanelControl Panel
Websites and environments · 3 of 7

Update an environment's staging size answer

Records which staging size the environment gets when it moves to CoreStack: accept the larger size its measured memory suggests, or keep the smaller one. The larger size can cost more each month. The answer can be changed until the move uses it.

POST/api/environments/{environment}/move-size

Path parameters

environmentintegerRequired

The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.

Body

acknowledge_warningboolean

Send true with keep, once the person has read the option's warning.

answerstringRequired

accept takes the larger size, keep the smaller one.

acceptkeep
confirm_costboolean

Send true with accept when the option's confirm_cost is true, once the person has agreed to the extra monthly cost.

question_idintegerRequired

The id of the environment's move_size. At least 1.

Returns

200 The question with the answer recorded.

Fields of the 200 answer
dataobjectRequired

The staging size an environment's move to CoreStack asks about: the memory it was measured to use, the two sizes with their prices, and the answer once given.

Fields
answerobject or any or nullRequired

The answer given. Null until one is.

asked_atstring or nullRequired

Format: date-time.

disk_sizestringRequired

The smaller size, which the disk alone suggests.

idintegerRequired

The question_id to answer. At least 1.

measuredstring or nullRequired

What was measured, in a sentence.

memory_sizestringRequired

The larger size, which the measured memory suggests.

optionsarray of objectsRequired

The two answers: accept the larger size, or keep the smaller one.

Fields of each item
answerstringRequired

The value to send as answer for this size.

acceptkeep
confirm_costbooleanRequired

True when this answer costs more a month, so it must be sent with confirm_cost: true.

currencystring or nullRequired
deltastring or nullRequired

How much more a month the larger size costs than the smaller one.

includedboolean or nullRequired

Whether your plan includes this size at no charge.

labelstringRequired
monthlystring or nullRequired

The monthly price of the size from when the move goes live. Null when it could not be priced.

uat_sizestringRequired

The staging size, such as medium or large.

warningstring or nullRequired

What keeping the smaller size risks. Sent on the keep option.

price_notestring or nullRequired
pricedbooleanRequired
rule_versionstringRequired
statestringRequired

open until answered, then answered. An answer can be changed until the move uses it.

openanswered
window_daysintegerRequired

How many days of use were measured.

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.
409staleWhat you read has changed since you read it. Read it again, then send the change with its new version or quote.
422invalidFix the field named in field; errors says why.
422confirm_costLarge costs £150.00/month more. Send confirm_cost: true once the customer has agreed to the extra cost.
422warning_not_acknowledgedThis environment used more memory than Medium gives. It may run out of memory and stop commands or pages; you can resize later. Tick the warning to keep the smaller size.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/environments/1311/move-size \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "answer": "accept",
    "confirm_cost": true,
    "question_id": 5312
  }'
{
  "data": {
    "answer": {
      "answer": "accept",
      "answered_at": "2026-11-03T09:20:05Z",
      "on_behalf": false,
      "uat_size": "large",
      "warning_acknowledged": false
    },
    "asked_at": "2026-11-03T09:16:40Z",
    "disk_size": "medium",
    "id": 5312,
    "measured": "Over the last 14 days this environment used up to 2.9 GB for PHP; Large gives PHP 4 GB.",
    "memory_size": "large",
    "options": [
      {
        "answer": "accept",
        "confirm_cost": true,
        "currency": "GBP",
        "delta": "150.00",
        "included": false,
        "label": "Large, £150.00/month (+£150.00)",
        "monthly": "150.00",
        "uat_size": "large",
        "warning": null
      },
      {
        "answer": "keep",
        "confirm_cost": false,
        "currency": "GBP",
        "delta": null,
        "included": true,
        "label": "Medium, included at no charge",
        "monthly": "0.00",
        "uat_size": "medium",
        "warning": "This environment used more memory than Medium gives. It may run out of memory and stop commands or pages; you can resize later."
      }
    ],
    "price_note": null,
    "priced": true,
    "rule_version": "1",
    "state": "answered",
    "window_days": 14
  }
}
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