Application Programming Interface

Change Server Password


This function enables you to change a server root password. The server should be turned off before you change its root password. Please kindly note that this function will work for server with OS template installation. This function may not work if you install your server with custom ISO, ecspecially non linux OS.

  • Sandbox URL:
  • Real API URL:
Request Parameters:
Parameter Required Type Max Length Description
server_id Yes String 50 characters The ID of server you want to change its password.
password Yes String 15 characters It should not contain single quote, double quote, dollar sign, and space characters.
JSON Response:
    "code"    : "OK",
    "message" : "The server root password has been changed.",
    "data"    : {
        "server_id" : "12345",
        "password"  : "MySecretWords"
XML Response:
<?xml version="1.0" encoding="utf-8"?>
<message>The server root password has been changed.</message>
PHP Example:
$url      = "";
//$url    = "";
$user_id  = "12312";
$API_key  = "hasdh6ghvhgFDa454565jasdbNBS";
$random   = rand(10000,99999).uniqid().rand(100000,999999);
$checksum = sha1(sha1(sha1($user_id.$API_key.$random)));
$data = array(
    "user_id"   => $user_id,
    "random"    => $random,
    "format"    => "json",
    "checksum"  => $checksum,
    "server_id" => "12345",
    "password"  => "MySecretWords"
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$output = curl_exec($ch);
$curl_error = curl_errno($ch);
if ($curl_error){
    echo "Unable to connect to API Server.";
} else {
    $outputArray = json_decode($output,true);
    if (!$outputArray){
        echo "Invalid JSON Format";
    } else {
        if ($outputArray["code"] == "OK"){
            // Do what you want to do here if OK
        } else {
            echo "Error Message: ".$outputArray["message"];
            // Do what you want to do here if not OK