Remove From Blacklist API

Unblock IP addresses by removing them from the blacklist

Security

Remove From Blacklist API

Unblock IP addresses by removing them from the blacklist. Restore access for IPs that were incorrectly blocked or have resolved their issues.

Restore Access

Unblock previously blocked IPs.

Fix False Positives

Correct mistaken blocks.

Second Chance

Allow reformed sources back.


Endpoint Overview

MUTATION/graphql

Remove an IP address from the system blacklist, restoring its ability to access VPN services.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

ipString!Required

The IP address or CIDR range to remove from the blacklist.


GraphQL Mutation

mutation removeFromBlacklist($ip: String!) {
  removeFromBlacklist(ip: $ip)
}

Variables:

{
  "ip": "198.51.100.100"
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d '{
    "query": "mutation removeFromBlacklist($ip: String!) { removeFromBlacklist(ip: $ip) }",
    "variables": {
      "ip": "198.51.100.100"
    }
  }'

Response

200IP Unblocked Successfully
{
  "data": {
    "removeFromBlacklist": true
  }
}
400IP Not in Blacklist
{
  "errors": [
    {
      "message": "IP not found in blacklist",
      "path": ["removeFromBlacklist"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}

Reasons to Unblock

False Positive

IP was mistakenly identified as malicious.

Issue Resolved

Security issue has been addressed.

User Appeal

Legitimate user requested unblock.

IP Reassigned

IP now belongs to different entity.


Best Practices

Verify Request

Confirm the unblock request is legitimate.

Document

Record why the IP was unblocked.

Monitor After

Watch for recurring issues after unblock.

Consider Whitelist

Whitelist if confirmed legitimate.



Immediate Effect

Unblocking takes effect immediately. The IP can access services on the next request.

Review Blacklist

Check your current blacklist to identify IPs that may need to be unblocked.

Get Blacklisted IPs