---
title: "corestack_queued_copy_cancel"
url: https://docs.corefinity.com/mcp/tools/corestack_queued_copy_cancel
type: tool
last_updated: 2026-11-13
feature: copies
related:
  - https://docs.corefinity.com/api/reference/environments/cancel-queued-copy.md
  - https://docs.corefinity.com/guides/sites/environments-and-copies/clone-a-site.md
---
# corestack_queued_copy_cancel

**Cancel a queued copy.** Cancel a copy that is waiting its turn, before it starts. corestack_environment_list gives the ids in queued_copies. Scope: write.

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

## When to use it

Cancel a copy that is waiting its turn, before it starts. corestack_environment_list gives the ids in queued_copies.

A copy that would only have to wait is queued and starts on its own (see corestack_site_clone). corestack_environment_list lists the copies waiting onto a site's environments in `queued_copies`, however they were queued: in the Control Panel, through the public API or by an MCP client. This cancels any of them while it still waits, onto an environment the person may change. A copy your grant queued can also be cancelled with its task (tasks/cancel, or corestack_task_cancel). Nothing is copied and nothing on the environments changes. Once the copy has started it runs to its end.

It answers `queued`, the copy as corestack_environment_list lists it, now with `state` `cancelled` and `message` "Cancelled before it started.". `source` is null when the person may not see the environment it copies from, or your pins do not cover it, and `message` then calls it "the environment it copies from".

## Inputs

- `queued_id` (integer, ≥ 1, required): The queued copy's id from corestack_environment_list (queued_copies[].id).

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "queued_id": {
      "description": "The queued copy's id from corestack_environment_list (queued_copies[].id).",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "queued_id"
  ],
  "type": "object"
}
```

## Refusals

- `not_waiting` (message: "This copy is no longer waiting, so it cannot be cancelled."): the copy has already started, is starting now, or has ended (cancelled, refused or expired). `details.queued` shows where it stands: follow a started copy with corestack_site_operation_get (`operation_id`). Nothing was cancelled.
- `tenant_mismatch`: there is no such queued copy, or it copies onto an environment the person may not change.
- `pin_refused`: your pins do not cover the environment the copy is onto.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages the site the copy is onto, so use that control panel for it. This is refused before anything else about the site. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_queued_copy_cancel",
  "arguments": {
    "queued_id": 812
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_queued_copy_cancel with queued_id 812. (Cancel a queued copy.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [DELETE /api/corestack/copy-queue/{queued}](https://docs.corefinity.com/api/reference/environments/cancel-queued-copy.md)
- Guide: [Clone an environment](https://docs.corefinity.com/guides/sites/environments-and-copies/clone-a-site.md)
