Remove login security record from list

This function deletes a record or records from cPHulk's whitelist or blacklist.

SecurityBasicAuth
Request
query Parameters
required
Array of strings or strings or strings or strings or strings or strings (ip-address)

The record's IP address.

Note:

To delete multiple IP addresses, increment the parameter name. For example, ip-1, ip-2, ip-3.

Examples:
Multiple IP addresses.
ip=192.168.0.1&ip=192.168.0.2&ip=2001:db8::1&ip=2002:db8::1
Single IP address.
ip=192.168.0.1
list_name
required
string

The cPHulk list's name.

  • white
  • black
Enum: "white" "black"
Example: list_name=white
skip_enabled_check
integer
Default: 0

Whether to skip checking if cPHulk runs on the server.

  • 1 - Don’t check cPHulk’s status.
  • 0 - Check cPHulk’s status.

Note:

If cPHulk is disabled and you check its status, the function returns the following message: cPHulk is disabled on the server.

Enum: 0 1
Example: skip_enabled_check=1
Responses
200

HTTP Request was successful.

Response Schema: application/json
object
object
get/delete_cphulk_record
Request samples
whmapi1 --output=jsonpretty \
  delete_cphulk_record \
  list_name='white' \
  ip='192.168.0.1'
Response samples
application/json
{
  • "data": {
    • "ips_failed": {
      • "192.168.0.1": "This is why, alpha.",
      • "192.168.9.1": "This is why, beta."
      },
    • "ips_removed": [
      • "192.168.0.1"
      ],
    • "list_name": "white",
    • "requester_ip": "192.168.0.1",
    • "requester_ip_is_whitelisted": 1
    },
  • "metadata": {
    • "command": "delete_cphulk_record",
    • "reason": "OK",
    • "result": 1,
    • "version": 1
    }
}