CorefinityCorefinityDocs
Open the Control PanelControl Panel
Clones and copies · 4 of 8

corestack_enterprise_copy_preview

Preview a CoreStack Enterprise copy.

Scope readNo secrets returned
On this page

When to use it

Before copying a CoreStack Enterprise environment into one of your CoreCluster sites, ask what the copy would meet. The answer names the environment (its platform, versions and measured size), the site it would land in, every reason it cannot be copied now (blockers, the first being the one a create would refuse with), anything worth knowing (warnings), and confirm: the site's name, which the create and the re-sync take as confirm_target_site. Nothing is written, on the environment or the site.

A copy lands only in an existing site of the same company as the environment, on one of its own CoreClusters (never a CoreStack platform cluster): ready, of the same platform, with crons off, no domain attached, no sending domain of its own, and protected by HTTP authentication over the whole environment (an enabled rule for /, with a user, opening no path). Copied data is never public and never sends email.

The public API's GET /api/enterprise-copies/preview?enterprise_env_id=…&target_site_id=… answers the same.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_enterprise_copy_preview with enterprise_env_id 1530, target_site_id 217. (Preview a CoreStack Enterprise copy.) Tell me what it returned.

Inputs

enterprise_env_idintegerRequired

The CoreStack Enterprise environment to copy from. 1 to 2147483647.

target_site_idintegerRequired

The CoreCluster site to copy into. 1 to 2147483647.

Example call

tools/call
{
  "name": "corestack_enterprise_copy_preview",
  "arguments": {
    "enterprise_env_id": 1530,
    "target_site_id": 217
  }
}

If it is refused

ReasonWhat to do
tenant_mismatchThe environment or the site does not exist or is not yours to copy, or the environment was deleted (an agency acting for a client cannot copy into the client's CoreCluster sites).
pin_refusedA token limited to some sites cannot reach a CoreStack Enterprise environment.
rate_limitedPreviews read the environment, so they have their own budget (10 a minute, shared with the public API).
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
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.
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.
other_companyThe site belongs to another organisation than the environment. Copy into a site of the environment's own organisation.
platform_clusterThe cluster is the CoreStack platform, which has no settings or sites of its own to change this way. Change or create the site itself instead.
target_not_readyThe site to copy into is not ready to take a copy. Read the message: wait until it is ready, or choose another site.
target_liveThe site to copy into has a domain attached, and a copy never overwrites a live site. Choose a site that is not live.
target_sends_mailThe site to copy into sends email through its own sending domain, and a copy must never send email. Choose another site.
platform_mismatchThe site and the environment run different platforms. Copy into a site of the same platform.
target_unprotectedThe site to copy into is not protected by HTTP authentication over the whole environment. Protect it first: copied data must never be public.
target_crons_onThe site to copy into has its scheduled tasks on. Switch them off before copying into it.
copy_existsThe target already has an unfinished copy. Finish or re-sync that one.
target_busyThe environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again.
target_movingThe site to copy into is part of an environment move. Copy into it once the move is settled.
source_movingThe environment has a move open, or has moved to CoreStack. Copy it once the move is settled, or copy from its new site.
target_too_smallSee how this server works.
source_unsupportedSee how this server works.
ssh_unreachableSee how this server works.
no_mail_neutraliserCopies of sites of this platform are not available: their email cannot be switched off on the copy. Contact support.

The preview itself refuses only when the environment or the site is not one you can reach:

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT