corestack_ ssh_ key_ update
Change an SSH public key.
When to use it
Rename a key, or change which environments a company or website key applies to. Removing environments needs confirm_fingerprint, typed exactly as corestack_ssh_keys_list shows it; a rename or a widening needs none. Long-running when it changes where the key works.
Ask for it
Using the Corefinity MCP server, call corestack_ssh_key_update with key_id 70120, name Deploy key (CI). (Change an SSH public key.) Tell me what it returned.Inputs
applies_toobject
{mode: all} or {mode: selected, environment_ids}.
Fields
environment_idsarray of integers
Up to 500 items.
modestringRequired
allselectedconfirm_fingerprintstringConfirmation
Required when applies_to removes environments — the key's SHA256: fingerprint. Up to 60 characters.
key_idintegerRequired
At least 1.
namestring
A name you will recognise the key by (at most 100 characters).
Your assistant fills in a confirmation only after you agree.
Example call
{
"name": "corestack_ssh_key_update",
"arguments": {
"key_id": 70120,
"name": "Deploy key (CI)"
}
}If it is refused
| Reason | What to do |
|---|---|
managed_elsewhere | 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 | A company's key and 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. |
switched_off | SSH keys are not switched on for this object yet. |
confirm_mismatch | The typed fingerprint is not this key's. |
ssh_managed_on_another_environment | This CoreStack Enterprise environment runs on the same server as another environment whose SSH the Control Panel manages, so its own keys are added, changed and removed there; the refusal's managed_on names that environment ({id, name}). |
enterprise_panel_only | SSH keys for CoreStack Enterprise environments are managed in the Control Panel only at the moment. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |
The same task elsewhere
Was this helpful?