---
title: "corestack_enterprise_copy_create"
url: https://docs.corefinity.com/mcp/tools/corestack_enterprise_copy_create
type: tool
last_updated: 2026-11-13
feature: enterprise-copies
related:
  - https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md
---
# corestack_enterprise_copy_create

**Copy a CoreStack Enterprise environment.** Copy a CoreStack Enterprise environment's files and database into one of your protected CoreCluster sites, replacing what the site holds. Nothing is written on the environment. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Confirmation: `confirm_target_site`
- Runs as a task: yes

## 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.

## Inputs

- `enterprise_env_id` (integer, 1 to 2147483647, required): the CoreStack Enterprise environment to copy from.
- `target_site_id` (integer, 1 to 2147483647, required): the CoreCluster site to copy into.
- `confirm_target_site` (string, required): the site's name, as the preview's `confirm`.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_target_site": {
      "description": "The site's name, as the preview's confirm, typed once the person agreed.",
      "maxLength": 253,
      "type": "string"
    },
    "enterprise_env_id": {
      "description": "The CoreStack Enterprise environment to copy from.",
      "maximum": 2147483647,
      "minimum": 1,
      "type": "integer"
    },
    "target_site_id": {
      "description": "A protected site on one of your CoreClusters to copy into.",
      "maximum": 2147483647,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "enterprise_env_id",
    "target_site_id",
    "confirm_target_site"
  ],
  "type": "object"
}
```

## Refusals

- 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`, …).
- `confirm_mismatch` (field `confirm_target_site`): the name typed is not the site's.
- `managed_elsewhere`: the site is managed by another control panel.
- `tenant_mismatch`: the environment or the site does not exist or is not yours to copy, or the environment was deleted.
- `pin_refused` (`company_write`): a token limited to some sites cannot reach a CoreStack Enterprise environment.
- `rate_limited`: 5 copy changes a minute, shared with the public API.
- and the refusals every tool can answer: `scope_required`, `invalid_arguments`, `temporarily_unavailable`,
  `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_enterprise_copy_create",
  "arguments": {
    "enterprise_env_id": 1530,
    "target_site_id": 217,
    "confirm_target_site": "c32-s217"
  }
}
```

## Prompt

```text
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.
```

## The same task elsewhere

- Guide: [Websites and environments](https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md)
