Keep a demo
Keeps the demo, so it carries on as a paid service billed from the next full hour; only an owner or a billing role of the company may. confirm_keep is the site's domain, or the word cluster for a CoreCluster; a bigger package, add-on units or another server type are applied after the Keep, one at a time, and progress follows them. The API never takes billing or card details: when one is missing, the Keep is refused with a keep_url that opens the Keep page in the Control Panel.
Path parameters
The id of a demo, as the list gives it. Digits only. At least 1.
Body
Whether you accept Corefinity's privacy notice. Needed the first time your company keeps anything.
Add-on units to keep it with, each a whole number that is the total wanted. A unit you leave out stays as it is. The totals are checked before anything is kept: one outside its range, or a disk total that is not a multiple of 10, refuses the Keep (addon_bounds).
Fields
Extra cores, 0 to 16.
Extra disk in GB, 0 to 102400 in steps of 10.
Extra log storage in GB, 0 to 1000.
Extra memory in GB, 0 to 64.
Your billing country as a two-letter code, to confirm a country the demo set for you. Up to 2 characters.
The site's domain, or the word cluster for a CoreCluster demo. Upper or lower case. Up to 253 characters.
The server type to keep it on.
generaloptimisednullA bigger package to keep it on, such as CS8. One of the demo's upgrade_options.
Returns
200 The demo is kept, and nothing more has started. upgrade.state is none, queued or refused. A second Keep of a kept demo answers the same, with kept.already true.
202 The demo is kept and its first change has started (upgrade.state is started). Follow upgrade.operation_id, or read the demo's progress. Poll the operation until it finishes.
Fields of the 200 answer
Fields
Whole days until the demo ends. null unless the demo is active.
Format: date-time.
Until when an ended demo can still be kept. Format: date-time.
At least 1.
Fields
Whether you could keep it now.
Why you cannot keep it now, as Keep would refuse it. null when you can, while it is building, and once it is kept or closed.
The Keep page in the Control Panel. Format: uri.
Format: date-time.
The package the demo is on, such as CS4.
What it costs a month once kept as it is. null when it cannot be priced.
CS for a CoreStack site, CC for a CoreCluster.
The region's code, such as uk.
Format: date-time.
building while it is set up, active while it runs, ended once its time is up and it waits in its grace period, kept, or closed.
buildingactiveendedkeptclosedWhat the demo is of.
Fields
The site row's id or the CoreCluster's id. At least 1.
The site's domain or the cluster's name.
siteclusternullFields
The changes of a Keep that still wait to be applied, as a short token. null when nothing waits.
Fields
Whether the demo was kept before this request.
When billing starts, the next full hour after the Keep. null when the demo was kept already. Format: date-time.
Format: date-time.
Whether the Keep brought back a site that had been paused when its demo ended.
Whether a restored site's staging environment is being made again.
nonestartedrefusedWhere each change a Keep asked for stands. They are applied one at a time, in the order listed. It is not the shared ProgressStage: a change has a plan and a kind in place of a key and a label, and the times of its start and its end.
Fields
Fields of each item
Format: date-time.
A package, a server type, or add-on units.
packagefamilyaddonsThe operation that applies the change, once it has started. Follow it with GET /. A CoreCluster's server type change has none. At least 1.
The change as a short token, such as cs8 or cores2.
Format: date-time.
waitingapplyingdonefailedstartedThe changes still waiting, as a short token such as cores2. null when nothing waits.
none when the Keep asked for no change, applying while any change waits or runs, done when every one landed, failed when one did not (the kept price stands), started when a change started and there is nothing to follow it by.
noneapplyingdonefailedstartedThe first change the Keep asked for.
Fields
Only when a CoreCluster's server type change started. It has no operation of its own.
Fields
generaloptimisedThe ids of the queued moves, one for each site of the cluster.
Why the change was refused.
The changes still waiting, as a short token.
The operation that applies the change. Follow it with GET /. At least 1.
The refusal's code, or why the change is queued. Absent when no change was asked.
none when no change was asked, started (the answer is 202), queued when it waits because the site or cluster is busy, refused when it could not be applied; the demo is kept either way.
nonestartedqueuedrefusedFields of the 202 answer
Fields
Whole days until the demo ends. null unless the demo is active.
Format: date-time.
Until when an ended demo can still be kept. Format: date-time.
At least 1.
Fields
Whether you could keep it now.
Why you cannot keep it now, as Keep would refuse it. null when you can, while it is building, and once it is kept or closed.
The Keep page in the Control Panel. Format: uri.
Format: date-time.
The package the demo is on, such as CS4.
What it costs a month once kept as it is. null when it cannot be priced.
CS for a CoreStack site, CC for a CoreCluster.
The region's code, such as uk.
Format: date-time.
building while it is set up, active while it runs, ended once its time is up and it waits in its grace period, kept, or closed.
buildingactiveendedkeptclosedWhat the demo is of.
Fields
The site row's id or the CoreCluster's id. At least 1.
The site's domain or the cluster's name.
siteclusternullFields
The changes of a Keep that still wait to be applied, as a short token. null when nothing waits.
Fields
Whether the demo was kept before this request.
When billing starts, the next full hour after the Keep. null when the demo was kept already. Format: date-time.
Format: date-time.
Whether the Keep brought back a site that had been paused when its demo ended.
Whether a restored site's staging environment is being made again.
nonestartedrefusedWhere each change a Keep asked for stands. They are applied one at a time, in the order listed. It is not the shared ProgressStage: a change has a plan and a kind in place of a key and a label, and the times of its start and its end.
Fields
Fields of each item
Format: date-time.
A package, a server type, or add-on units.
packagefamilyaddonsThe operation that applies the change, once it has started. Follow it with GET /. A CoreCluster's server type change has none. At least 1.
The change as a short token, such as cs8 or cores2.
Format: date-time.
waitingapplyingdonefailedstartedThe changes still waiting, as a short token such as cores2. null when nothing waits.
none when the Keep asked for no change, applying while any change waits or runs, done when every one landed, failed when one did not (the kept price stands), started when a change started and there is nothing to follow it by.
noneapplyingdonefailedstartedThe first change the Keep asked for.
Fields
Only when a CoreCluster's server type change started. It has no operation of its own.
Fields
generaloptimisedThe ids of the queued moves, one for each site of the cluster.
Why the change was refused.
The changes still waiting, as a short token.
The operation that applies the change. Follow it with GET /. At least 1.
The refusal's code, or why the change is queued. Absent when no change was asked.
none when no change was asked, started (the answer is 202), queued when it waits because the site or cluster is busy, refused when it could not be applied; the demo is kept either way.
nonestartedqueuedrefusedIf 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_role | Keeping a demo needs the organisation's owner or a billing role. Ask the owner to keep it. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
403 | scope_required | Use a token with the scope named in scope. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | already_kept | The demo has already been kept. Nothing to do. |
409 | billing_details_required | Billing details are needed to keep the demo. Add them, then keep it. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | demo_building | The demo is still being set up. Keep it once it is ready. |
409 | demo_closed | The demo has ended and can no longer be kept. Start an order to carry on. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | payment_method_required | A payment method is needed to keep the demo. Add one, then keep it. |
422 | addon_bounds | An add-on quantity is outside what is allowed. Choose a whole number inside the range the message gives. |
422 | confirm_mismatch | Send the confirmation exactly as the field named in field asks for it. |
422 | invalid | Fix the field named in field; errors says why. |
422 | package_not_offered | The package chosen for the demo is not offered. Choose one that is. |
422 | package_platform | The package is not offered for the site's platform. Choose a package that is. |
422 | privacy_required | The privacy notice has not been accepted. Accept it to keep the demo. |
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/demos/3310/keep \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"accept_privacy": true,
"confirm_keep": "journal.harbourandfinch.example.com"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/demos/3310/keep', [
'accept_privacy' => true,
'confirm_keep' => 'journal.harbourandfinch.example.com',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/demos/3310/keep', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
accept_privacy: true,
confirm_keep: 'journal.harbourandfinch.example.com',
}),
});
// 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/demos/3310/keep",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"accept_privacy": True,
"confirm_keep": "journal.harbourandfinch.example.com",
},
)
data = res.json() if res.content else None{
"demo": {
"days_left": null,
"ends_at": "2026-12-06T09:00:00Z",
"grace_ends_at": null,
"id": 3310,
"keep": {
"allowed": false,
"refusal": null,
"url": "https://manage.corefinity.com/billing/keep?demo=3310&plan=keep"
},
"kept_at": "2026-11-09T10:15:00Z",
"package": "CS4",
"price_after": {
"amount": "300.00",
"currency": "GBP"
},
"product_line": "CS",
"region": "uk",
"starts_at": "2026-11-06T09:00:00Z",
"state": "kept",
"target": {
"id": 1051,
"name": "journal.harbourandfinch.example.com",
"type": "site"
},
"upgrade": {
"next": null
}
},
"kept": {
"already": false,
"billed_from": "2026-11-09T11:00:00Z",
"kept_at": "2026-11-09T10:15:00Z",
"restored": false,
"staging": "none"
},
"progress": {
"changes": [],
"next": null,
"state": "none"
},
"upgrade": {
"message": null,
"next": null,
"operation_id": null,
"state": "none"
}
}{
"demo": {
"days_left": null,
"ends_at": "2026-12-06T09:00:00Z",
"grace_ends_at": null,
"id": 3310,
"keep": {
"allowed": false,
"refusal": null,
"url": "https://manage.corefinity.com/billing/keep?demo=3310&plan=keep"
},
"kept_at": "2026-11-09T10:15:00Z",
"package": "CS4",
"price_after": {
"amount": "300.00",
"currency": "GBP"
},
"product_line": "CS",
"region": "uk",
"starts_at": "2026-11-06T09:00:00Z",
"state": "kept",
"target": {
"id": 1051,
"name": "journal.harbourandfinch.example.com",
"type": "site"
},
"upgrade": {
"next": null
}
},
"kept": {
"already": false,
"billed_from": "2026-11-09T11:00:00Z",
"kept_at": "2026-11-09T10:15:00Z",
"restored": false,
"staging": "none"
},
"progress": {
"changes": [
{
"ended_at": null,
"kind": "package",
"operation_id": 5120,
"plan": "cs8",
"started_at": "2026-11-09T10:15:00Z",
"state": "applying"
}
],
"next": null,
"state": "applying"
},
"upgrade": {
"message": null,
"next": null,
"operation_id": 5120,
"reason": null,
"state": "started"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "already_kept",
"message": "This site is already kept. Change it from its own page.",
"reason": "already_kept"
}{
"code": "addon_bounds",
"message": "GB of disk must be a whole number from 0 to 102400, in steps of 10.",
"reason": "addon_bounds"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt can add to your bill. Copy the request and run it yourself when you are sure.