Check whether a new site fits
Checks whether a new CoreStack site with this package would fit in a region, without creating or reserving anything. ok is false when the create would be refused, and blocking says why.
Body
Your own company. Any other company is refused 422 on company.
The server type. One is accepted only while it is offered to your company and in the region. Defaults to general.
generaloptimisedOne entry for each staging environment to create with the site.
Fields of each item
A staging size key, such as xsmall.
The key of an active CoreStack package, such as cs4.
A region key of two to four lower-case letters, such as uk.
Returns
200 The result of the check.
Fields of the 200 answer
What the site and its environments would add.
Fields
Why the create would be refused. Empty when it would not.
Fields of each item
A stable code, such as no_platform_cluster, package_restricted or compute_blocked.
Where the site would be placed. Null when the region is not set up.
Format: date-time.
Set when the create would wait for capacity to be added instead of starting at once.
Fields
Each row the create would make, the production row first.
Fields of each item
productionstagingSentences to know about, such as a create that would wait for capacity to be added. They never make ok false.
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 | forbidden | The person is not allowed to do this. |
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. |
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/capacity/check \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"package": "cs4",
"region": "uk"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/capacity/check', [
'package' => 'cs4',
'region' => 'uk',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/capacity/check', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
package: 'cs4',
region: 'uk',
}),
});
// 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/capacity/check",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"package": "cs4",
"region": "uk",
},
)
data = res.json() if res.content else None{
"added": {
"cpu_millicores": 4500,
"disk_bytes": 236223201280,
"environments": 1,
"memory_bytes": 19327352832,
"sites": 1
},
"blocking": [],
"cluster": {
"id": 1009,
"name": "CoreStack"
},
"current": null,
"evaluated_at": "2026-11-04T11:32:06Z",
"node_pending": null,
"ok": true,
"package": {
"key": "cs4",
"name": "CS4"
},
"projected": null,
"rows": [
{
"node_pending": null,
"role": "production",
"tier": "shared",
"uat_size": null
},
{
"node_pending": null,
"role": "staging",
"tier": "shared",
"uat_size": "xsmall"
}
],
"storage_pending": false,
"warnings": []
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"package": [
"Choose a package"
]
},
"field": "package",
"message": "Choose a package",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}