---
title: "corestack_deployment_stop"
url: https://docs.corefinity.com/mcp/tools/corestack_deployment_stop
type: tool
last_updated: 2026-11-13
feature: deployments
related:
  - https://docs.corefinity.com/api/reference/deployments/cancel-site-deployment.md
  - https://docs.corefinity.com/guides/sites/code-and-deployments/connect-a-repository.md
---
# corestack_deployment_stop

**Stop a deployment.** Stop a deployment that is queued or running. Scope: write.

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

## When to use it

Stop a deployment that is queued or running. Where Stop termination is enabled for the environment, a running step's
commands are ended on the servers it used as well as on the Control Panel; a step that could not be confirmed ended is
reported on the deployment and staff are alerted — read it on the site's deployments (`corestack_deployments_get`, in
the row's `stop_termination`) or, for a CoreStack Enterprise environment, on `corestack_enterprise_deployment_get`
(`view.stop_termination`). The page shows the same sentence.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `deployment_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "deployment_id": {
      "minimum": 1,
      "type": "integer"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "deployment_id"
  ],
  "type": "object"
}
```

## Refusals

- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- `forbidden`: the person's role lacks the Stop Deployments permission. The message names it and says an owner of the
  company can grant it in Roles; `details.permission` is `stopDeployments`. Nothing is changed.
- 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_deployment_stop",
  "arguments": {
    "site_id": 4211,
    "deployment_id": 6610
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployment_stop with site_id 4211, deployment_id 6610. (Stop a deployment.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/deployments/{deployment}/stop](https://docs.corefinity.com/api/reference/deployments/cancel-site-deployment.md)
- Guide: [Connect a repository](https://docs.corefinity.com/guides/sites/code-and-deployments/connect-a-repository.md)
