Remove an IP address from a VPS or domain

Remove a specific IP address (IPv4 or IPv6) from a VPS or a domain. It returns an ID needed to track the operation in subsequent calls. Use this when you want to release an IP address that is no longer needed for your service.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string · enum required

assign_ip

change_ip

create_private_interface

delete_interface

get_available_subnets

remove_ip

update_rdns

ipId any

ipType string

interfaceName string

isPrimary integer

subnetId string

ipAddress string

vlan integer

ip string

rdns string

Responses

200

success boolean

timestamp string

requestId string

data object

400

error string

message string

code string

timestamp string

requestId string

errorCode string

actualIP string

records array

409

error string

message string

code string

timestamp string

requestId string

500

error string

message string

code string

timestamp string

requestId string

POST https://cloud.hostup.se/api/vm/{vmid}/network

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/17691/network" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "assign_ip",
    "ipId": null,
    "ipType": "string",
    "interfaceName": "string",
    "isPrimary": 0,
    "subnetId": "string",
    "ipAddress": "string",
    "vlan": 0,
    "ip": "string",
    "rdns": "string"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "success": true,
    "message": "string",
    "restartJobId": "string",
    "requiresRestart": true,
    "ipAddress": "string",
    "interface": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "message": {
          "type": "string"
        },
        "restartJobId": {
          "type": "string"
        },
        "requiresRestart": {
          "type": "boolean"
        },
        "ipAddress": {
          "type": "string"
        },
        "interface": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "action": "assign_ip",
  "ipId": null,
  "ipType": "string",
  "interfaceName": "string",
  "isPrimary": 0,
  "subnetId": "string",
  "ipAddress": "string",
  "vlan": 0,
  "ip": "string",
  "rdns": "string"
}