API Documentation

Remove Firewall Rule

Remove a firewall rule from a VPS.

The ruleId is formatted as port-proto-action (e.g. 80-tcp-allow). For port ranges, use the full format (e.g. 8000:8100-tcp-allow).

Request

DELETE /api/v1/vps/{id}/firewall/{ruleId}

Required scope: vps:manage

Path Parameters

Parameter Type Description
id string The VPS ID
ruleId string Rule identifier in port-proto-action format

Query Parameters

Parameter Type Required Description
source string No Source IP of the rule (default: any)

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "port": "8080",
    "proto": "tcp",
    "action": "allow",
    "source": "any",
    "success": true
  }
}

Errors

Status Code Description
400 INVALID_RULE_ID Rule ID format is invalid
404 NOT_FOUND VPS not found or not accessible
502 FIREWALL_ERROR Firewall operation failed on the server

Example

curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall/8080-tcp-allow" \
  -H "Authorization: Bearer YOUR_API_KEY"

MCP

This action is also available via the manage_firewall MCP tool.