Vps
Virtual Machines
Deploy and manage virtual private servers with full control over your cloud infrastructure.
Virtual Machines
Deploy and manage virtual private servers with full control over your cloud infrastructure.
List VMs
GET /projects/{project}/products?detailed=true
Retrieve all virtual machines and other products in a project.
Path Parameters
| Name | Type | Description |
|---|---|---|
| project | string | Unique project identifier |
Query Parameters
| Name | Type | Description |
|---|---|---|
| detailed | boolean | Optional. Include detailed product information |
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | string | Bearer token for authentication |
Response
200 - Success
[
{
"uid": "vm_abc123",
"type": "vps",
"name": "Web Server 01",
"details": {
"ipv4": "192.121.119.100",
"ipv6": "2001:67c:bec:b::100/64",
"status": "online"
}
},
{
"uid": "vm_def456",
"type": "vps",
"name": "Database Server",
"details": {
"ipv4": "192.121.119.101",
"ipv6": "2001:67c:bec:b::101/64",
"status": "offline"
}
}
]
Create VM
POST /projects/{project}/products
Deploy a new virtual machine with your choice of operating system and specifications.
Path Parameters
| Name | Type | Description |
|---|---|---|
| project | string | Unique project identifier |
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | string | Bearer token for authentication |
Request Body
| Name | Type | Description |
|---|---|---|
| basket | array | Array of products to order |
| basket.product | string | Product type (vps) |
| basket.name | string | Display name for the VM |
| basket.type | string | Package type (CRA, Budget) |
| basket.package | string | Package name (Basic, Standard, etc.) |
| basket.os | string | Operating system (ubuntu, debian, centos, etc.) |
| basket.version | string | OS version (22.04, 11, 7, etc.) |
| basket.sshkeys | array | Optional. Array of SSH key UIDs |
Example Request:
{
"basket": [
{
"product": "vps",
"name": "Web Server 01",
"type": "CRA",
"package": "Basic",
"os": "ubuntu",
"version": "22.04",
"sshkeys": ["key_abc123"]
}
]
}
Response
200 - Success (Hourly Billing)
{
"success": true,
"products": [
{
"product": "vps",
"uid": "vm_abc123",
"name": "Basic VPS (Web Server 01)",
"sku": "vps_CRA_Basic",
"os": "ubuntu",
"version": "22.04",
"sshkeys": "ssh-rsa AAAAB3NzaC1yc2E..."
}
]
}
200 - Success (Subscription Billing)
{
"success": true,
"testMode": false,
"link": "https://mobilepay.dk/buy/..."
}
Get VM Details
GET /projects/{project}/products/{product}/vps
Retrieve comprehensive information about a specific virtual machine.
Path Parameters
| Name | Type | Description |
|---|---|---|
| project | string | Unique project identifier |
| product | string | Unique product/VM identifier |
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | string | Bearer token for authentication |
| Permission | string | READ_VPS |
Response
200 - Success
{
"uid": "vm_abc123",
"type": "vps",
"name": "Web Server 01",
"price": 49,
"created": "2025-01-01T00:00:00Z",
"showPassword": 1,
"status": "online",
"package": {
"type": "CRA",
"name": "Basic",
"vCores": 1,
"memory": 1024,
"storage": 25000
},
"ip": {
"ipv4": "192.121.119.100",
"ipv4Gateway": "192.121.119.1",
"ipv4PTR": null,
"ipv6": "2001:67c:bec:b::100/64",
"ipv6Gateway": "2001:67c:bec:b::1"
},
"os": {
"type": "linux",
"flavor": "ubuntu",
"version": "22.04"
},
"node": {
"datacenter": "Copenhagen",
"cluster": "ar5",
"node": "ar5-01"
}
}
Related Topics
- VM Management - Control VM power state and access console
- Networking - Manage IP addresses and PTR records
- Firewall - Configure firewall rules for your VMs
- Advanced Operations - Rebuild, resize, or delete VMs
- Projects - Manage the projects that contain your VMs