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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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: Bearer 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET"import requests
url = "https://console.omc.cloud/service/servers"
headers = {
'Content-Type': 'application/json',
'AuthClientId': 'YOUR_CLIENT_ID',
'AuthSecret': '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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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 "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: 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.
/server/options/datacentersReturns an array of the data centers you can deploy to, each with its id (the code you pass in the datacenter field when creating a server) and region. For the full set of creation options per data center (CPU types, RAM, disk sizes, OS images, traffic packages, networks) use GET /server above.
curl https://console.omc.cloud/service/server/options/datacenters \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET"/queue/{taskid}Every operation that changes a server (create, clone, power, CPU/RAM/disk changes, snapshots, terminate) returns a task ID immediately and runs in the background. Poll this endpoint until the task finishes. Returns an array with one object: id, status, server, description, added, executed, completed and log. status is complete when the task has finished and error when it failed (log explains why). Poll every few seconds; creating a server can take several minutes.
curl https://console.omc.cloud/service/queue/TASK_ID \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET"import requests, time
url = "https://console.omc.cloud/service/queue/TASK_ID"
headers = {'AuthClientId': 'YOUR_CLIENT_ID', 'AuthSecret': 'YOUR_SECRET'}
while True:
task = requests.get(url, headers=headers).json()[0]
if task['status'] in ('complete', 'error'):
break
time.sleep(2)
print(task['status'], task['log'])For partner (reseller) accounts. These endpoints manage the customer accounts under your own account. They live under https://console.omc.cloud/svc (not /service) and use the same AuthClientId / AuthSecret headers, with the API key of the parent account.
/svc/users/createUserCreates a new user under your reseller account and returns its client ID. Required: hostname (the console hostname), email, firstName, lastName (each up to 32 characters) and pricelistIndex (position of the price list to assign). Optional: parentEmail (the account to place the user under), cstId (your own customer reference), setPasswordByEmail (true to email a password instead of setting one), newPassword + verifyPassword when setting it yourself, and sendValidationEmail. Returns {"id": 1230768}. Error codes: 104 email already in use, 107 invalid email, 121 password too weak, 106 password confirmation mismatch, 100 / 101 invalid first / last name.
curl -X POST https://console.omc.cloud/svc/users/createUser \
-H "Content-Type: application/json" \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET" \
-d '{
"hostname": "console.omc.cloud",
"email": "customer@example.com",
"firstName": "Dana",
"lastName": "Levi",
"pricelistIndex": 0,
"parentEmail": "partner@example.com",
"setPasswordByEmail": true,
"sendValidationEmail": true
}'/svc/users/user/{userid}Permanently removes the user with the given client ID. This is irreversible. Returns HTTP 200 with an empty body.
curl -X DELETE https://console.omc.cloud/svc/users/user/USER_ID \
-H "Content-Type: application/json" \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET"/svc/userOperations/{userid}/suspendChanges the account state of a user. Send a JSON body with staffId: -1, departmentId: -1, accountState as an integer (0 active, 2 suspended – policy, 4 suspended – billing), subject and content as empty strings and services as an empty array. Returns {"cmdId": 761164688}, a transaction ID that appears in the transactions list. A matching PUT /svc/userOperations/{userid}/resume accepts the same body.
curl -X PUT https://console.omc.cloud/svc/userOperations/USER_ID/suspend \
-H "Content-Type: application/json" \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET" \
-d '{"staffId":-1,"departmentId":-1,"accountState":2,"subject":"","content":"","services":[]}'/svc/usageReport/csvUpload/{MM}_{YYYY}/UsersGenerates a CSV usage report for all accounts under yours for the given month (MM_YYYY in the path). Body: transaction (0 all, 1 hourly, 2 partial monthly, 3 full-month monthly, 4 annual) and zipFormat: true. Returns cmdId and link, a temporary download URL for a ZIP containing the CSV.
curl -X POST https://console.omc.cloud/svc/usageReport/csvUpload/09_2026/Users \
-H "Content-Type: application/json" \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET" \
-d '{"transaction":0,"zipFormat":true}'/svc/queueReturns the recent transactions of your account and its sub-accounts, newest first: id, serviceName (the user’s email), commandInfo (for example “Suspend User Account” or “Usage Report Upload”), dtCreate, dtExecute, dtComplete, exitCode (0 = success), progress (100 = finished) and warn.
curl https://console.omc.cloud/svc/queue \
-H "Content-Type: application/json" \
-H "AuthClientId: YOUR_CLIENT_ID" \
-H "AuthSecret: YOUR_SECRET"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 with GET /queue/{taskid} (see Task Queue above). All requests must be sent over HTTPS.
Generate your API credentials in the OMC Cloud dashboard and start automating in minutes.
Get API Credentials →Alăturați-vă celor zeci de mii de clienți care se bazează pe OMC în fiecare zi
Prin înregistrare sunteți de acord cu Termenii și condițiile
Primiți o ofertă personalizată în următoarea jumătate de oră
Prin înregistrare sunteți de acord cu Termenii și condițiile