Add SSH key

POST

/vps/ssh-keys

Store an SSH public key on your account so it can be installed on a VPS at create or reinstall time.

Send a single-line OpenSSH public key (ssh-rsa, ssh-dss, ssh-ed25519 or ecdsa-sha2-nistp256/384/521). Never send a private key. A key you already stored is rejected as a duplicate, matched on its SHA256 fingerprint.

Adding a key does not touch machines that are already running; it is applied the next time a VPS is created or reinstalled.

Request

Authorization

API Key

Add parameter in header

API-key

Example:

API-key: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "name": "laptop",
    "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... user@laptop"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/vps/ssh-keys' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "laptop",
    "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... user@laptop"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "SSH key added",
    "data": {
        "id": 1000,
        "fingerprint": "oJAI9qSVVDuZVJ9K+wsrvngmE+ewwK+TjIxS9i9IMyA"
    }
}

🟠400Not a valid public key

🟠400Key already stored

🟠400Wrong request method

🟠400SSL connection is required

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-09-01 15:44:15

List SSH keys

Delete SSH key