Manage SSH keys for your web hosting account.

Add and manage SSH keys for your web hosting account. This is useful for connecting to your server via SSH for advanced management or file transfer.

Web Hosting Services Hosting Accounts

Context

Where to get IDs / values

path.accountId

GET /api/hosting-accounts

Related endpoints

GET /api/hosting/{accountId}/ssh-keys Retrieve SSH keys for your web hosting account. POST /api/hosting/{accountId}/ssh-keys/authorize Authorize SSH key for cPanel account GET /api/hosting/{accountId}/php Get and display available PHP versions for hosting

Path Parameters

accountId integer · min: 1 required Example: 20000

Unique account identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

name string required · Example: hostup-agent-3104-20260117140747

publicKey string required · Example: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEVYQU1QTEVfU1NIX0tFWV9EQVRBX09OTFk example@hostup

Responses

200

data object required

data.accountId string required · Example: 20000

data.authorized boolean required · Example: true

data.cpanelUsername string required · Example: xkqjm

data.imported boolean required · Example: true

data.name string required · Example: hostup-agent-3104-20260117140747

data.note string required · Example: SSH key imported and authorized - ready for use immediately

data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

400

code string required · Example: BAD_REQUEST

Machine-readable error code.

error string required · Example: Bad Request

HTTP status title (e.g. 'Bad Request').

message string required · Example: Invalid input detected

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/hosting/{accountId}/ssh-keys

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/hosting/20000/ssh-keys" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "hostup-agent-3104-20260117140747",
    "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEVYQU1QTEVfU1NIX0tFWV9EQVRBX09OTFk example@hostup"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "accountId": "20000",
    "cpanelUsername": "xkqjm",
    "name": "hostup-agent-3104-20260117140747",
    "imported": true,
    "authorized": true,
    "note": "SSH key imported and authorized - ready for use immediately"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "accountId": {
          "type": "string"
        },
        "authorized": {
          "type": "boolean"
        },
        "cpanelUsername": {
          "type": "string"
        },
        "imported": {
          "type": "boolean"
        },
        "name": {
          "type": "string"
        },
        "note": {
          "type": "string"
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "name": "hostup-agent-3104-20260117140747",
  "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEVYQU1QTEVfU1NIX0tFWV9EQVRBX09OTFk example@hostup"
}