Check what fits a new CoreCluster
Answers whether the sites and environments you list would fit a package in a region, before the CoreCluster exists. Nothing is created or reserved. A proposal that would not fit still answers 200, with the reasons in blocking.
Body
Up to 50 items.
Fields of each item
A platform, such as wordpress, laravel or magento2.
A size the platform has, such as S, M or L.
The key of a CoreCluster package, such as xsmall.
ukusnlausAlways empty or left out. There is nothing to take away before the CoreCluster exists. Up to 0 items.
Up to 50 items.
Fields of each item
A platform, such as wordpress, laravel or magento2.
A size the platform has, such as S, M or L.
Returns
200 The capacity of the package now and with the proposal. cluster is null.
Fields of the 200 answer
What the proposed sites and environments would add.
Fields
Why the proposal would be refused now. Empty when it would not.
Fields of each item
The meter that would be over, for capacity_blocked.
A stable code, such as capacity_blocked, package_restricted, cluster_not_ready or region_unavailable.
The CoreCluster that was checked. Null for a check before the CoreCluster exists.
The capacity as it is now. How much of the package the CoreCluster's sites use.
Fields
What the usage figures are: measured (p95), estimated from the sizes of the sites (estimate), or both (mixed).
p95mixedestimateOne meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedFormat: date-time.
The worst level of the meters.
okwarningblockedOne meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedThe package the figures are measured against. Null for a CoreCluster with no package.
Fields
Fields
One meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedFormat: date-time.
Sent, as true, only when the proposal needs more room than the package has and your company has automatic upgrades on, so the CoreCluster would grow first. warnings says so.
True when blocking is empty.
The package the proposal was measured against.
Fields
The capacity with the proposal. How much of the package the CoreCluster's sites use.
Fields
What the usage figures are: measured (p95), estimated from the sizes of the sites (estimate), or both (mixed).
p95mixedestimateOne meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedFormat: date-time.
The worst level of the meters.
okwarningblockedOne meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedThe package the figures are measured against. Null for a CoreCluster with no package.
Fields
Fields
One meter. The figures are in the unit its field names say; percent is what is used of the capacity.
Fields
ok under 75 per cent, warning from 75 and blocked from 90.
okwarningblockedSentences about a meter the proposal would leave nearly full.
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. |
422 | invalid | Fix the field named in field; errors says why. |
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/corestack/clusters/capacity/check \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"package": "xsmall",
"region": "uk",
"sites": [
{
"platform": "wordpress",
"tier": "S"
}
]
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/clusters/capacity/check', [
'package' => 'xsmall',
'region' => 'uk',
'sites' => [
[
'platform' => 'wordpress',
'tier' => 'S',
],
],
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/clusters/capacity/check', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
package: 'xsmall',
region: 'uk',
sites: [
{
platform: 'wordpress',
tier: 'S',
},
],
}),
});
// 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/corestack/clusters/capacity/check",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"package": "xsmall",
"region": "uk",
"sites": [
{
"platform": "wordpress",
"tier": "S",
},
],
},
)
data = res.json() if res.content else None{
"added": {
"cpu_millicores": 150,
"disk_bytes": 10737418240,
"environments": 0,
"memory_bytes": 805306368,
"sites": 1
},
"blocking": [],
"cluster": null,
"current": {
"basis": "estimate",
"cpu": {
"capacity_millicores": 4000,
"level": "ok",
"percent": 0,
"used_p95_millicores": 0
},
"evaluated_at": null,
"level": "ok",
"memory": {
"capacity_bytes": 17179869184,
"level": "ok",
"percent": 0,
"used_p95_bytes": 0
},
"package": {
"cores": 4,
"key": "xsmall",
"memory_bytes": 17179869184,
"name": "Extra small"
},
"sites": {
"count": 0,
"environments": 0
},
"storage": {
"capacity_bytes": 214748364800,
"level": "ok",
"percent": 0,
"provisioned_bytes": 0
}
},
"evaluated_at": "2026-11-14T10:00:00Z",
"ok": true,
"package": {
"key": "xsmall",
"name": "Extra small"
},
"projected": {
"basis": "estimate",
"cpu": {
"capacity_millicores": 4000,
"level": "ok",
"percent": 3,
"used_p95_millicores": 150
},
"evaluated_at": null,
"level": "ok",
"memory": {
"capacity_bytes": 17179869184,
"level": "ok",
"percent": 4,
"used_p95_bytes": 805306368
},
"package": {
"cores": 4,
"key": "xsmall",
"memory_bytes": 17179869184,
"name": "Extra small"
},
"sites": {
"count": 1,
"environments": 0
},
"storage": {
"capacity_bytes": 214748364800,
"level": "ok",
"percent": 5,
"provisioned_bytes": 10737418240
}
},
"warnings": []
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "invalid",
"errors": {
"region": [
"Choose a region"
]
},
"field": "region",
"message": "Choose a region",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}