Manage firewall rules for VMs

Add, modify, or remove firewall rules for your virtual servers (VMs). Control network traffic to and from your VM, such as opening specific ports for applications or blocking unwanted traffic.

VPS Services Firewall

Context

Where to get IDs / values

path.vmid

GET /api/vps-accounts

Related endpoints

GET /api/vm/{vmid}/firewall View and manage firewall rules for a VPS PUT /api/vm/{vmid}/firewall Manage firewall rules for virtual machines (VMs) DELETE /api/vm/{vmid}/firewall Delete a firewall rule for a specific virtual server

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string required · Example: ACCEPT

comment string · enum required · Example: HTTPS Secure Web

HTTPS Secure Web

dport string required · Example: 443

enable integer required · Example: 1

proto string · enum required · Example: tcp

icmp

tcp

udp

source string required · Example: 2001:db8::1/32

type string required · Example: in

Responses

200

data object required

data.message string required · Example: Firewall rule added successfully

Human-readable message.

data.rule object required

data.rule.action string required · Example: ACCEPT

data.rule.comment string · enum required · Example: HTTPS Secure Web

HTTPS Secure Web

data.rule.dport string required · Example: 443

data.rule.enable integer required · Example: 1

data.rule.proto string · enum required · Example: tcp

icmp

tcp

udp

data.rule.source string required · Example: 2001:db8::1/32

data.rule.type string required · Example: in

data.success boolean required · Example: true

True for successful responses.

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).

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

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/10000/firewall" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "in",
    "action": "ACCEPT",
    "proto": "tcp",
    "dport": "443",
    "source": "2001:db8::1/32",
    "comment": "HTTPS Secure Web",
    "enable": 1
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "rule": {
      "type": "in",
      "action": "ACCEPT",
      "proto": "tcp",
      "dport": "443",
      "source": "2001:db8::1/32",
      "comment": "HTTPS Secure Web",
      "enable": 1
    },
    "message": "Firewall rule added successfully"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "rule": {
          "type": "object",
          "properties": {
            "action": {
              "type": "string"
            },
            "comment": {
              "type": "string",
              "enum": [
                "",
                "HTTPS Secure Web"
              ]
            },
            "dport": {
              "type": "string"
            },
            "enable": {
              "type": "integer"
            },
            "proto": {
              "type": "string",
              "enum": [
                "icmp",
                "tcp",
                "udp"
              ]
            },
            "source": {
              "type": "string"
            },
            "type": {
              "type": "string"
            }
          }
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body in

{
  "type": "in",
  "action": "ACCEPT",
  "proto": "tcp",
  "dport": "443",
  "source": "2001:db8::1/32",
  "comment": "HTTPS Secure Web",
  "enable": 1
}