View and manage firewall rules for a VPS

View and manage firewall rules for your Virtual Private Server (VPS/VM). You can see existing rules, add new ones, or remove unwanted rules to protect your server.

VPS Services Firewall

Context

Where to get IDs / values

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data array<object> required · Example: [{"action":"ACCEPT","pos":0,"digest":"e9b8ee1eaab39ae1b1b947455d3d975862bf2192","proto"...

A list of firewall rules. Empty if no rules exist or if the endpoint is used to modify rules without returning them.

data[].action string required · Example: ACCEPT
data[].comment string · enum · Example: radu
HTTP Web Traffic
HTTPS Secure Web
ICMP Ping
SSH Access
manu
radu
robi
seba
data[].digest string required · Example: e9b8ee1eaab39ae1b1b947455d3d975862bf2192
data[].dport string · Example: 80
data[].enable integer required · Example: 1
data[].ipversion integer · Example: 4
data[].pos integer required · Example: 0
data[].proto string · enum required · Example: tcp
icmp
tcp
data[].source string · enum · Example: 192.0.0.1
192.0.0.1/0
192.0.0.1
192.0.0.1
192.0.0.1/32
192.0.0.1
192.0.0.1
192.0.0.1
192.0.0.1
192.0.0.1
192.0.0.1/32
192.0.0.1/32
data[].type string required · Example: in
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/vm/{vmid}/firewall
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/firewall" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": [
    {
      "action": "ACCEPT",
      "pos": 0,
      "digest": "e9b8ee1eaab39ae1b1b947455d3d975862bf2192",
      "proto": "tcp",
      "type": "in",
      "source": "192.0.0.1",
      "ipversion": 4,
      "enable": 1,
      "comment": "radu"
    },
    {
      "digest": "e9b8ee1eaab39ae1b1b947455d3d975862bf2192",
      "action": "ACCEPT",
      "pos": 1,
      "comment": "robi",
      "enable": 1,
      "proto": "tcp",
      "type": "in",
      "ipversion": 4,
      "source": "192.0.0.1"
    },
    {
      "_truncated": "... and 2 more items"
    }
  ]
}