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

**Remove an SSH key.** Remove a public key from an SSH user of the environment. Company keys are removed with corestack_company_ssh_key_delete. Scope: write. Long-running: answers with a task.

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

## When to use it

Remove a public key from an SSH user of the environment. Company keys are removed with corestack_company_ssh_key_delete.

While `ssh_keys` is on, the `web` user's key ids are the ones corestack_ssh_access_get lists: an environment-level key is removed here and the task follows its SSH change; a key added at the website, company, agency or personal level, or under Legacy review, is managed where it was added (`in_use`).

## 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_ssh_access_get 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_ssh_access_get shows (SHA256:…).",
      "maxLength": 100,
      "type": "string"
    },
    "key_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "key_id"
  ],
  "type": "object"
}
```

## Refusals

- `in_use`: it is still in use or still being removed; wait, or remove what uses it first.
- `confirm_mismatch`: the typed fingerprint does not match; nothing changed. Leave the field out to skip the check.
- `ssh_person_managed_elsewhere`: the key belongs to a person's own SSH login, managed in their profile (while `ssh_keys` is on).
- `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_ssh_user_key_delete",
  "arguments": {
    "key_id": 314
  }
}
```

## Prompt

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

## The same task elsewhere

- Guide: [Connection details](https://docs.corefinity.com/guides/sites/access-and-security/connection-details.md)
