We are excited to announce that our Virtual Server API is now available in beta!
During this phase, you can deploy and manage virtual servers entirely through our API — fast, simple, and cost-effective.
Be an early adopter, shape the future of our platform, and lock in beta-phase savings before public launch.
Join the Beta NowTo create a new virtual server in a specific datacenter, you must provide three parameters in the request body.
| Field | Type | Description | Example Value | 
|---|---|---|---|
| datacenter | Integer | ID of the datacenter. Get it from GET /v1/datacenters. | 1 | 
| article | Integer | Pricing/article ID for the server type. Get it from GET /v1/prices/server_virtual. | 81 | 
| os | Integer | Operating system ID. Get it from GET /v1/server/virtual/operating_systems. | 2 | 
curl -X GET https://api.ip6.cloud/v1/datacenters \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"curl -X GET https://api.ip6.cloud/v1/prices/server_virtual \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"curl -X GET https://api.ip6.cloud/v1/server/virtual/operating_systems \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"curl -X POST https://api.ip6.cloud/v1/server/virtual \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"datacenter": 1,
"article": 81,
"os": 2
}'{
  "message": "This task is being processed in the background.",
  "status": "accepted",
  "task_id": "51"
}Your server creation request has been accepted and is processing asynchronously. Use the task_id to track progress.
{
  "error": {
    "code": "unprocessable_entity",
    "message": "unavailable in this datacenter",
    "details": []
  }
}If you see this, choose a different datacenter, article, or OS combination that is valid.