The OMC Cloud API is RESTful and works with any HTTP client in any language. Authenticate with your client ID and secret, then call any endpoint.
https://console.omc.cloud/serviceGenerate your API credentials in your OMC Cloud dashboard under Settings → API Keys. You'll receive a clientId and secret.
You can authenticate requests in two ways:
curl https://console.omc.cloud/service/servers
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"First, exchange credentials for a 1-hour token:
curl -X POST https://console.omc.cloud/service/authenticate
-H "Content-Type: application/json"
-d '{"clientId":"YOUR_CLIENT_ID","secret":"YOUR_SECRET"}'Response:
{
"authentication": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"expires": 1745393200
}Then use the token in subsequent requests:
curl https://console.omc.cloud/service/servers
-H "Content-Type: application/json"
-H "authorization: YOUR_TOKEN"/serversReturns an array of all servers in your account with their ID, datacenter, name, and power state.
curl https://console.omc.cloud/service/servers
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"import requests
url = "https://console.omc.cloud/service/servers"
headers = {
'Content-Type': 'application/json',
'clientId': 'YOUR_CLIENT_ID',
'secret': 'YOUR_SECRET',
}
response = requests.get(url, headers=headers)
print(response.json())/serverReturns the full list of available datacenters, CPU types, RAM sizes, disk options, OS templates, traffic packages, networks, and billing types you can use when creating a new server.
curl https://console.omc.cloud/service/server
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/serverProvisions a new virtual server with the specified configuration. Returns a task ID you can poll for completion.
disk_src_0 — OS image IDdatacenter — Location codename — Server name (4-40 chars, alphanumeric + ./-/_)cpu — CPU type and count (e.g., 1B, 2D)ram — Memory in MBpassword — 9-32 chars, mixed case + numericbilling — monthly or hourlytraffic — Traffic package ID (e.g., t5000)disk_size_0 — Disk size in GBnetwork_name_0 — Network name (use wan for auto IP)managed — Enable managed servicesbackup — Enable daily backupspower — Auto-boot on completionselectedSSHKeyValue — Public SSH keynetwork_ip_0 — Specific IP (optional with WAN)curl -X POST https://console.omc.cloud/service/server
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{
"disk_src_0": "IL:XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"datacenter": "IL-TLV",
"name": "my-production-server",
"cpu": "2B",
"ram": "4096",
"password": "YourSecurePass123",
"network_name_0": "wan",
"billing": "monthly",
"traffic": "t5000",
"disk_size_0": "40"
}'/server/cloneDuplicates an existing server including its OS, software, configuration, and data. Returns a task ID.
Required: source (UUID), name, password, billing
curl -X POST https://console.omc.cloud/service/server/clone
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{
"source": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "server-clone",
"password": "YourSecurePass123",
"billing": "monthly"
}'/server/{serverid}Returns full information about a specific server: ID, datacenter, CPU, RAM, power state, disks, networks (with IPs), billing type, traffic package, managed status, backup status.
curl https://console.omc.cloud/service/server/SERVER_UUID
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/server/{serverid}/terminatePermanently removes a server. This action is irreversible. Required body: confirm=1. If the server is powered on, also pass force=1.
curl -X DELETE https://console.omc.cloud/service/server/SERVER_UUID/terminate
-H "Content-Type: application/x-www-form-urlencoded"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d 'confirm=1&force=1'/server/{serverid}/powerPower a server on, off, or restart it. Send power=on, power=off, or power=restart as form data. Returns a task ID.
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/power
-H "Content-Type: application/x-www-form-urlencoded"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d 'power=on'/server/{serverid}/cpuReturns CPU configurations the server can be resized to (A, B, T, D types with vCPU counts up to 104).
/server/{serverid}/cpuResize the server's CPU. Send cpu=2B as form data.
/server/{serverid}/ramReturns RAM sizes in MB available for each CPU type.
/server/{serverid}/ramResize the server's RAM. Send ram=4096 as form data (size in MB).
/server/{serverid}/diskReturns the array of disk sizes in GB you can resize to.
/server/{serverid}/diskResize an existing hard disk. Send JSON: {"size":"40","index":"0","provision":"1"}
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/disk
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{"size":"40","index":"0","provision":"1"}'/server/{serverid}/diskAdd an additional hard disk to the server. Send size=20&provision=1 as form data.
/server/{serverid}/disk/removePermanently delete a disk. Send index=1&confirm=1 as form data. Data loss is permanent.
/server/{serverid}/snapshotsReturns an array of all snapshots for the server with ID, name, date, active status, and depth.
/server/{serverid}/snapshotCreate a point-in-time snapshot of the server. Send name=my-snapshot.
/server/{serverid}/snapshotRestore the server to a previous snapshot. Send snapshotId=1745411375.
/server/{serverid}/snapshotRemove a snapshot. Send snapshotId=1745411375.
/server/{serverid}/renameChange the server's name. Send name=new-server-name. Constraints: 4-40 characters, letters/numbers/dots/dashes/underscores.
/server/{serverid}/passwordUpdate the server's root password. Send password=NewSecurePass123. Constraints: 9-32 chars, mixed case + numeric.
/server/{serverid}/billingReturns the active and future billing mode for the server.
/server/{serverid}/billingSwitch between monthly and hourly billing. Send type=monthly&traffic=t5000.
/server/{serverid}/hdlibReturns an array of disk objects with UUID and size in GB, available for cloning.
/server/{serverid}/hdlibCreate a new disk from a library source. Send disk_name_0=cloned-disk&disk_src_0=DISK_UUID.
The OMC Cloud API is REST-based and works with any HTTP client. For convenience, you can also use:
requests libraryfetch, axios, or node-fetchcURL or GuzzleThe API uses standard HTTP status codes:
200 OK — Successful request400 Bad Request — Invalid parameters or malformed request401 Unauthorized — Missing or invalid credentials403 Forbidden — Authentication succeeded but permission denied404 Not Found — Resource doesn't exist500 Internal Server Error — Server-side issue (please contact support)Most successful operations return a task ID you can use to track async progress. All requests must be sent over HTTPS.
Generate your API credentials in the OMC Cloud dashboard and start automating in minutes.
Get API Credentials →Join the tens of thousands of customers who rely on OMC every day
By signing up you agree to the terms of service
קבל הצעת מחיר מותאמת אישית בחצי שעה הקרובה
By signing up you agree to the terms of service