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
limitintegerKeys per page, 1 to 100. Default 20. Other values return 400
invalid_pagination_limit. Default 20. 1 to 100.cursorstringThe
nextCursor value from the previous page.Example
curl "https://cloud.hostup.se/api/v2/ssh-keys" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 A page of saved SSH keys.
{ "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 objectidstringdisplayIdstringAn older display label on the SSH key list of a VPS. Use
name and fingerprint instead.namestringpublicKeystringfingerprintstring or nullkeyTypestringOne of
rsa, ed25519, ecdsa, dsa, unknown.createdAtstring or nulllastUsedAtstring or nullWhen the key was last used. Present only on the SSH key list of a VPS, when known.
actionsobjectPresent on the account’s SSH key list.
canRenameobjectallowedbooleanreasonstring or nullcodestring or nullA machine-readable code for why the action is blocked.
canDeleteobjectallowedbooleanreasonstring or nullcodestring or nullA machine-readable code for why the action is blocked.
hasMorebooleannextCursorstring or nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |