---
title: "corestack_deployments_company_variable_delete"
url: https://docs.corefinity.com/mcp/tools/corestack_deployments_company_variable_delete
type: tool
last_updated: 2026-11-13
feature: deployment-templates
related:
  - https://docs.corefinity.com/api/reference/deployments/delete-company-deploy-variable.md
  - https://docs.corefinity.com/guides/sites/code-and-deployments/deployment-templates.md
---
# corestack_deployments_company_variable_delete

**Delete a company deployment variable.** Delete one of your company's deployment variables. Environments that do not set the name themselves then receive no value: corestack_deployments_company_variables_list says how many use it. Scope: write.

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

## When to use it

Delete one of your company's deployment variables. Environments that do not set the name themselves then receive no value: corestack_deployments_company_variables_list says how many use it. A token restricted to some sites cannot delete company variables.

The same action in the public REST API, with the same checks, refusals and scope: `DELETE /api/corestack/companies/{company}/deploy-variables/{name}`.

## Inputs

- `name` (string, matching `^[A-Za-z_][A-Za-z0-9_]{0,63}$`, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role lacks the Edit Environment Deployment Pipeline permission, which every change to the
  company's templates, variables and registry secrets needs (they reach every environment that follows the template). The
  message names it and says an owner of the company can grant it in Roles; `details.permission` is
  `editEnvironmentDeploymentPipeline`. 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_deployments_company_variable_delete",
  "arguments": {
    "name": "SLACK_WEBHOOK"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployments_company_variable_delete with name SLACK_WEBHOOK. (Delete a company deployment variable.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [DELETE /api/corestack/companies/{company}/deploy-variables/{name}](https://docs.corefinity.com/api/reference/deployments/delete-company-deploy-variable.md)
- Guide: [Deployment templates](https://docs.corefinity.com/guides/sites/code-and-deployments/deployment-templates.md)
