---
title: "corestack_company_ssh_key_delete"
url: https://docs.corefinity.com/mcp/tools/corestack_company_ssh_key_delete
type: tool
last_updated: 2026-11-13
feature: ssh-keys
related:
  - https://docs.corefinity.com/guides/sites/access-and-security/ssh-keys.md
---
# corestack_company_ssh_key_delete

**Remove a company SSH key.** Remove a company SSH key from your company and from every site it reaches. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Confirmation: `confirm_fingerprint`
- Runs as a task: yes

## When to use it

Remove a company SSH key from your company and from every site it reaches.

## Inputs

- `key_id` (integer, ≥ 1, required)
- `confirm_fingerprint` (string, up to 100 characters; only while `ssh_keys` is on): Optional: the key's fingerprint exactly as corestack_company_ssh_key_list shows it (SHA256:…). When sent it must match.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_fingerprint": {
      "description": "Optional; when sent, must match the fingerprint corestack_company_ssh_key_list shows (SHA256:…).",
      "maxLength": 100,
      "type": "string"
    },
    "key_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "key_id"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role holds neither the Delete Company SSH Keys nor the Edit Company SSH Keys permission
  (either one removes a key). The message names both and says an owner of the company can grant them in Roles;
  `details.permission` is `deleteCompanySSHKeys`. Nothing is changed.
- `confirm_mismatch`: the typed fingerprint does not match; nothing changed. Leave the field out to skip the check.
- `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.
- 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_company_ssh_key_delete",
  "arguments": {
    "key_id": 314
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_ssh_key_delete with key_id 314. (Remove a company SSH key.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [SSH keys](https://docs.corefinity.com/guides/sites/access-and-security/ssh-keys.md)
