Manage firewall rules for virtual machines (VMs)

Add, modify, or remove firewall rules for your VM. Specify traffic type, protocol, ports, and source addresses to control network traffic to and from your server.

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 POST /api/vm/{vmid}/firewall Manage firewall rules for 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

Query Parameters

pos string required · Example: 2

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string required · Example: ACCEPT

comment string · enum required · Example: manu

HTTP Web Traffic

HTTPS Secure Web

SSH Access

Web Traffic (HTTP/HTTPS)

manu

radu

robi

seba

dport string required · Example:

enable integer required · Example: 1

proto string required · Example: tcp

source string required · Example: 192.0.0.1

type string required · Example: in

Responses

200

data object required

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

Human-readable message.

data.pos string required · Example: 2

data.rule object required

data.rule.action string required · Example: ACCEPT

data.rule.comment string · enum required · Example: manu

HTTP Web Traffic

HTTPS Secure Web

Web Traffic (HTTP/HTTPS)

manu

radu

robi

seba

data.rule.dport string required · Example:

data.rule.enable integer required · Example: 1

data.rule.proto string required · Example: tcp

data.rule.source string required · Example: 192.0.0.1

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

500

code string required · Example: INTERNAL_ERROR

Machine-readable error code.

error string required · Example: Internal Server Error

HTTP status title (e.g. 'Bad Request').

message string required · Example: Failed to update firewall rule

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

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

ISO 8601 timestamp (UTC).

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

For AI assistants

cURL

curl -X PUT "https://cloud.hostup.se/api/vm/10000/firewall?pos=2" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "in",
    "action": "ACCEPT",
    "proto": "tcp",
    "dport": "",
    "source": "192.0.0.1",
    "comment": "manu",
    "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": "",
      "source": "192.0.0.1",
      "comment": "manu",
      "enable": 1
    },
    "pos": "2",
    "message": "Firewall rule updated successfully"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "pos": {
          "type": "string"
        },
        "rule": {
          "type": "object",
          "properties": {
            "action": {
              "type": "string"
            },
            "comment": {
              "type": "string",
              "enum": [
                "",
                "HTTP Web Traffic",
                "HTTPS Secure Web",
                "Web Traffic (HTTP/HTTPS)",
                "manu",
                "radu",
                "robi",
                "seba"
              ]
            },
            "dport": {
              "type": "string"
            },
            "enable": {
              "type": "integer"
            },
            "proto": {
              "type": "string"
            },
            "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": "",
  "source": "192.0.0.1",
  "comment": "manu",
  "enable": 1
}