ssh-keys

Delete Key

Remove a registered key.

Deleting the last remaining key requires ?confirm=last-key — without it, the OS user would be left with no way back in over SSH. Enforced inside :meth:~palmimo_portal.ports.SshKeyPort.delete_key itself, not by a separate list_keys pre-check here, so two concurrent deletes cannot each observe two keys and both proceed, together emptying the file.

Raises: PortalError: 404 key_not_found if no key has that fingerprint; 409 last_key_deletion_requires_confirmation if it is the last key and confirm was not given; 409 ssh_keys_busy if the authorized_keys lock could not be acquired in time (a concurrent add/delete holding it past :data:~palmimo_portal.adapters.ssh_keys.SSH_KEYS_LOCK_TIMEOUT_SECONDS).

delete/api/v1/ssh-keys/{fingerprint}

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

fingerprintstring required

Query parameters

confirmstring nullable

Response

Successful Response

statusstring

Changes

No recorded changes to this operation across all 8 revisions of this API.