---
title: "corestack_company_ssh_key_update"
url: https://docs.corefinity.com/mcp/tools/corestack_company_ssh_key_update
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_update

**Change a company SSH key.** Rename a company SSH key or change the sites it reaches ("all" or a list of site ids). Scope: write. Long-running: answers with a task.

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

## When to use it

Rename a company SSH key or change the sites it reaches ("all" or a list of site ids).

While `ssh_keys` is on, "all" means every CoreStack and CoreCluster site of your company: never a CoreStack Enterprise site or one of your clients' sites.

## Inputs

- `key_id` (integer, ≥ 1, required)
- `name` (string, 1–255 characters)
- `sites` (one of `all` or array of integer, ≥ 1, up to 500 items): "all", or a list of site ids.
- `confirm_fingerprint` (string, up to 100 characters; only while `ssh_keys` is on): Optional, for a change that removes sites: 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, for a change that removes sites; when sent, must match the fingerprint corestack_company_ssh_key_list shows (SHA256:…).",
      "maxLength": 100,
      "type": "string"
    },
    "key_id": {
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "sites": {
      "anyOf": [
        {
          "enum": [
            "all"
          ],
          "type": "string"
        },
        {
          "items": {
            "minimum": 1,
            "type": "integer"
          },
          "maxItems": 500,
          "type": "array"
        }
      ],
      "description": "\"all\", or a list of site ids."
    }
  },
  "required": [
    "key_id"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role lacks the Edit Company SSH Keys permission. The message names it and says an owner of
  the company can grant it in Roles; `details.permission` is `editCompanySSHKeys`. Nothing is changed.
- `confirm_mismatch`: the typed fingerprint does not match; nothing changed. Leave the field out to skip the check.
- `invalid_arguments` for `sites: []` while `ssh_keys` is on: a company key reaches at least one site; to stop it reaching every site, delete it.
- `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_update",
  "arguments": {
    "key_id": 314
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_ssh_key_update with key_id 314. (Change 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)
