Get a new site's progress
The stages of a site's create, with its state. It never shows the new site's admin login. A site that no create made answers 404.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Returns
200 The create's progress.
Fields of the 200 answer
What the create is waiting for while capacity is being added.
The cluster the site is created in.
The progress of each environment created with the site.
A change the Control Panel is making or has made. A save or an action that starts work answers one in operation; read it again by id with GET / until status is completed or failed. Both answers have this shape; the few endpoints that answer a different one say so.
Fields
The cluster the operation runs on.
Why the operation failed, in plain words. Null unless status is failed.
A stable code for the failure.
True when the change applies without a maintenance window.
What the operation did differently on purpose. Empty when nothing.
Fields of each item
Who asked for the change.
Present on some site creations and copies.
Always null here. A one-time result is read once with the reveal endpoint.
nonependingavailableviewedWhat a retry needs first, if anything.
Who revealed a one-time result and when, when there was one.
siteclusterbatchThe website the operation belongs to. Null for a cluster's own operation.
Where a change is. completed and failed are final; every other status means the change is still running and blocks another change to the same site.
pendingcommittedrolling_outexecutingcompletedfailedThe key of the step the operation is at. Null once it has completed.
Fields of each item
One of done, current, todo, failed or skipped.
The kind of change, such as crons_change or redirects_change.
Null unless the site was created before your company had a payment method. Then add_by is the date to add one by and message says so in plain words.
The same for a retry of the create, or null.
A site or environment row as lists and progress answers show it. Other fields may be present; the ones named here are always sent.
Fields
healthydegradeddownapplyingunknownnot_liveFields
customer for a site in one of your CoreClusters, platform for a standalone CoreStack site.
The site row id, the {site} of every /corestack/sites/{site} endpoint.
On a read (a site, the list of sites, a CoreCluster's sites, the overview): corecluster for a site in one of your CoreClusters, corestack for a standalone CoreStack site. The answer to a change that carries the row, such as creating a site, can send corestack for either; hosting.cluster_kind tells the two apart on every answer.
coreclustercorestackFields
Fields
production once a domain is attached, staging before.
productionstagingunknownThe change running on the row now, or null.
The package of a standalone CoreStack site, with its key, code and name. Null for a CoreCluster site.
The changes waiting for the row's next maintenance window.
Fields
Fields
Fields
The row's own address on the platform.
The restore running on the row now, or null.
The site the row belongs to. For a production row, the row itself.
The row's platform identifier.
A summary of the row's snapshots.
Fields
The size of the row, such as S, M or L.
The size of a staging environment. Null for a production row.
Fields
Fields of each item
Such as done, current, todo, skipped or failed.
creatingcapacity_being_addedreadyfailedIf 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/sites/1042/progress \
-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/sites/1042/progress');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/progress', {
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/sites/1042/progress",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"capacity": null,
"cluster": {
"id": 1009,
"name": "CoreStack"
},
"elapsed_seconds": 42,
"environments": [],
"failed": null,
"operation": {
"completed_at": null,
"created_at": "2026-11-14T09:00:00Z",
"error": null,
"id": 5100,
"scope": "site",
"status": "executing",
"status_label": "Running",
"steps": [
{
"key": "reserved",
"label": "Port and address reserved",
"state": "done"
}
],
"type": "provision",
"type_label": "New site"
},
"order": null,
"payment": null,
"requested": {
"at": "2026-11-14T09:00:00+00:00",
"by": {
"id": 2041,
"name": "Eleanor Finch"
}
},
"retried": null,
"site": {
"domain": "harbourandfinch.example.com",
"health": "unknown",
"id": 1042,
"kind": "corestack",
"limits": {
"cpu_millicores": 2000,
"disk_bytes": 10737418240,
"memory_bytes": 4294967296
},
"mariadb": {
"version": "11.8"
},
"mode": "staging",
"mode_label": "No domain",
"operation": null,
"php": {
"version": "8.3"
},
"primary_url": null,
"removed": false,
"tier": "S",
"usage": {
"cpu_millicores": null,
"disk_used_bytes": null,
"memory_bytes": null,
"observed_at": null,
"source": null
}
},
"stages": [
{
"at": "2026-11-14T09:00:00+00:00",
"detail": null,
"key": "requested",
"label": "Requested",
"state": "done"
},
{
"at": "2026-11-14T09:00:02+00:00",
"detail": null,
"key": "placed",
"label": "Server assigned",
"state": "done"
},
{
"at": "2026-11-14T09:00:05+00:00",
"detail": null,
"key": "committed",
"label": "Committed",
"state": "done"
},
{
"at": null,
"detail": null,
"key": "starting",
"label": "Starting",
"state": "current"
},
{
"at": null,
"detail": null,
"key": "installing",
"label": "Installing WordPress",
"state": "todo"
},
{
"at": null,
"detail": null,
"key": "environments",
"label": "Environments",
"state": "skipped"
},
{
"at": null,
"detail": null,
"key": "ready",
"label": "Ready",
"state": "todo"
}
],
"state": "creating"
}{
"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
}