CorefinityCorefinityDocs
Open the Control PanelControl Panel
Demos · 3 of 3

corestack_demo_keep

Keep a demo.

Scope writeAsks you to confirmRuns as a taskNo secrets returned
On this page

When to use it

Keep a demo: the site or cluster becomes the company's and is billed from the next full hour at price_after (corestack_demo_get). Ask the person first and type confirm_keep only once they agree: it is billable. Optionally keep it on a bigger package (package, one of upgrade_options), with Performance servers (family) or with add-ons (addons); each change starts right after Keep and is billed as for any customer once it applies. A started change is handed back as a task on its operation (a CoreCluster's server type: on its queued moves, as corecluster_compute_family_switch does); changes waiting behind it are listed in upgrade.next and start one after another. An answer that is not a task carries progress, and corestack_demo_get follows every change to its end. A second Keep answers the kept state. The same action as POST /api/corestack/demos/{id}/keep.

This tool never takes card details: a step the person finishes in the browser answers with keep_url to open. Two-factor is never one of them here: connecting this server already needs it.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_demo_keep with demo_id 31, package CS8. (Keep a demo.) Tell me what it returned.

Inputs

accept_privacyboolean

Only when the refusal is privacy_required and the person accepts the privacy notice.

addonsobject

Add-on unit totals: cores, memory_gb, disk_gb, log_storage_gb.

confirm_billing_countrystringConfirmation

The account's two-letter billing country, for example GB. Needed only when the demo's country was set by default and nobody has confirmed it yet (the refusal is billing_details_required and its message names the country). Tell the person which country it is and type it only once they agree it is the right one; to change it, they change it in the Control Panel first.

confirm_keepstringRequiredConfirmation

The site's domain, or the word cluster for a CoreCluster demo, typed to confirm. Up to 253 characters.

demo_idintegerRequired

The demo's id from corestack_demo_list. At least 1.

familystring

general (Standard servers) or optimised (Performance servers).

generaloptimised
packagestring

A bigger package of the same line, for example CS8 or CC16.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corestack_demo_keep",
  "arguments": {
    "demo_id": 31,
    "confirm_keep": "brightwater-studio.corestack.site",
    "package": "CS8"
  }
}

If it is refused

ReasonWhat to do
confirm_mismatchconfirm_keep is not the site's domain (or cluster); ask the person for the exact value.
demo_buildingThe demo is still being set up; keep it once it is ready.
demo_closedThe demo ended and its week to keep it is over; the company can start an order instead.
already_keptThe demo is already kept and a change was asked; change the site or cluster with its own tools.
forbidden_roleOnly the owner or a billing role can keep it; the message names who to ask. Corefinity staff never keep a customer's demo here.
billing_details_requiredThe billing details are incomplete (country and a billing name; the VAT number is optional, and an EU number applies the reverse charge); open keep_url. When the message asks to confirm the billing country (for example "Confirm your billing country (United Kingdom) to keep your site."), the demo set that country by default: once the person agrees it is right, call again with confirm_billing_country, or they confirm it on keep_url.
payment_method_requiredAdd a card or Direct Debit first; open keep_url (never pass card details here).
privacy_requiredAsk the person to accept the privacy notice, then call again with accept_privacy.
package_not_offeredThe package is not one of upgrade_options; choose one listed there.
package_platformThe package does not run this site's platform; choose a bigger one.
managed_elsewhereAnother control panel manages the demo's site, so use that control panel for it. This is refused before anything else about the demo, as in the Control Panel and the API: it was not kept and nothing was billed.
invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT