---
title: "corestack_enterprise_copy_preview"
url: https://docs.corefinity.com/mcp/tools/corestack_enterprise_copy_preview
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_preview

**Preview a CoreStack Enterprise copy.** Check whether a CoreStack Enterprise environment can be copied into one of your protected CoreCluster sites, and what the copy would replace. Scope: read.

- Scope: `read`
- Runs as a task: no

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

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

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "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"
  ],
  "type": "object"
}
```

## Refusals

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

- `tenant_mismatch`: the 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_refused` (`company_write`): a token limited to some sites cannot reach a CoreStack Enterprise environment.
- `rate_limited`: previews read the environment, so they have their own budget (10 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).

Blockers carry the reason a create would answer: `other_company` (the site belongs to another company than the
environment), `platform_cluster`, `target_not_ready`, `target_live`, `target_sends_mail`, `platform_mismatch`,
`target_unprotected`, `target_crons_on`, `copy_exists`, `target_busy`, `target_moving`, `source_moving`,
`target_too_small`, `source_unsupported`, `ssh_unreachable`, `no_mail_neutraliser`.

## Example

```json
{
  "name": "corestack_enterprise_copy_preview",
  "arguments": {
    "enterprise_env_id": 1530,
    "target_site_id": 217
  }
}
```

## Prompt

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

## The same task elsewhere

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