Get available templates for installing on your VM

List all operating systems and pre-configured templates available for your virtual machine (VM). This is useful when you want to reinstall your server or set up a new one. The endpoint returns template IDs that can be used to call POST /api/vm/{vmid}/rebuild.

VPS Services Rebuild & Templates

Context

Where to get IDs / values

Workflow links

Produces

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.templates array<object> required · Example: [{"id":"91459aa5-a500-31c0-05ca-aa0280ff6c0c","selected":false,"name":"Debian 13 (3GB)"...
data.templates[].group string required · Example: Public
data.templates[].id string required · Example: 91459aa5-a500-31c0-05ca-aa0280ff6c0c
data.templates[].name string required · Example: Debian 13 (3GB)
data.templates[].selected boolean required · Example: false
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).

GET https://cloud.hostup.se/api/vm/{vmid}/templates
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/templates" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "templates": [
      {
        "id": "91459aa5-a500-31c0-05ca-aa0280ff6c0c",
        "selected": false,
        "name": "Debian 13 (3GB)",
        "group": "Public"
      },
      {
        "id": "629f6170-9286-7cf5-2507-7fa27d59ab03",
        "selected": false,
        "name": "Debian 12 (2GB)",
        "group": "Public"
      },
      {
        "_truncated": "... and 17 more items"
      }
    ]
  }
}