Get the automatic upgrades setting
Answers whether the company lets its CoreClusters grow automatically when a new site or environment would not fit, the monthly limit on what that may add to the bill, and this month's upgrades, newest first (20 at most). A company you may not manage answers the same 404 as one that does not exist.
Path parameters
The id of a company you belong to or manage. Digits only. At least 1.
Returns
200 The setting.
Fields of the 200 answer
Whether they are on and can buy now.
Whether automatic upgrades can be turned on now.
Whether you may turn them on or raise the limit.
Whether you may turn them off.
At least 1.
When they were turned on, or the limit last raised. null while they are off. Format: date-time.
The company's billing currency.
Whether they are on.
The highest limit that can be set now.
Fields
The most automatic upgrades that can be made in a month.
The calendar month (UTC) the limit counts in, as YYYY-MM.
The limit on what new upgrades may add each month. null until a limit is set.
How many automatic upgrades were made this month.
This month's automatic upgrades, newest first, 20 at most.
Fields of each item
Format: date-time.
At least 1.
What was bought, such as cluster_addons, cluster_package or target_disk.
Fields
The operation that made the upgrade, to follow with GET /. At least 1.
pending while the upgrade is being made, bought once it is.
pendingboughtWhat was bought, in a sentence.
What is left of the limit this month. null while they cannot buy.
What this month's new upgrades have added.
Fields
Why they cannot be turned on, in a sentence. null when they can.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
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. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/companies/1204/auto-upgrades \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/companies/1204/auto-upgrades');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/companies/1204/auto-upgrades', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.get(
"https://manage.corefinity.com/api/corestack/companies/1204/auto-upgrades",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"active": true,
"available": true,
"can_change": true,
"can_turn_off": true,
"company_id": 1180,
"consented_at": "2026-11-02T09:12:44Z",
"currency": "GBP",
"enabled": true,
"max_monthly_limit": {
"amount": "100000.00",
"currency": "GBP"
},
"max_purchases_per_month": 20,
"month": "2026-11",
"monthly_limit": {
"amount": "250.00",
"currency": "GBP"
},
"purchases_this_month": 1,
"recent": [
{
"at": "2026-11-09T14:03:27Z",
"cluster_id": 1017,
"kind": "cluster_addons",
"monthly_delta": {
"amount": "18.00",
"currency": "GBP"
},
"operation_id": 5120,
"state": "bought",
"summary": "1 core and 2 GB of RAM added"
}
],
"remaining_this_month": {
"amount": "232.00",
"currency": "GBP"
},
"spent_this_month": {
"amount": "18.00",
"currency": "GBP"
},
"unavailable_reason": null
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}