## Region/node blacklists (`guard-blacklists`)

Firewall blacklist files imported per region or main node (up to 1,000,000 entries each), delivered to nodes as separate files instead of the global snapshot.

Authentication: Admin only · Docs: https://www.gocdn888.com/en/docs/api/guard-blacklists

### GET `/api/v2/guard-blacklists`

List region/node firewall blacklists · Authentication: Admin only

```sh
curl "https://panel.example.com/api/v2/guard-blacklists" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### GET `/api/v2/guard-blacklists/{scope}/{scope_id}`

Download a region/node firewall blacklist · Authentication: Admin only

```sh
curl "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/guard-blacklists/{scope}/{scope_id}`

Import a region/node firewall blacklist · Authentication: Admin only

Query parameters:

| Field | Type | Required | Description |
|---|---|---|---|
| `allow_broad` | boolean |  | When true, accepts overly broad prefixes (IPv4 shorter than /8, IPv6 shorter than /16); omitted or false rejects them with 422 broad_prefix, and the panel resends with true after confirmation. |

```sh
curl -X PUT "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### DELETE `/api/v2/guard-blacklists/{scope}/{scope_id}`

Delete a region/node firewall blacklist · Authentication: Admin only

```sh
curl -X DELETE "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

Region/node blacklists object:

| Field | Type | Required | Description |
|---|---|---|---|
| `entries` | integer |  | Number of entries after deduplication. |
| `items` | GuardBlacklist[] |  | Items on this page |
| `limit` | integer |  | Maximum number of entries per list. |
| `name` | string |  | Region name or main node name (empty if the node is unnamed). |
| `scope` | string |  | Tier the list belongs to: region = region tier; node = node tier (replaces the region tier list entirely). Values: ["region","node"] |
| `scope_id` | integer |  | Region ID or main node ID. |
| `sha256` | string |  | sha256 of the normalized text (nodes fetch by it). |
| `size` | integer |  | Size of the normalized text in bytes. |
| `updated_at` | string |  | Import time. |
