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

corestack_enterprise_copy_create

Copy a CoreStack Enterprise environment.

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

When to use it

Copy a CoreStack Enterprise environment's files and database into one of your protected CoreCluster sites. The copy replaces everything the site holds; nothing is written on the environment, and nothing is switched over: no DNS, no go-live, no billing change. Run corestack_enterprise_copy_preview first, show the person what it says, and type the preview's confirm back as confirm_target_site only once they have agreed that the site's files and database are replaced.

The copy runs as a task; follow it with corestack_enterprise_copy_get (or tasks/get). When its run ends, the site holds a copy with its email and payments switched off and its production marker removed, still protected and with its crons off. Copy again with corestack_enterprise_copy_resync, and end it with corestack_enterprise_copy_finish.

The public API's POST /api/enterprise-copies does the same.

Ask for it

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

Inputs

confirm_target_sitestringRequiredConfirmation

The site's name, as the preview's confirm, typed once the person agreed. Up to 253 characters.

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.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corestack_enterprise_copy_create",
  "arguments": {
    "enterprise_env_id": 1530,
    "target_site_id": 217,
    "confirm_target_site": "c32-s217"
  }
}

If it is refused

ReasonWhat to do
confirm_mismatchThe name typed is not the site's.
managed_elsewhereThe site is managed by another control panel.
tenant_mismatchThe environment or the site does not exist or is not yours to copy, or the environment was deleted.
pin_refusedA token limited to some sites cannot reach a CoreStack Enterprise environment.
rate_limited5 copy changes 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.
  • The preview's first blocker, by its reason: other_company, platform_cluster, target_not_ready, target_live, target_sends_mail, platform_mismatch, target_unprotected, target_crons_on, copy_exists (one copy at a time per site: re-sync or finish it), target_busy, target_moving, source_moving, target_too_small, source_unsupported, ssh_unreachable, no_mail_neutraliser, and the site's own change gate (busy, restore_running, …).

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT