DeluxHostAPI Reference
Firewall

Delete a protection rule

DELETE
/v1/firewall/rules/{ruleId}

ip is required. Rule ids are a global sequence upstream, so the rule is checked to exist for that address before anything is deleted; anything else is a 404.

Removing a rule does not take the address offline — it falls back to the network's default filtering. Recreating it is one POST away, which is why this is the one thing a token is allowed to delete.

Authorization

apiToken firewall:write
headerAuthorizationBearer <token>

A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.

Scope: firewall:write

Path Parameters

ruleId*integer

id from GET /v1/firewall/rules.

Query Parameters

ip*string

One of your protected addresses, from GET /v1/firewall/ips. Any other address is a 403.

Response Body

The panel accepted the removal.

application/json
  1. response
ok*boolean
curl -X DELETE 'https://api.deluxhost.net/v1/firewall/rules/0?ip=string' \  -H "Authorization: Bearer $DELUXHOST_TOKEN"
Example Response
{  "ok": true}