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.
Path parameters
The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.
Body
Send true with keep, once the person has read the option's warning.
accept takes the larger size, keep the smaller one.
acceptkeepSend true with accept when the option's confirm_cost is true, once the person has agreed to the extra monthly cost.
The id of the environment's move_size. At least 1.
Returns
200 The question with the answer recorded.
Fields of the 200 answer
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
The answer given. Null until one is.
Format: date-time.
The smaller size, which the disk alone suggests.
The question_id to answer. At least 1.
What was measured, in a sentence.
The larger size, which the measured memory suggests.
The two answers: accept the larger size, or keep the smaller one.
Fields of each item
The value to send as answer for this size.
acceptkeepTrue when this answer costs more a month, so it must be sent with confirm_cost: true.
How much more a month the larger size costs than the smaller one.
Whether your plan includes this size at no charge.
The monthly price of the size from when the move goes live. Null when it could not be priced.
The staging size, such as medium or large.
What keeping the smaller size risks. Sent on the keep option.
open until answered, then answered. An answer can be changed until the move uses it.
openansweredHow many days of use were measured.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | billing_forbidden | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
422 | invalid | Fix the field named in field; errors says why. |
422 | confirm_cost | Large costs £150.00/month more. Send confirm_cost: true once the customer has agreed to the extra cost. |
422 | warning_not_acknowledged | This 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. |
429 | rate_limited | Wait 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
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/environments/1311/move-size', [
'answer' => 'accept',
'confirm_cost' => true,
'question_id' => 5312,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/environments/1311/move-size', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
answer: 'accept',
confirm_cost: true,
question_id: 5312,
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/environments/1311/move-size",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"answer": "accept",
"confirm_cost": True,
"question_id": 5312,
},
)
data = res.json() if res.content else None{
"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
}
}{
"message": "Unauthenticated."
}{
"code": "billing_forbidden",
"message": "Billing is available to your company's owner and billing contacts.",
"reason": "billing_forbidden"
}{
"code": "feature_off",
"message": "Staging sizes measured from memory are not available.",
"reason": "feature_off"
}{
"code": "stale",
"message": "This question was replaced by a newer one (the figures or a price changed). Answer the newer one.",
"reason": "stale"
}{
"code": "invalid",
"errors": {
"answer": [
"The selected answer is invalid."
]
},
"field": "answer",
"message": "The selected answer is invalid.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt can add to your bill. Copy the request and run it yourself when you are sure.