Skip to content

List saved SSH keys

GET /api/v2/ssh-keys

Lists the SSH public keys saved on your Hostup account, sorted by name. You pick from these keys when you order a VPS or add keys to a VPS with PATCH /api/v2/vps/{id}/ssh-access. Use data[].id (ssh_…) to name a key in those calls.

Web hosting accounts keep their own keys. Those are at GET /api/v2/shared-hosting/{accountId}/ssh-keys.

Authentication: An API key with the scope read:vm. About keys and scopes

Request

Query parameters

limitinteger
Keys per page, 1 to 100. Default 20. Other values return 400 invalid_pagination_limit. Default 20. 1 to 100.
cursorstring
The nextCursor value from the previous page.

Example

GET /api/v2/ssh-keys
curl "https://cloud.hostup.se/api/v2/ssh-keys" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 A page of saved SSH keys.

Response 200
{
"data": [
{
"id": "ssh_01hxa3b4c5d6e7f8g9h0j1k2m3",
"name": "deploy-key",
"publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIE9wZW5BUElFeGFtcGxlS2V5TWF0ZXJpYWwxMjM0 ops@example.com",
"fingerprint": "SHA256:8pQ3ExampleFingerprintForDocsOnly",
"keyType": "ed25519",
"createdAt": "2026-04-27T12:34:56.000Z",
"actions": {
"canRename": {
"allowed": true,
"reason": null
},
"canDelete": {
"allowed": true,
"reason": null
}
}
}
],
"hasMore": false,
"nextCursor": null
}
Response fields
dataarray of object
idstring
displayIdstring
An older display label on the SSH key list of a VPS. Use name and fingerprint instead.
namestring
publicKeystring
fingerprintstring or null
keyTypestring
One of rsa, ed25519, ecdsa, dsa, unknown.
createdAtstring or null
lastUsedAtstring or null
When the key was last used. Present only on the SSH key list of a VPS, when known.
actionsobject
Present on the account’s SSH key list.
canRenameobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canDeleteobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
hasMoreboolean
nextCursorstring or null

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.