Get the create options
Answers what a new site of your company can be: where a CoreStack site can be placed, the packages and staging sizes on offer, and whether you can add a CoreCluster. Answered with Cache-Control: no-store.
Returns
200 The options.
Fields of the 200 answer
The application versions on offer, by platform. Only while application versions are on for your company.
Fields
Whether something can be done now and, when it cannot, why not.
Fields
Fields
Whether something can be done now and, when it cannot, why not.
Fields
Where a new CoreCluster is ordered in the Control Panel.
The key of each package on offer.
Where a new CoreStack site can be placed: a region of the platform (kind platform), or one of your CoreClusters with its room (kind cluster).
Fields of each item
Whether something can be done now and, when it cannot, why not.
Fields
cluster: how much of its package the CoreCluster uses.
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.
okwarningblockedcluster: the CoreCluster.
Fields
The compute families on offer there.
Fields of each item
general or optimised: the value to send as compute_family.
False when the first site of this family waits for its servers.
cluster: true when the CoreCluster grows by itself when a site needs more room.
platformclusterplatform: the region's name.
The region code, such as uk. Empty for a CoreCluster whose region is not known.
platform: coming_soon while the region takes no CoreStack site yet.
readycoming_soonThe key of each staging size on offer.
Fields
Whether something can be done now and, when it cannot, why not.
Fields
The company the site would belong to. Null when you have no company.
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/create-options \
-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/create-options');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/create-options', {
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/create-options",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"corecluster": {
"available": {
"available": true,
"reason": null
},
"href": "https://manage.corefinity.com/managed-clusters/new"
},
"corestack": {
"available": {
"available": true,
"reason": null
},
"new_cluster_href": "https://manage.corefinity.com/managed-clusters/new",
"packages": [
"cs4"
],
"placements": [
{
"available": {
"available": false,
"reason": "United Kingdom is not set up for CoreStack yet. Choose another region"
},
"family": [],
"kind": "platform",
"label": "United Kingdom",
"region": "uk",
"state": "coming_soon"
},
{
"available": {
"available": true,
"reason": null
},
"capacity": {
"basis": "estimate",
"cpu": {
"capacity_millicores": 8000,
"level": "ok",
"percent": 3,
"used_p95_millicores": 300
},
"evaluated_at": "2026-11-10T00:59:45Z",
"level": "ok",
"memory": {
"capacity_bytes": 34359738368,
"level": "ok",
"percent": 4,
"used_p95_bytes": 1610612736
},
"package": null,
"sites": {
"count": 1,
"environments": 1
},
"storage": {
"capacity_bytes": 0,
"level": "ok",
"percent": 0,
"provisioned_bytes": 21474836480
}
},
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"family": [
{
"available": true,
"first_node_shape": null,
"key": "general",
"label": "Standard",
"note": null,
"provisioned": true,
"reason": null
}
],
"grows": false,
"kind": "cluster",
"region": ""
}
],
"uat_sizes": [
"xsmall",
"small",
"medium",
"large"
]
},
"enterprise": {
"available": {
"available": false,
"reason": "Ask us about CoreStack Enterprise"
},
"href": null
},
"owner": {
"host_slug": "example",
"id": 1204,
"name": "Harbour & Finch"
}
}{
"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
}