Sign in

v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
VPS: Firewall

Create firewall rule

Create new firewall rule for a specified firewall.

By default, the firewall drops all incoming traffic, which means you must add accept rules for all ports you want to use.

Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually.

Use this endpoint to add new security rules to firewalls.

post/api/vps/v1/firewall/{firewallId}/rules

Path parameters

firewallIdinteger required
Example:9449049

Firewall ID

Request body

protocol'TCP' | 'UDP' | 'ICMP' | 'GRE' | 'any' | 'ESP' | 'AH' | 'ICMPv6' | 'SSH' | 'HTTP' | 'HTTPS' | 'MySQL' | 'PostgreSQL' required
portstring required

Port or port range, ex: 1024:2048

source'any' | 'custom' required
source_detailstring required

IP range, CIDR, single IP or any

Example request

{
  "protocol": "TCP",
  "port": "443",
  "source": "any",
  "source_detail": "351.15.24.0/24"
}

Response

Success response

idinteger

Firewall rule ID

action'accept' | 'drop'

Firewall rule action

protocol'TCP' | 'UDP' | 'ICMP' | 'GRE' | 'any' | 'ESP' | 'AH' | 'ICMPv6' | 'SSH' | 'HTTP' | 'HTTPS' | 'MySQL' | 'PostgreSQL'

Firewall rule protocol

portstring

Firewall rule destination port: single or port range

sourcestring

Firewall rule source. Can be any or custom

source_detailstring

Firewall rule source detail. Can be any or IP address, CIDR or range

Example response

{
  "id": 24541,
  "action": "accept",
  "protocol": "TCP",
  "port": "1024:2048",
  "source": "any",
  "source_detail": "any"
}