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

**Finish a CoreStack Enterprise copy.** Mark a finished copy of a CoreStack Enterprise environment as done, leaving its CoreCluster site protected and unchanged. Scope: write.

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

## When to use it

End a copy once you no longer need to re-sync it. Finishing checks that the site is still protected, its crons are off,
no domain is attached and it has no sending domain of its own, and that the copy proved the site unactivated and its
data neutralised; it then records what was copied. Nothing is switched, attached, retired or billed: the site stays a
normal protected site, and going live with it is a separate step you take on the site itself. Nothing is replaced, so
there is no typed confirmation.

The public API's `POST /api/enterprise-copies/{copy}/finish` does the same.

## Inputs

- `copy_id` (integer, 1 to 2147483647, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "copy_id": {
      "maximum": 2147483647,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "copy_id"
  ],
  "type": "object"
}
```

## Refusals

- `copy_running`: the copy's run has not ended. `copy_ended`: it is already finished, superseded or failed.
- `copy_unchecked`: the copy's checks did not complete, so it cannot be finished; re-sync it.
- The site's guards: `target_live`, `target_sends_mail`, `target_unprotected`, `target_crons_on`.
- `managed_elsewhere`: the site is managed by another control panel.
- `tenant_mismatch`: the copy does not exist, its environment was deleted, or its environment or its site is not yours.
- `pin_refused` (`company_write`), `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_finish",
  "arguments": {
    "copy_id": 41
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_enterprise_copy_finish with copy_id 41. (Finish 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)
