Servury API Documentation

https://servury.com/docs
Admin
Complete REST API reference for managing VPS servers and proxies programmatically through Servury's...
Tokens:10,261
Snippets:125
Trust Score:6.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Account Info Example Response

Source: https://servury.com/docs?api=proxy

Example JSON response for the `?action=account` endpoint, showing balance, discount, and payment status.

```json
{ "success": true, "data": { "balance": 42.50, "discount_percent": 33.3, "payment_method": "account_balance", "has_saved_card": false } }
```

--------------------------------

### Create Datacenter Proxy Example Response

Source: https://servury.com/docs?api=proxy

Example response after ordering datacenter proxies, confirming creation, providing proxy details, and the amount charged.

```json
{ "success": true, "data": { "message": "1 datacenter proxy created.", "proxies": [{ "id": "abc12345", "ip": "185.123.45.67", "port_http": 8080, "port_socks5": 1080, "username": "user123", "password": "pass456", "expiration_date": 1714000000 }], "amount_charged": 2.50 } }
```

--------------------------------

### Proxy Stock Example Response

Source: https://servury.com/docs?api=proxy

Example JSON response for the `?action=stock` endpoint, detailing available IPv4 and IPv6 stock per country.

```json
{ "success": true, "data": { "stock": { "ipv4": {"us": 150, "ca": 80, "fr": 45, "uk": 60, "nl": 30}, "ipv6": {"us": 500, "ca": 200} } } }
```

--------------------------------

### Execute Power Actions

Source: https://servury.com/docs?api=legacy

Executes power actions (start, stop, or restart) on a specified server.

```APIDOC
## POST ?action=power&id={server_id}

### Description
Execute power actions on a server.

### Method
POST

### Endpoint
/api/legacy.php?action=power&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
#### Request Body
- **action** (string) - Required - start, stop, or restart
```

--------------------------------

### Get Account Info

Source: https://servury.com/docs?api=proxy

Retrieve reseller account details including balance, discount, and payment method.

```http
GET ?action=account
```

--------------------------------

### Get Specific Server Information

Source: https://servury.com/docs?api=legacy

Retrieves detailed information for a specific server, including its password.

```APIDOC
## GET ?action=server&id={server_id}

### Description
Get detailed information for a specific server including password.

### Method
GET

### Endpoint
/api/legacy.php?action=server&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID

### Response
#### Success Response (200)
- **server** (object) - Detailed server information.
  - **id** (string) - The server's 8-character ID.
  - **hostname** (string) - The server's hostname.
  - **ip_address** (string) - The server's IP address.
  - **os** (string) - The operating system installed on the server.
  - **plan** (string) - The server's plan.
  - **location** (string) - The server's location.
  - **status** (string) - The current status of the server.
  - **username** (string) - The default username for the server.
  - **password** (string) - The auto-generated password for the server.
  - **expiration_date** (integer) - The server's expiration date as a Unix timestamp.

### Response Example
{
  "success": true,
  "data": {
    "server": {
      "id": "abc12345",
      "hostname": "myserver",
      "ip_address": "31.57.201.10",
      "os": "debian12",
      "plan": "S-100",
      "location": "Netherlands",
      "status": "active",
      "username": "root",
      "password": "generated_password",
      "expiration_date": 1712592000
    }
  }
}
```

--------------------------------

### Get Account Info

Source: https://servury.com/docs?api=proxy

Retrieves information about the reseller account, including balance, discount percentage, and payment method.

```APIDOC
## GET ?action=account

### Description
Get reseller account info (balance, discount, payment method).

### Method
GET

### Endpoint
/api/proxy.php?action=account

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains account details.
  - **balance** (float) - The current account balance.
  - **discount_percent** (float) - The applicable discount percentage.
  - **payment_method** (string) - The current payment method.
  - **has_saved_card** (boolean) - Whether a card is saved for payment.

### Response Example
{
  "success": true,
  "data": {
    "balance": 42.50,
    "discount_percent": 33.3,
    "payment_method": "account_balance",
    "has_saved_card": false
  }
}
```

--------------------------------

### Get Server Console URL

Source: https://servury.com/docs?api=legacy

Retrieves the noVNC console URL for a specific server.

```APIDOC
## GET ?action=console&id={server_id}

### Description
Get noVNC console URL for a server.

### Method
GET

### Endpoint
/api/legacy.php?action=console&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
```

--------------------------------

### PHP API Request Example

Source: https://servury.com/docs?api=legacy

This PHP script demonstrates how to make API requests using cURL to interact with the Servury legacy API. It includes functions for checking account balance, creating a server, and power cycling a server.

```php
<?php
$apiKey = "your_api_key_here";
$baseUrl = "https://servury.com/api/legacy.php";

function apiRequest($endpoint, $apiKey, $method = 'GET', $data = null) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $endpoint);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-Reseller-Key: $apiKey",
        "Content-Type: application/json"
    ]);

    if ($method === 'POST') {
        curl_setopt($ch, CURLOPT_POST, true);
        if ($data) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
    }

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Check balance
$account = apiRequest("$baseUrl?action=account", $apiKey);
echo "Balance: $" . $account['data']['balance'];

// Create a server
$newServer = apiRequest("$baseUrl?action=create", $apiKey, 'POST', [
    'plan_id' => 5,
    'hostname' => 'myserver',
    'os' => 'debian12',
    'days' => 31
]);

// Power cycle a server
$result = apiRequest("$baseUrl?action=power&id=abc12345", $apiKey, 'POST', [
    'action' => 'restart'
]);
?>
```

--------------------------------

### Get Account Information

Source: https://servury.com/docs?api=legacy

Retrieves reseller account details, including balance, discount percentage, and payment method.

```APIDOC
## GET ?action=account

### Description
Get reseller account information including balance, discount, and payment method.

### Method
GET

### Endpoint
/api/legacy.php?action=account

### Response
#### Success Response (200)
- **balance** (number) - The current account balance.
- **discount_percent** (number) - The reseller discount percentage.
- **payment_method** (string) - The current payment method.
- **has_saved_card** (boolean) - Indicates if a card is saved for payments.

### Response Example
{
  "success": true,
  "data": {
    "balance": 42.50,
    "discount_percent": 33.3,
    "payment_method": "account_balance",
    "has_saved_card": false
  }
}
```

--------------------------------

### Error Response Examples

Source: https://servury.com/docs?api=proxy

Illustrates common error responses from the API. These responses indicate issues such as invalid credentials, non-existent proxies, or stock unavailability.

```json
{"success": false, "error": "Invalid or inactive API key."}
```

```json
{"success": false, "error": "Proxy not found."}
```

```json
{"success": false, "error": "Out of stock for US (IPv4)"}
```

--------------------------------

### Get Proxy Stock

Source: https://servury.com/docs?api=proxy

Check the available stock of datacenter proxies by country and IP type before ordering.

```http
GET ?action=stock
```

--------------------------------

### Get Proxy Price

Source: https://servury.com/docs?api=proxy

Calculates the price for ordering datacenter, residential, or rotating proxies based on specified parameters like duration, quantity, and bandwidth.

```APIDOC
## GET ?action=price

### Description
Calculate price for any proxy type before ordering. Returns your reseller price.

### Method
GET

### Endpoint
/api/proxy.php?action=price

### Parameters
#### Query Parameters
- **type** (string) - Required - Proxy type: `datacenter`, `residential`, or `rotating`.
- **days** (integer) - Optional - Duration in days. Datacenter: 3-365. Rotating: 7/14/30/60/90.
- **quantity** (integer) - Optional - Number of proxies (datacenter only, 1-100).
- **bandwidth** (integer) - Optional - Bandwidth in GB (residential only, 1-1000).
- **threads** (integer) - Optional - Thread count (rotating only, 100-5000).
```

--------------------------------

### Get Proxy List

Source: https://servury.com/docs?api=proxy

Retrieve a list of all owned proxies, including datacenter, residential, and rotating types, along with their credentials.

```http
GET ?action=proxies
```

--------------------------------

### Get Single Proxy Details

Source: https://servury.com/docs?api=proxy

Fetches detailed information for a specific proxy, identified by its ID. This includes credentials and any IP addresses that have been whitelisted for the proxy.

```APIDOC
## GET ?action=proxy&id=X

### Description
Get detailed info for a single proxy including credentials and whitelisted IPs.

### Method
GET

### Endpoint
/api/proxy.php?action=proxy

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID.
```

--------------------------------

### Get Single Proxy Details

Source: https://servury.com/docs?api=proxy

Fetch detailed information for a specific proxy using its 8-character ID, including credentials and whitelisted IPs.

```http
GET ?action=proxy&id=X
```

--------------------------------

### Get Proxy Stock

Source: https://servury.com/docs?api=proxy

Retrieves the available stock for datacenter proxies, broken down by country and IP type (IPv4/IPv6). This is useful for checking availability before ordering.

```APIDOC
## GET ?action=stock

### Description
Get datacenter proxy stock by country and IP type. Check this before ordering.

### Method
GET

### Endpoint
/api/proxy.php?action=stock

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains stock information.
  - **stock** (object) - Stock details by IP type.
    - **ipv4** (object) - Available IPv4 stock by country.
      - **us** (integer) - Available US IPv4 proxies.
      - **ca** (integer) - Available CA IPv4 proxies.
      - **fr** (integer) - Available FR IPv4 proxies.
      - **uk** (integer) - Available UK IPv4 proxies.
      - **nl** (integer) - Available NL IPv4 proxies.
    - **ipv6** (object) - Available IPv6 stock by country.
      - **us** (integer) - Available US IPv6 proxies.
      - **ca** (integer) - Available CA IPv6 proxies.

### Response Example
{
  "success": true,
  "data": {
    "stock": {
      "ipv4": {"us": 150, "ca": 80, "fr": 45, "uk": 60, "nl": 30},
      "ipv6": {"us": 500, "ca": 200}
    }
  }
}
```

--------------------------------

### API Error Responses

Source: https://servury.com/docs?api=legacy

All errors return JSON with 'success: false' and an error message. Examples include unauthorized access, not found, and bad request errors.

```json
{"success": false, "error": "Invalid or inactive API key."}
```

```json
{"success": false, "error": "Server not found."}
```

```json
{"success": false, "error": "Invalid hostname. Use 3-63 alphanumeric characters."}
```

--------------------------------

### PHP API Request Function

Source: https://servury.com/docs?api=proxy

A reusable function for making API requests to Servury. It handles GET and POST requests with JSON data and custom headers. Ensure your API key is kept secure.

```php
<?php
$apiKey = "your_api_key_here";
$baseUrl = "https://servury.com/api/proxy.php";

function apiRequest($endpoint, $apiKey, $method = 'GET', $data = null) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $endpoint);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-Reseller-Key: $apiKey",
        "Content-Type: application/json"
    ]);

    if ($method === 'POST') {
        curl_setopt($ch, CURLOPT_POST, true);
        if ($data) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
    }

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Check stock before ordering
$stock = apiRequest("$baseUrl?action=stock", $apiKey);

// Get price quote
$price = apiRequest("$baseUrl?action=price&type=datacenter&days=30&quantity=5", $apiKey);
echo "5 proxies for 30 days: $" . $price['data']['total'];

// Order 5 datacenter proxies
$order = apiRequest("$baseUrl?action=create_datacenter", $apiKey, 'POST', [
    'country' => 'US',
    'days' => 30,
    'quantity' => 5,
    'ip_type' => 'ipv4'
]);

// List all proxies with credentials
$proxies = apiRequest("$baseUrl?action=proxies", $apiKey);
foreach ($proxies['data']['proxies'] as $p) {
    echo "{$p['ip']}:{$p['port_http']} ({$p['type']})\n";
}

// Renew a datacenter proxy
$result = apiRequest("$baseUrl?action=renew&id=abc12345", $apiKey, 'POST', [
    'days' => 30
]);

// Top up residential bandwidth
$result = apiRequest("$baseUrl?action=topup&id=xyz98765", $apiKey, 'POST', [
    'bandwidth' => 10
]);

```

--------------------------------

### List Available Plans

Source: https://servury.com/docs?api=legacy

Retrieves a list of available VPS plans along with your specific reseller pricing.

```APIDOC
## GET ?action=plans

### Description
List available VPS plans with your reseller pricing.

### Method
GET

### Endpoint
/api/legacy.php?action=plans
```

--------------------------------

### List Available Operating Systems

Source: https://servury.com/docs?api=legacy

Retrieves a list of all available operating systems supported by the legacy infrastructure.

```APIDOC
## GET ?action=os

### Description
List available operating systems. Legacy infrastructure supports: Debian 12, Debian 13, Ubuntu 24, Rocky Linux 9, CentOS 10, and Windows Server 2025.

### Method
GET

### Endpoint
/api/legacy.php?action=os
```

--------------------------------

### Create New Server

Source: https://servury.com/docs?api=legacy

Provisions a new server on leased infrastructure. The password is auto-generated by the provider.

```APIDOC
## POST ?action=create

### Description
Provision a new server on leased infrastructure. Password is auto-generated by the provider.

### Method
POST

### Endpoint
/api/legacy.php?action=create

### Parameters
#### Request Body
- **plan_id** (integer) - Required - Plan ID from /plans endpoint
- **hostname** (string) - Required - 3-63 alphanumeric characters
- **os** (string) - Required - debian12, debian13, ubuntu24, rocky9, centos10, winserv25
- **days** (integer) - Optional - 1-365 (default: 31)
```

--------------------------------

### Create Datacenter Proxies

Source: https://servury.com/docs?api=proxy

Order new datacenter proxies. Specify country, duration, quantity, and IP type. Returns proxy credentials immediately upon successful order.

```http
POST ?action=create_datacenter
```

--------------------------------

### Reinstall Operating System

Source: https://servury.com/docs?api=legacy

Reinstalls the operating system on a server. This action will wipe all existing data.

```APIDOC
## POST ?action=reinstall&id={server_id}

### Description
Reinstall the operating system (wipes all data).

### Method
POST

### Endpoint
/api/legacy.php?action=reinstall&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
#### Request Body
- **os** (string) - Required - debian12, debian13, ubuntu24, rocky9, centos10, winserv25
```

--------------------------------

### List All Servers

Source: https://servury.com/docs?api=legacy

Retrieves a list of all servers associated with the reseller account.

```APIDOC
## GET ?action=servers

### Description
List all servers belonging to the reseller.

### Method
GET

### Endpoint
/api/legacy.php?action=servers
```

--------------------------------

### Create Datacenter Proxies

Source: https://servury.com/docs?api=proxy

Orders new datacenter proxies. You can specify the country, duration, quantity, and IP type. The response includes the proxy credentials and the amount charged.

```APIDOC
## POST ?action=create_datacenter

### Description
Order datacenter proxies. Returns proxy credentials immediately.

### Method
POST

### Endpoint
/api/proxy.php?action=create_datacenter

### Parameters
#### Request Body
- **country** (string) - Required - Country code: US, CA, FR, UK, or NL.
- **days** (integer) - Optional - Duration in days (3-365, default: 30).
- **quantity** (integer) - Optional - Number of proxies (1-100, default: 1).
- **ip_type** (string) - Optional - IP type: `ipv4` or `ipv6` (default: ipv4).

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains details of the created proxies.
  - **message** (string) - Confirmation message.
  - **proxies** (array) - List of created proxies with their details.
    - **id** (string) - The unique ID of the proxy.
    - **ip** (string) - The IP address of the proxy.
    - **port_http** (integer) - The HTTP port.
    - **port_socks5** (integer) - The SOCKS5 port.
    - **username** (string) - The proxy username.
    - **password** (string) - The proxy password.
    - **expiration_date** (integer) - Unix timestamp of expiration.
  - **amount_charged** (float) - The cost of the order.

### Response Example
{
  "success": true,
  "data": {
    "message": "1 datacenter proxy created.",
    "proxies": [
      {
        "id": "abc12345",
        "ip": "185.123.45.67",
        "port_http": 8080,
        "port_socks5": 1080,
        "username": "user123",
        "password": "pass456",
        "expiration_date": 1714000000
      }
    ],
    "amount_charged": 2.50
  }
}
```

--------------------------------

### Create Residential Proxy

Source: https://servury.com/docs?api=proxy

Order a residential proxy subscription. Requires specifying the amount of bandwidth in GB.

```http
POST ?action=create_residential
```

--------------------------------

### Upgrade Server Plan

Source: https://servury.com/docs?api=legacy

Upgrades a server to a higher-priced plan. A prorated charge will be applied for the remaining days of the current subscription.

```APIDOC
## POST ?action=upgrade&id={server_id}

### Description
Upgrade server to a higher plan. Prorated charge for remaining days.

### Method
POST

### Endpoint
/api/legacy.php?action=upgrade&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
#### Request Body
- **plan_id** (integer) - Required - Target plan ID (must be higher price than current)
```

--------------------------------

### Create Residential Proxy

Source: https://servury.com/docs?api=proxy

Orders a residential proxy subscription, which is billed based on bandwidth usage. Specify the amount of bandwidth required.

```APIDOC
## POST ?action=create_residential

### Description
Order a residential proxy subscription with bandwidth. Returns proxy credentials immediately.

### Method
POST

### Endpoint
/api/proxy.php?action=create_residential

### Parameters
#### Request Body
- **bandwidth** (integer) - Required - Bandwidth in GB (1-1000).
```

--------------------------------

### List Available Locations

Source: https://servury.com/docs?api=legacy

Retrieves a list of all available server locations.

```APIDOC
## GET ?action=locations

### Description
List available server locations.

### Method
GET

### Endpoint
/api/legacy.php?action=locations
```

--------------------------------

### List All Proxies

Source: https://servury.com/docs?api=proxy

Retrieves a list of all ordered proxies, including datacenter, residential, and rotating types, along with their associated credentials.

```APIDOC
## GET ?action=proxies

### Description
List all proxies (datacenter, residential, and rotating) with credentials.

### Method
GET

### Endpoint
/api/proxy.php?action=proxies
```

--------------------------------

### Authentication Header

Source: https://servury.com/docs?api=proxy

All API requests require authentication using the `X-Reseller-Key` header with your provided API key.

```http
X-Reseller-Key: your_api_key_here
```

--------------------------------

### Create Rotating Proxy

Source: https://servury.com/docs?api=proxy

Orders a rotating IPv6 proxy. You can specify the duration and thread count. The default country is Canada.

```APIDOC
## POST ?action=create_rotating

### Description
Order a rotating IPv6 proxy. Returns proxy credentials immediately.

### Method
POST

### Endpoint
/api/proxy.php?action=create_rotating

### Parameters
#### Request Body
- **country** (string) - Optional - Currently only CA (default).
- **days** (integer) - Optional - Duration in days: 7, 14, 30, 60, or 90 (default: 30).
- **threads** (integer) - Optional - Thread count (100-5000, default: 100).
- **protocol** (string) - Optional - Currently only ipv6 (default).
```

--------------------------------

### Terminate Server

Source: https://servury.com/docs?api=legacy

Permanently deletes a server. Please note that this action is irreversible and no refund will be issued.

```APIDOC
## POST ?action=terminate&id={server_id}

### Description
Permanently delete a server (no refund).

### Method
POST

### Endpoint
/api/legacy.php?action=terminate&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
```

--------------------------------

### Create Rotating Proxy

Source: https://servury.com/docs?api=proxy

Order a rotating IPv6 proxy. You can specify the country (currently only CA), duration, thread count, and protocol.

```http
POST ?action=create_rotating
```

--------------------------------

### Add IP to Proxy Whitelist

Source: https://servury.com/docs?api=proxy

Adds a specified IP address to the whitelist for datacenter and rotating proxy types. This ensures that only the whitelisted IP can access the proxy.

```APIDOC
## POST ?action=add_ip&id={proxy_id}

### Description
Add an IP to the proxy whitelist (datacenter and rotating only).

### Method
POST

### Endpoint
/api/proxy.php?action=add_ip

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID
- **ip** (string) - Required - IP address to whitelist

### Response
#### Success Response
Indicates successful addition of the IP to the whitelist.
```

--------------------------------

### Manage Proxy Credentials

Source: https://servury.com/docs?api=proxy

Reset the username and password for a specific proxy using its ID.

```http
POST reset_credentials&id=X
```

--------------------------------

### Top Up Residential Proxy Bandwidth

Source: https://servury.com/docs?api=proxy

Adds more bandwidth to an existing residential proxy subscription. Specify the proxy ID and the amount of bandwidth to add.

```APIDOC
## POST ?action=topup&id=X

### Description
Add bandwidth to a residential proxy.

### Method
POST

### Endpoint
/api/proxy.php?action=topup

### Parameters
#### Request Body
- **id** (string) - Required - 8-character proxy ID.
- **bandwidth** (integer) - Required - GB to add (1-1000).
```

--------------------------------

### Add IP to Proxy Whitelist

Source: https://servury.com/docs?api=proxy

Adds a specific IP address to the whitelist for a given proxy. Only whitelisted IPs will be able to use the proxy.

```APIDOC
## POST ?action=add_ip&id=X

### Description
Add an IP address to a proxy's whitelist.

### Method
POST

### Endpoint
/api/proxy.php?action=add_ip

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID.
#### Request Body
- **ip** (string) - Required - The IP address to whitelist.
```

--------------------------------

### Reset Proxy Credentials

Source: https://servury.com/docs?api=proxy

Resets the username and password for a given proxy. This action is applicable to all proxy types and returns the new credentials upon successful execution.

```APIDOC
## POST ?action=reset_credentials&id={proxy_id}

### Description
Reset proxy username/password. Works for all proxy types. Returns new credentials.

### Method
POST

### Endpoint
/api/proxy.php?action=reset_credentials

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID

### Response
#### Success Response
Returns new credentials.
```

--------------------------------

### Reset Proxy Credentials

Source: https://servury.com/docs?api=proxy

Resets the username and password for a proxy. This is useful if credentials have been compromised or lost.

```APIDOC
## POST reset_credentials&id=X

### Description
Reset credentials for a proxy.

### Method
POST

### Endpoint
/api/proxy.php?action=reset_credentials

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID.
```

--------------------------------

### Top Up Residential Proxy Bandwidth

Source: https://servury.com/docs?api=proxy

Add more bandwidth to an existing residential proxy subscription. Requires the proxy ID and the amount of bandwidth in GB to add.

```http
POST ?action=topup&id=X
```

--------------------------------

### Renew Server Subscription

Source: https://servury.com/docs?api=legacy

Renews or extends an existing server subscription for a specified number of days.

```APIDOC
## POST ?action=renew&id={server_id}

### Description
Renew/extend a server subscription.

### Method
POST

### Endpoint
/api/legacy.php?action=renew&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
#### Request Body
- **days** (integer) - Required - 1-365
```

--------------------------------

### Change Server IP Address

Source: https://servury.com/docs?api=legacy

Changes the IP address of a server. This is a paid operation.

```APIDOC
## POST ?action=ip&id={server_id}

### Description
Change the server's IP address. This is a paid operation.

### Method
POST

### Endpoint
/api/legacy.php?action=ip&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
```

--------------------------------

### Terminate Proxy

Source: https://servury.com/docs?api=proxy

Permanently deletes a proxy. This action is irreversible and does not provide a refund.

```APIDOC
## POST ?action=terminate&id={proxy_id}

### Description
Permanently delete a proxy (no refund).

### Method
POST

### Endpoint
/api/proxy.php?action=terminate

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID

### Response
#### Success Response
Indicates successful termination of the proxy.
```

--------------------------------

### Update Server Hostname

Source: https://servury.com/docs?api=legacy

Updates the hostname of a specified server.

```APIDOC
## POST ?action=hostname&id={server_id}

### Description
Update server hostname.

### Method
POST

### Endpoint
/api/legacy.php?action=hostname&id={server_id}

### Parameters
#### Path Parameters
- **id** (string) - Required - 8-character server ID
#### Request Body
- **hostname** (string) - Required - New hostname (alphanumeric and hyphens)
```

--------------------------------

### Terminate Proxy

Source: https://servury.com/docs?api=proxy

Permanently delete and stop billing for a proxy. This action is irreversible.

```http
POST ?action=terminate&id=X
```

--------------------------------

### Renew Proxy

Source: https://servury.com/docs?api=proxy

Extend the duration of a datacenter or rotating proxy. This action is not applicable to residential proxies, which use the `topup` action instead.

```http
POST ?action=renew&id=X
```

--------------------------------

### Renew Proxy

Source: https://servury.com/docs?api=proxy

Renews a datacenter or rotating proxy for an additional duration. This action is not applicable to residential proxies, which use the 'topup' action for bandwidth.

```APIDOC
## POST ?action=renew&id=X

### Description
Renew a datacenter or rotating proxy. Not applicable to residential (use topup instead).

### Method
POST

### Endpoint
/api/proxy.php?action=renew

### Parameters
#### Request Body
- **id** (string) - Required - 8-character proxy ID.
- **days** (integer) - Required - Duration in days. Datacenter: 3-365. Rotating: 7/14/30/60/90.
```

--------------------------------

### Successful JSON Response

Source: https://servury.com/docs?api=proxy

Successful API responses are returned in JSON format with a `success` flag set to true and data in the `data` field.

```json
{"success": true, "data": {...}}
```

--------------------------------

### Terminate Proxy

Source: https://servury.com/docs?api=proxy

Terminates an active proxy subscription, stopping further billing. This action is irreversible.

```APIDOC
## POST ?action=terminate&id=X

### Description
Terminate an active proxy subscription.

### Method
POST

### Endpoint
/api/proxy.php?action=terminate

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID.
```

--------------------------------

### Manage Proxy Whitelisted IPs

Source: https://servury.com/docs?api=proxy

Add or remove IP addresses from a proxy's whitelist. This controls which IPs can use the proxy.

```http
POST ?action=add_ip&id=X
```

```http
POST ?action=remove_ip&id=X
```

--------------------------------

### Remove IP from Proxy Whitelist

Source: https://servury.com/docs?api=proxy

Removes a specific IP address from the whitelist for a given proxy, revoking its access.

```APIDOC
## POST ?action=remove_ip&id=X

### Description
Remove an IP address from a proxy's whitelist.

### Method
POST

### Endpoint
/api/proxy.php?action=remove_ip

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID.
#### Request Body
- **ip** (string) - Required - The IP address to remove from the whitelist.
```

--------------------------------

### Remove IP from Proxy Whitelist

Source: https://servury.com/docs?api=proxy

Removes a specified IP address from the proxy whitelist. This action reverts the IP access restrictions previously set.

```APIDOC
## POST ?action=remove_ip&id={proxy_id}

### Description
Remove an IP from the proxy whitelist.

### Method
POST

### Endpoint
/api/proxy.php?action=remove_ip

### Parameters
#### Query Parameters
- **id** (string) - Required - 8-character proxy ID
- **ip** (string) - Required - IP address to remove

### Response
#### Success Response
Indicates successful removal of the IP from the whitelist.
```

--------------------------------

### Error JSON Response

Source: https://servury.com/docs?api=proxy

Error responses are returned in JSON format with a `success` flag set to false and an error message in the `error` field.

```json
{"success": false, "error": "message"}
```
Tokens:
Raw